redmine安装和配置

Redmine 的官方网站是：http://www.redmine.org，得到与当前Redmine 版本相符合的其他软件版本1. RubyRuby 的官方网站是http://ruby-lang.o

Redmine 的官方网站是：http://www.redmine.org，

得到与当前Redmine 版本相符合的其他软件版本

1. Ruby

Ruby 的官方网站是http://ruby-lang.org/，我们使用1.8.7版。

安装Ruby

tar zxvf ruby-1.8.7-p330.tar.gz

./configure --prefix=/usr/local/ruby

make && make install 将ruby 安装到/usr/local/ruby目录中。

编辑/etc/profile 增加ruby 环境变量pathmunge /usr/local/ruby/bin

source /etc/profile

2. RubyGems

RubyGems 的官方网站是http://www.rubygems.org/，是个包管理工具，相当于RPM 、yum 等工具。 兼容性考虑建议下载1.3.5版本

wget http://production.cf.rubygems.org/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.rb

make && make install

4. Rake

Rake 的官方网站是http://rake.rubyforge.org/，可以让gem 联网下载安装，也可以在官方网站下载后进行安装。

gem install rack -v=1.1.1

5. i18n

gem install i18n -v=0.4.2

生成会话存储密钥时需要

6. Ruby on Rails

Ruby on Rails 的官方网站是http://rubyonrails.org/，同样可以使用gem 联网下载安装，也可以下载后再本地安装。

gem install rails -v=2.3.11 --include-dependencies

7. 下载并解开Redmine

Redmine 的官方网址是http://www.redmine.org

使用如下命令可下载源代码：

cd /usr/local

svn co http://redmine.rubyforge.org/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.2

gem install rake -v=0.8.7

11. 创建数据库结构

运行命令：rake db:migrate RAILS_ENV=production

可能遇到的错误：

●

● undefined method `name' for "actionmailer":String 解决方法：降低rubygem 版本 no such file to load – openssl

解决方法：yum –y install openssl openssl-devel 进入ruby 源码目录

cd ext/openssl

ruby ./extconf.rb

make && make install

● Object is not missing constant Issue!

安装ruby-mysql

wget http://tmtm.org/en/ruby/mysql/ruby-mysql-0.2.6.tar.gz

tar zxvf ruby-mysql-0.2.6.tar.gz

cd ruby-mysql-0.2.6.tar.gz

ruby ./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_user'@'some_host' = OLD_PASSWORD('newpwd');

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.rb

12. 载入默认配置

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 -d

14. 使用mongrel

redmine 自带的web 是webrick, 访问很慢，无法忍受，

看网上说webrick 去解析域名，解析不到，绕一圈再回到IP 。这不是浪费时间嘛。

解决方法是用mongrel 这个web 。

gem install mongrel

启动方式

ruby /usr/local/redmine/script/server mongrel -e production –d

15. 使用mysql2

如果不安装mysql2可能会出现稳定性问题

gem install mysql2 -v=0.2.7

vi database.yml

production:

adapter: mysql2

16. 使用apache

yum –y install httpd curl-devel httpd-devel apr-devel apr-util-devel

下载 passenger-3.0.9.gem

gem install passenger-3.0.9.gem –local

passenger-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.so PassengerRoot /usr/local/ruby/lib/ruby/gems/1.8/gems/passenger-3.0.9

PassengerRuby /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.cgi cd /usr/local/redmine/public

cp dispatch.cgi.example dispatch.cgi

修改dispatch.cgi #!/usr/local/ruby/bin/ruby

require "/usr/local/ruby/lib/ruby/gems/1.8/gems/rails-2.3.11/lib/dispatcher.rb"

设置权限

chmod 755 dispatch.cgi

修改environment.rb

cd /usr/local/redmine/config

vi environment.rb

ENV['RAILS_ENV'] ||= 'production'去掉注释

设置apache 权限

cd /usr/local/redmine

chown -R apache:apache files log tmp vendor

启动apache

/etc/init.d/httpd start

17. 上传文件error

需要修改files 文件权限

chmod 777 /usr/local/redmine/files

18. 使用gmail 发送邮件

cd /usr/local/redmine/config

cp configuration.yml.example configuration.yml

vi configuration.yml

production:

delivery_method: :smtp

smtp_settings:

tls: true

enable_starttls_auto: true

address: "smtp.gmail.com"

port: '587'

domain: "smtp.gmail.com"

authentication: :plain

user_name: "your_email@gmail.com"

password: "your_password"

重启服务

rake db:migrate RAILS_ENV=production

/etc/init.d/httpd restart

19 使用ldap 认证

Name = My Directory

Host = host.domain.org

Port = 389

LDAPS = no

Account = MyDomainUserName (or UserName@MyDomain depending on AD server) Password =

可以用ldap browser查看CN 和OU

Base DN = CN=users,DC=host,DC=domain,DC=org

On-the-fly user creation = yes

Attributes

Login = sAMAccountName

Firstname = givenName

Lastname = sN

Email = mail