基于Ubuntu+Apache+Passenger+MySQL的Redmine安装笔记

基于Ubuntu+Apache+Passenger+MySQL的Redmine安装笔记
作者：雨水，日期：2015-11-09
概述
Redmine是一个用Ruby语言开发的开源的基于Web的项目管理工具。它提供了丰富的项目管理功能，包括需求跟踪，bug跟踪，WiKi等等，并且能够与版本控制工具集成，同时提供LDAP接口与OA集成等。
关于Redmine的部署方式有很多种，可谓条条大路通罗马。这里记录了基于Ubuntu14+Apache+Passenger+MySQL的安装过程。本文的Ubuntu操作系统的版本为Ubuntu 14.04.3 LTS。

安装前置条件
因为操作系统内置的一些配置可能过时了，因此在安装Redmine之前需要先讲系统更新到最新状态。
$ sudo apt-get update

$ sudo apt-get upgrade

步骤一：安装Apache, Passenger和MySQL
$ sudo apt-get install apache2 libapache2-mod-passenger
$ sudo apt-get install mysql-server
这一步会设置MySQL的root密码，假设为：123456，这个密码后续的安装步骤中会用到。
验证：这一步Apache安装成功之后，可以在浏览器中输入http://IP. IP为你的安装主机IP，如：  http://192.168.237.130/，这个时候应该会出现Apache Ubuntu的默认主页。

步骤二：安装redmine
$ sudo apt-get install redmine redmine-mysql
这一步有交互输入：
(1) 是否用dbconfig-common来配置数据库：直接回车选择默认的YES即可。
(2) 选择redMine database类型：直接回车选择默认的mysql即可。
(3) 需要输入MySQL的root密码：123456
(4) 设置redmine数据库的访问密码，假设也为：123456，并再次输入密码进行确认。

步骤三：安装gem及bundler
$ sudo gem update
$ sudo gem install bundler
如果这一步报错，请重试一次即可。

步骤四：配置Apache及Passenger
$ sudo vi /etc/apache2/mods-available/passenger.conf
在<IfModule mod_passenger.c>和</IfModule>之间添加PassengerDefaultUser www-data，然后保存。

$ sudo ln -s /usr/share/redmine/public /var/www/html/redmine

$ sudo vi /etc/apache2/sites-available/000-default.conf
在<VirtualHost *:80>和</VirtualHost>之间加入如下Directory元素，然后保存。
<Directory /var/www/html/redmine>

    RailsBaseURI /redmine

    PassengerResolveSymlinksInDocumentRoot on
</Directory>
备注：如果最后访问redmine需要在根域名下访问，就是后面不带/redmine路径，那么可以将000-default.conf中的DocumentRoot的值由/var/www/html改为/var/www/html/redmine。

步骤五：设置相关权限
$ sudo touch /usr/share/redmine/Gemfile.lock
$ sudo chown www-data:www-data /usr/share/redmine/Gemfile.lock

步骤六：重新加载配置启动运行
$ sudo service apache2 reload
重启apache，以便让修改的配置生效。然后进入http://127.0.0.1/redmine  或者类似http://192.168.237.130/redmine，可进入如下界面：



点击右上角的"登录"，默认的管理员用户和密码为：admin/admin。
登录进去之后，选择上方的"管理"->然后选择下面列表中的“信息”，即可看到Redmine相关版本及环境信息如下：



备注：如果想修改Redmine的监听IP地址和端口号，可以修改/etc/apache2/sites-available/000-default.conf中的<VirtualHost *:80>。例如改为类似：
<VirtualHost 10.0.2.15:8080>

步骤七：安装RMagick
第六步中我们看到RMagick这一项显示不可用，而RMagick是ImageMagick图形处理库的Rudy接口，Redmine的甘特图导出等功能会用到它。因此，这里需要安装RMagick。
$ sudo apt-get install ruby-rmagick
重新加载Apache使其生效！
$ sudo service apache2 reload
再次查看可以看到"RMagick 可用（可选的）"后面的感叹号已经变成勾了。

步骤八：邮件安装与配置
在使用Redmine的时候，与邮件系统集成是必不可少的。比如创建了新的账号，重置密码，创建了新的bug等都需要用到邮件通知功能。
(1) 安装postfix邮件服务
$ sudo apt-get install postfix
安装过程中需要配置，选择默认的"Internet Site"即可，然后System mail name输入你的公司域名，比如xxx.com。

(2) 配置Redmine的邮件
Redmine提供了配置的例子，直接拷贝到/etc/redmine/default/目录下，然后在此基础上修改即可。
$ sudo cp /usr/share/redmine/config/configuration.yml.example /etc/redmine/default/configuration.yml
将/etc/redmine/default/configuration.yml的production:标签下面添加配置如下：
production:

  email_delivery:
    delivery_method: :sendmail
然后保存文件。

(3) 重启Apache服务
$ sudo service apache2 reload

(4) 验证邮件服务
使用admin/admin登录系统只会，选择顶部的"管理"->"配置"->"邮件通知"，将邮件发件人地址改为：no.reply@xxx.com。xxx.com为你公司的域名。
通过"管理"->"用户"，选择下面的默认账户admin，进入之后将默认的邮件地址改为redmine管理员的真实邮箱地址。然后再回到邮件通知页，在下方可以发送测试邮件。另外，你创建用户的时候也会自动发送账户信息邮件，包括用户名，密码，地址等。

参考资料：
1. http://www.redmine.org/projects/redmine/wiki/HowTo_Install_Redmine_on_Ubuntu_step_by_step