在ubuntu上简单配置redmine

这是一份完整详细的配置文档(08/03/2009 created by iifksp),关于如何在ubuntu上配置运行项目管理工具redmine。

发布本文时redmine最新稳定版本已升至0.9.2,rails的版本也已升至2.3.5,并发布了3.0 beta,配置过程可能不同。

redmine官方网站:http://www.redmine.org
redmine下载:http://rubyforge.org/frs/?group_id=1850
ubuntu官方网站:http://www.ubuntu.com

此次配置使用 ubuntu-9.04-server-i386 / redmine-0.8.4

1. 配置运行环境

安装ruby解释器:

apt-get install ruby rubygems

安装sqlite3数据库:(或者安装mysql数据库,可参看在ubuntu上配置LAMP)

apt-get install sqlite sqlite3 libsqlite3-ruby

2. 配置redmine

获取redmine:

wget http://rubyforge.org/frs/download.php/56909/redmine-0.8.4.tar.gz

移动到工作目录:

mv redmine-0.8.4.tar.gz /usr/local/

解压文件:

tar zxvf redmine-0.8.4.tar.gz

进入目录,复制数据库配置范例:

cp config/database.yml.example config/database.yml

修改数据库配置文件:

vim config/database.yml

将production部分配置成如下所示:

production:
adapter: sqlite3
dbfile: /usr/local/redmine-0.8.4/db/redmine.db

到db目录下建立数据库文件:

sqlite3 redmine.db
chmod a+x redmine.db

如果是mysql数据库的配置则类似于如下:

production:
  adapter: mysql
  database: redmine
  host: localhost
  username: root
  password: root
  encoding: utf8

安装rake和libopenssl-ruby

apt-get install rake libopenssl-ruby

rake迁移数据库:

rake db:migrate RAILS_ENV="production"

读取默认值:

rake redmine:load_default_data RAILS_ENV=`production`

选择中文zh。完成后,数据库和相关表被自动创建,redmine被设置为默认状态。

邮件的配置:

cd /usr/local/redmine-0.8.4/config
cp email.yml.example email.yml
vim email.yml

按需修改,例如下:

production:
  delivery_method: :smtp
  smtp_settings:
    address: mail.swordair.com
    port: 25
    domain: swordair.com
    authentication: :login
    user_name: redmine
    password: redmine

更多有关redmine邮件的配置参看:http://www.redmine.org/wiki/redmine/Email_Configuration

3. 启动redmine

在redmine主目录运行:

ruby script/server -e production

如果使用的是mysql数据库,可能会报错:/tmp/mysql.sock找不到。因为在/tmp确实没有mysql.sock文件,此文件位于 /var/run/mysqld/mysqld.sock,所以做一个软链接即可:

ln -s /var/run/mysqld/mysqld.sock /tmp/mysql.sock

redmine默认使用3000端口,浏览器访问http://localhost:3000
用户名admin,密码admin。

4. 备份redmine

只需备份redmine的主目录即可。如果数据库是MySQL,还需备份库。

5. 补丁和其他

邮件发送的504错误

Redmine Email测试时出现504 5.7.4 Unrecognized authentication type,也是由于使用redmine发送邮件时目标服务器不需要任何的验证。为使redmine邮件工作正常,需要删除有关验证的配置信息。找到config/email.yml文件将其内容由

production:
  delivery_method: :smtp
  smtp_settings:
    address: mail.swordair.com
    port: 25
    domain: swordair.com
    authentication: :login      #delete this line
    user_name: redmine       #delete this line
    password: redmine        #delete this line

改为

production:
  delivery_method: :smtp
  smtp_settings:
    address: mail.swordair.com
    port: 25
    domain: swordair.com

发送邮件标题乱码问题

问题表现为主题<32字符时显示正确,超过显示乱码。
需要为redmine打补丁,补丁位置:http://www.redmine.org/attachments/2290/mailer-subject-base64.patch

实测打完补丁后,主题字符数上限大大提高,基本解决乱码问题。
更多情况参看:http://www.redmine.org/issues/3592 以及 http://www.redmine.org/issues/3601