分类:项目管理 | 发表于 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/
# 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 -y install mod_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的后台中填写好邮件通知的邮箱帐号即可。