在Ubuntu上简单配置Redmine

注意：由于版本的更替，我已经写了新的Redmine+Apache+SVN+Postfix完整配置指南。所以此文档已停止更新并已被废弃。你也可以点击查看我写的全部关于redmine的文章。

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 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: mail1.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的主目录即可。

5.补丁和其他

邮件发送的504错误

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

production:
  delivery_method: :smtp
  smtp_settings:
    address: mail1.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: mail1.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