redmine安装和配置.docx

Redmine的官方网站是：，得到与当前Redmine版本相符合的其他软件版本Redmine versionSupported Ruby versionsRequired Rails versionRequired Rack versioncurrent trunkruby 1.8.6, 1.8.7Rails 2.3.11Rack 1.1.11. RubyRuby的官方网站是/，我们使用1.8.7版。安装Rubytar zxvf ruby-1.8.7-p330.tar.gz./configure -prefix=/usr/local/rubymake & make install 将ruby安装到/usr/local/ruby目录中。编辑/etc/profile 增加ruby环境变量pathmunge /usr/local/ruby/binsource /etc/profile2. RubyGemsRubyGems的官方网站是/，是个包管理工具，相当于RPM、yum等工具。兼容性考虑建议下载1.3.5版本wget /rubygems/rubygems-1.3.5.tgz tar zxvf rubygems-1.3.5.tgz再进入rubygems-1.3.5目录，运行：ruby setup.rb即可完成安装（默认安装到ruby所在目录下）。3. Zlib库安装Gem需要zlib支持yum -y install zlib zlib-devel cd /usr/local/src/ruby-1.8.7-p330/ext/zlib ruby extconf.rbmake & make install4. RakeRake的官方网站是/，可以让gem联网下载安装，也可以在官方网站下载后进行安装。gem install rack -v=1.1.1 5. i18ngem install i18n -v=0.4.2 生成会话存储密钥时需要6. Ruby on RailsRuby on Rails的官方网站是/，同样可以使用gem联网下载安装，也可以下载后再本地安装。gem install rails -v=2.3.11 -include-dependencies 7. 下载并解开RedmineRedmine的官方网址是使用如下命令可下载源代码：cd /usr/local svn co /svn/trunk redmine 8. 创建数据库mysql -uroot -p创建redmine数据库：create database redmine character set utf8;为redmine创建数据库用户（这里的用户名密码都是redmine)：grant all privileges on redmine.* to redmine% identified by redmine with grant option; 9. 设置redmine的数据库参数我们使用redmine提供的例子为蓝本，进入redmine所在目录：cp config/database.yml.example config/database.yml编辑文件config/database.yml，找到production段落，设置用户名和密码为，并保存文件。此处应注意设置项和前面的冒号（:）之间要有个空格，否则会出错。10. 生成会话存储密钥：rake generate_session_store注：r3055之前的版本使用下面的命令替代。RAILS_ENV=production rake config/initializers/session_store.rb如果出现以下异常：rake/rdoctask is deprecated.Use rdoc/task instead (in RDoc 2.4.2+)这是因为rake版本太高造成的。解决办法：先执行gem list rake 查看rake版本。若果高于0.8.7那就是太高了（比方说0.9.2）。这样的话就需要卸载0.9.2的，安装0.8.7的。gem uninstall rake -v=0.9.2gem install rake -v=0.8.711. 创建数据库结构运行命令：rake db:migrate RAILS_ENV=production可能遇到的错误：l undefined method name for actionmailer:String解决方法：降低rubygem版本l no such file to load openssl解决方法：yum y install openssl openssl-devel进入ruby源码目录cd ext/opensslruby ./extconf.rbmake & make installl Object is not missing constant Issue!安装ruby-mysqlwget /en/ruby/mysql/ruby-mysql-0.2.6.tar.gz tar zxvf ruby-mysql-0.2.6.tar.gzcd ruby-mysql-0.2.6.tar.gzruby ./setup.rb ruby ./test.rb localhost redmine redmine ruby ./install.rb test.rb可能遇到这种情况：Client does not support authentication protocol requested by server; consider upgrading MySQL client解决方法：mysql SET PASSWORD FOR some_usersome_host = OLD_PASSWORD(newpwd);l undefined method more_results for #解决方法：注释mysql_adapter.rb中的318和642/usr/local/ruby/lib/ruby/gems/1.8/gems/activerecord-2.3.11/lib/active_record/connection_adapters/mysql_adapter.rb12. 载入默认配置rake redmine:load_default_data RAILS_ENV=production读取默认配置数据，当遇到选择语言(Select language)时，选择zh.至此，redmine简单的配置就完成了。使用其自带的webrick来运行redmine，来检查下redmine的配置13. 运行并测试redmine运行命令：ruby script/server webrick -e production即可启动redmine，默认打开3000端口，可以通过http:/localhost:3000/访问（管理员初始用户名和密码都是admin）。如果希望Redmine作为服务运行，加上-d参数即可：ruby script/server webrick -e production -d14. 使用mongrelredmine 自带的web是webrick, 访问很慢，无法忍受，看网上说webrick 去解析域名，解析不到，绕一圈再回到IP。这不是浪费时间嘛。解决方法是用mongrel 这个web 。gem install mongrel启动方式ruby /usr/local/redmine/script/server mongrel -e production d15. 使用mysql2如果不安装mysql2可能会出现稳定性问题gem install mysql2 -v=0.2.7 vi database.ymlproduction:adapter: mysql216. 使用apacheyum y install httpd curl-devel httpd-devel apr-devel apr-util-devel下载 passenger-3.0.9.gemgem install passenger-3.0.9.gem localpassenger-install-apache2-module根据生成的信息修改httpd.conf 文件加入以下模块LoadModule assenger_module /usr/local/ruby/lib/ruby/gems/1.8/gems/passenger-3.0.9/ext/apache2/mod_passenger.soPassengerRoot /usr/local/ruby/lib/ruby/gems/1.8/gems/passenger-3.0.9PassengerRuby /usr/local/ruby/bin/ruby去掉NameVirtualHost *:80前面的注释在配置最后加入 ServerName localhost DocumentRoot /usr/local/redmine/public ErrorLog logs/redmine_error_log Options Indexes ExecCGI FollowSymLinks Allow from all AllowOverride all 生成dispatch.cgicd /usr/local/redmine/publiccp dispatch.cgi.example dispatch.cgi修改dispatch.cgi#!/usr/local/ruby/bin/rubyrequire /usr/local/ruby/lib/ruby/gems/1.8/gems/rails-2.3.11/lib/dispatcher.rb设置权限chmod 755 dispatch.cgi修改environment.rbcd /usr/local/redmine/configvi environment.rbENVRAILS_ENV |= production去掉注释设置apache权限cd /usr/local/redminechown -R apache:apache files log tmp vendor启动apache/etc/init.d/httpd start17. 上传文件error需要修改files文件权限chmod 777 /usr/local/redmine/files18. 使用gmail发送邮件cd /usr/local/redmine/configcp configuration.yml.example configuration.yml vi configuration.ymlproduction: delivery_method: :smtp smtp_settings: tls: true enable_starttls_auto: true address: port: 587 domain: authentication: :plain user_name: your_ password: your_password 重启服务rake db:migrate RAILS_ENV=production/etc/init.d/httpd restart 19 使用ldap认证Name = My DirectoryHost = Port = 389LDAPS