研究redmine, 就必须先在本地装好redmine。 如果mysql, apache, redmine分别配置安装， 步骤比较麻烦，容易出错， 因此我们使用bitnami提供的一键安装包。官网下载链接： https://bitnami.com/stack/redmine

用作插件开发的redmine版本最好与实际使用的版本一致，否则将在本地调试无误的插件部署到正式服务器上后，会引发页面奔溃等种种错误，令你猝不及防， 无法调试。

1 安装

注： 操作系统为Ubuntu

1. 将安装包下载到本地。 双击启动。

2. 大部分步骤都只需点击“下一步”， 设置为默认选项即可。 下边简单说明需要设置的步骤。

• 设置安装时的提示语言。

• 除了redmine的核心功能外， 选择是否安装PhpMyAdmin： 数据库管理软件。

• 选择安装路径。
• 设置管理员用户名

这一步很关键， 用来设置管理员账户的详细信息。 系统安装好后， 管理员是系统的第一个用户， 并且拥有管理员权限。 因此， 在这一环节中设置的用户名和登陆密码必须记牢。

3. 安装完毕后，访问链接http://localhost/redmine,通过先前记录的管理员账户便可以登陆系统。

2 配置

系统安装好后， 部分功能需要配置才会正常工作。

1.2.1 配置邮件

1. 进入目录： {安装路径}/apps/redmine/htdocs/config, 在配置文件configuration.yml中添加如下内容。

production:
email_delivery:
delivery_method: :async_smtp
async_smtp_settings:
enable_starttls_auto: true
openssl_verify_mode: ‘none’
address: xxxx
port: 25
domain: xxxx
authentication: :login
user_name: xxxx
password: xxxx
address是stmp服务器的地址， domain是邮件域， user_name和password是发件人邮件账号的登陆信息，用来验证服务。

2. 改好配置文件后，重启apache服务。

3.进入管理员的设置页面。设置“邮件发件人地址”为配置文件中邮件账户对应的邮箱地址。同时勾选系统应该在何种情况下发送邮件。

 1.2.2 配置访问链接

新安装好的系统访问链接为http://localhost/redmine, 我们将链接调整为http://localhost的配置方法如下：

• 编辑配置文件  {安装目录}/apps/redmine/conf/httpd-prefix.conf

#Alias /redmine/ xxxx   #注释掉
#Alias /redmine xxxx  #注释掉
DocumentRoot “{安装目录}/apps/redmine/htdocs/public” #添加

• 编辑配置文件 {安装目录}/apps/redmine/conf/httpd-app.conf

#SetEnv RAILS_RELATIVE_URL_ROOT "/redmine" #注释掉
PassengerPreStart http://127.0.0.1:8081/redmine 修改为： PassengerPreStart http://127.0.0.1:8081

修改配置后重启服务器， 即可用http://localhost访问系统