分类：项目管理| 发表于 2015年7月29日 星期三 下午5:38
一．简介：
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的后台中填写好邮件通知的邮箱帐号即可。