一．简介：

Redmine是一个开源的基于web的项目管理和缺陷跟踪工具，它用日志和甘特图辅助项目进度可视化显示，同时又支持多个项目管理，Redmine是一个自由开放的源码解决方案，它提供集成的项目管理功能，问题跟踪，并为多个版本控制选项的支持，虽说像IBM Ratioanl Team Concert的商业调查工具已经很强大了，但想坚持一个自由和开放源码的解决方案，可能会发现Redmine是一个有用的Scrum和敏捷的选择，由于Redmine的设计受到Rrac的较大影响，所以他们有很多相似特征，Redmine建立在Ruby on Rails的框架智商，它们可以跨平台和数据库。

在安装之前首先要确定操作系统安装好GCC编译器，可以使用gcc –v 查看。如果返回GCC的版本号，则安装正常。

二.安装配置

# yum -y install libyaml-devel zlib-devel curl-devel openssl-devel httpd-devel apr-devel apr-util-devel gcc ruby-devel gcc-c++ make postgresql-devel ImageMagick-devel sqlite-devel perl-LDAP mod_perl perl-Digest-SHA 安装相应的依赖包

一些Linux发行版都自带了ruby解释器，可以使用ruby –v 查看版本。0.9.1的redmine不支持ruby1.9.x的。

1）下载ruby并安装

http://ruby.taobao.org/mirrors/ruby/

#wget ftp://ftp.ruby-lang.org/pub/ruby/2.1/ruby-2.1.4.tar.gz

#tar xf ruby-2.1.4.tar.gz

#./configure --prefix=/usr/local/ruby && make &&make install

安装完成之后修改系统的PATH路径：

# vim /etc/profile.d/ruby.sh

export PATH=/usr/local/ruby/bin:$PATH

# . /etc/profile.d/ruby.sh 使其生效

#ruby -v 查看安装好的ruby版本

2）安装ruby on ralis

在安装rails之前，要先安装rubygems，rubygems是ruby的在线包管理工具，类似yum和apt-get可以从rubyforge下载。

#wget http://production.cf.rubygems.org/rubygems/rubygems-2.4.1.tgz

# tar xf rubygems-2.4.1.tgz

# ruby setup.rb 使用ruby命令进行安装

安装rails，安装之前确保主机可以正连接互联网。

# gem install rails -v=2.3.5 -v可以查看安装详情

gem install 出现Errno::ECONNRESET: Connection reset by peer - SSL_connect

原因：可能是上次openssl心血漏洞，导致服务器更新了ssl,拒绝了所有低版本的SSL链接。

目前网站无法打开。还好国内淘宝有镜像，实现方式如下：

[root@kali rubygems-2.4.8]# gem source --remove https://rubygems.org/

https://rubygems.org/ removed from sources

[root@kali rubygems-2.4.8]# gem sources -a https://ruby.taobao.org/

https://ruby.taobao.org/ added to sources

[root@kali rubygems-2.4.8]# gem sources -l

*** CURRENT SOURCES ***

https://ruby.taobao.org/

详情请参考：https://ruby.taobao.org/

# gem install rails 执行之后gem会通过访问ruby.taobao.org官网下载所有rails依赖的软件包进行安装。-v=2.3.5 可以指定安装rails的版本。

# rails -v 查看rails的版本

Rails 2.3.5

# gem install bundle 安装bundle，bundle是创建rails项目时候需要

# vim /var/www/redmine/Gemfile 编辑gemfile文件

#source "http://rubygems.org" 把这段注释掉，添加下面淘宝的就可以了

source 'https://ruby.taobao.org' 修改成淘宝的 之后安装速度就块了

#bundle install

#./bin/bundle install 执行安装

以上三条相当重要，否则用ruby官网的源更新速度只有等待…..

3）创建数据库

此处直接yum安装数据库了。需要安装MysqL 具体安装请参考：

http://www.mrliangqi.com/729.html

#MysqL

MysqL> create database redmine default character set utf8; 创建数据库

MysqL> grant all on redmine.* to root@localhost;

MysqL> grant all on redmine.* to redmineuser;

MysqL> grant all on redmine.* to redmineuser @localhost;

MysqL> set password for redmineuser@localhost=password('redminpwd');

MysqL> flush privileges; 使其生效

4）Rake安装

# gem install rake

Fetching: rake-10.4.2.gem (100%)

rake's executable "rake" conflicts with /usr/local/ruby/bin/rake 如果提示这样，那么就是有冲突问题。紧接着会弹出Overwrite the executable? [yN] 是否改写可执行文件，输入Y即可。

5）安装Redmine

需要根据redmine对应支持的版本下载，如果不清楚，具体请查阅：http://www.redmine.org/wiki/redmine/RedmineInstall

#wget http://www.redmine.org/releases/redmine-3.0.3.tar.gz

# tar xf redmine-3.0.3.tar.gz

# mv redmine-3.0.3 /usr/local/redmine

6）设置数据库参数

# cd /usr/local/redmine/config

# cp configuration.yml.example database.yml

#vim database.yml

production:

adapter:MysqL2

database:redmine

host:localhost

username:redmineuser

password:”redminepwd“

encoding: utf8

保存推出：wq

7）检查并安装依赖包 （如果bundle install安装没问题，就可以忽略此步）

gem install bundler

gem install jquery-rails

gem install rake -v '10.4.2'

gem install json -v '1.8.3'

gem install actionpack-action_caching -v '1.1.1'

gem install actionpack-xml_parser -v '1.0.2'

gem install coderay -v '1.1.0'

gem install jquery-rails -v '3.1.2'

gem install MysqL2 -v '0.3.18'

gem install net-ldap -v '0.3.1'

gem install protected_attributes -v '1.0.9'

gem install ruby-openid -v '2.3.0'

gem install rack-openid -v '1.4.2'

gem install rbpdf -v '1.18.5'

gem install redcarpet -v '3.1.2'

gem install request_store -v '1.0.5'

8）Remine设定

以下所有操作都需要在redmine的目录执行

# rake generate_secret_token 执行这条会话缓存

#rake db:migrate RAILS_ENV="production" 生成表，需要配置好数据库连接。

MysqL> show tables;

+-------------------------------------+

| Tables_in_redmine |

+-------------------------------------+

| attachments |

| auth_sources |

| boards |

| changes |

| changeset_parents |

| changesets |

| changesets_issues |

| comments |

| custom_fields |

| custom_fields_projects |

| custom_fields_roles |

| custom_fields_trackers |

| custom_values |

| documents |

| email_addresses |

| enabled_modules |

| enumerations |

| groups_users |

| issue_categories |

| issue_relations |

| issue_statuses |

| issues |

| journal_details |

| journals |

| member_roles |

| members |

| messages |

| news |

| open_id_authentication_associations |

| open_id_authentication_nonces |

| projects |

| projects_trackers |

| queries |

| queries_roles |

| repositories |

| roles |

| schema_migrations |

| settings |

| time_entries |

| tokens |

| trackers |

| user_preferences |

| users |

| versions |

| watchers |

| wiki_content_versions |

| wiki_contents |

| wiki_pages |

| wiki_redirects |

| wikis |

| workflows

# RAILS_ENV=production rake redmine:load_default_data 设置默认语言 ，这个默认设置之是在登录时候界面语言，登录之后可以修改。

Select language: ar,az,bg,bs,ca,cs,da,de,el,en,en-GB,es,es-PA,et,eu,fa,fi,fr,gl,he,hr,hu,id,it,ja,ko,lt,lv,mk,mn,nl,no,pl,pt,pt-BR,ro,ru,sk,sl,sq,sr,sr-YU,sv,th,tr,uk,vi,zh,zh-TW [en] zh

====================================

Default configuration data loaded.

9）修改fastcgi并安装安装mod_facgi

[root@localhost redmine-3.0.3]# cd public/

[root@localhost public]# cp dispatch.fcgi.example dispatch.fcgi

[root@localhost public]# cp htaccess.fcgi.example htaccess.fcgi.

[root@localhost public]# cp dispatch.fcgi htaccess.fcgi plugin_assets/

# chmod -R 755 files log tmp public/plugin_assets 设置好相应的权限

#yum-yinstallmod_fcgid 需要配置epel源

10）修改redmine目录的权限

[root@localhost local]# chown -R apache.apache redmine-3.0.3

[root@localhost local]# chmod -R 755 redmine-3.0.3

11）启动redmine

[root@ redmine-3.0.3]# ruby bin/rails server webrick -e production -b 192.168.100.10 -d

=> Booting WEBrick

=> Rails 4.2.1 application starting in production on http://192.168.100.10:3000

=> Run `rails server -h` for more startup options

=> Ctrl-C to shutdown server

[2015-07-29 16:22:11] INFO WEBrick 1.3.1

[2015-07-29 16:22:11] INFO ruby 2.1.4 (2014-10-27) [x86_64-linux]

[2015-07-29 16:22:11] INFO WEBrick::HTTPServer#start: pid=25683 port=3000

参数说明：

-b 绑定ip。

-d 后台运行。

-e 指定默认配置文件。

#rails server -h 可以获取更多的帮助。

12)测试访问

默认的登录地址：http://192.168.100.10:3000/

用户密码：admin/admin

三.总结

首次安装redmine的大概步骤如上说述，最后我说下基本的组建和作用以及这次的一个整理认识，首先要安装要ruby开发环境，接着就是安装gem，gem是ruby来实现类似于apt-get/yum一样的在线安装管理工具，这块主要用安装后续的bundle,rake,rails,等，这些安装好之后就是下载redmine，然后修改相应的配置配置文件，安装好MysqL数据库之后创建redmine的数据库用户和密码之后，接着是进行redmine的设置，这块主要是生成数据库的表的简单表结构，和一些数据导入，最后修改下目录以及用户权限等配置，最后启动即可！

后续：

如何使用版本库？

1．首先在config/configuration.yml下配置SCM的可执行程序路径

2．配置完成之后，重启redmine服务，打开redmine>使用管理员登录>管理>配置

Subverion command为配置的执行路径，前面的checkBox打勾>保存，填入SVN的帐号密码保存即可。

3．配置好之后，即可在项目>版本库中出现版本库的页签。

如果配置错误，点击版本库标签会出现，版本库中不存在该条没有和（或）其修订版本。

配置邮件通知？

作为一个项目管理平台，必须能够通知项目成员有关项目的各种状态变化，这也是一种典型的观察模式，开发人员可以跟踪某个任务，当任务状态，备注，文档，优先级等变化时候开发人员就可以得到通知。

对于新配置的redmine，需要创建用户，还需要给新建的用户发送一封邮件，告诉他帐号，redmine平台的地址等相关信息。

因此配置邮件通知是第一步，必须要做的事情。

配置文件：

Config/configuration.yml是remdine的配置文件，里面有非常多的选项，邮件通知，附件保存地址，SCM，rmagick 等…

一般安装完毕之后需要复制configuration.yml.example文件，然后把.example后缀去掉。

基础的邮件服务器及帐号配置：

用文本编辑器打开configuration.yml文件，找到下面内容：

default:

email_delivery:

delivery_method: :smtp

smtp_settings:

address: "mail.mrliangqi.com"

port: 25

authentication: :login

domain: 'mrliangqi.com'

user_name: 'redmine@mrliangqi.com'

password: 'wmhredmine'

说明在ruby中，一定要注意的是航缩进，它跟python一样，没有语句结束符，是靠缩进来控制的。

配置好之后，重启redmine，然后在redmine的后台中填写好邮件通知的邮箱帐号即可。