CentOS搭建redmine项目管理系统

背景

由于项目需要，决定用开源而强大的redmine系统作为项目管理软件。由于服务器（CentOS6.8）没有预装ruby、ROR（Ruby on rails）环境，本文内容是从0开始搭建的，中间也吃了不少软件兼容性等的苦头，参阅了不少文章，遂做下笔记，希望对有同样需要的同仁有些帮助。

有关redmine的介绍可以自己多做了解，废话不多说，进入正题： 

强烈建议：搭建过程请使用“科学上网“环境进行，理由就不用多说了。

软件环境

搭建redmine共需要安装如下软件/包环境，还有一些依赖软件/包等：

1.数据库 (这里以mysql为例) 

2.redemine项目源码 

3.RVM (Ruby版本管理器) 

4.Ruby 

5.rubyGems (对 Ruby组件进行打包的 Ruby 打包系统) 

6.Rails(Ruby on Rails) 

7.其他依赖包等

本次搭建中使用到的软件版本

1.mysql5.5(官方推荐，因为5.6有些已知的问题，当然其他数据库也可以) 

2.redmine3.3.3.stable 

3.Ruby2.3.3 

4.Rails4.2.7.1 

5.其他略

安装

MYSQL安装

安装mysql

mysql的安装、建库、创建用户等可以参考我的另一篇文章： 

http://blog.csdn.net/irokay/article/details/50528896 

或者使用yum直接安装：

 yum install mysql-server

• 1

创建redmine数据库并授权用户

redmine需要创建名为“redmine“等数据库。  官方安装地址：http://www.redmine.org/projects/redmine/wiki/RedmineInstall

 create database redmine default character set utf8 default collate utf8_general_ci;

• 1

 grant all privileges on redmine.* to redmine@'%' identified by 'redmine@123' with grant option;

• 1

 flush privileges;

• 1

示例为mysql安装到当前应用服务器的情景，当然也可以安装至其他服务器。

下载开源项目redmine

地址：http://www.redmine.org/projects/redmine/wiki/Download

我选择安装redmine-3.3.3.tar.gz版本  注意各版本对ruby及rails的版本兼容性，选择兼容的软件版本搭建运行环境：

按要求，我选择了redmine3.3.3，ruby2.3，Rails4.2

redmine数据库链接配置

将下载的项目上传服务器并解压至/opt目录

 tar zxf ./redmine-3.3.3.tar.gz

• 1

文件名太长，改个名：

 mv redmine-3.3.3 redmine

• 1

进入项目根目录：

 cd /opt/redmine

• 1

配置：  redmine相关配置中config目录下，数据库链接配置文件官方给了一个example文件database.yml.example，copy一份改名为database.yml作为项目正式引用数据库配置文件：

 cp config/database.yml.example config/database.yml

• 1

修改production参数如下：

 production: adapter: mysql2 database: redmine host: localhost username: redmine password: redmine@123

• 1
• 2
• 3
• 4
• 5
• 6

Esc :wq 保存退出。

安装RVM

安装curl

 sudo yum install curl

• 1

安装RVM

 curl -L get.rvm.io | bash -s stable

• 1

若出现如下失败提示：

执行提示命令：

 curl -sSL https://rvm.io/mpapis.asc | gpg2 --import

• 1

继续安装RVM：

 curl -L get.rvm.io | bash -s stable 

• 1

查找配置文件位置

 find / -name rvm.sh

• 1

使配置文件生效

 source /etc/profile.d/rvm.sh

• 1

安装RVM依赖

 rvm requirements 

• 1

继续安装rvm推荐的依赖

 rvmsudo yum install -y gcc-c++ patch readline readline-devel zlib zlib-devel libyaml-devel libffi-devel openssl-devel make bzip2 autoconf automake libtool bison iconv-devel

• 1

安装Ruby

查看已有ruby版本

 rvm list known

• 1

根据要求，这里选择安装2.3.3版本

 rvm install 2.3

• 1

查看ruby版本信息：

 ruby -v

• 1

默认使用2.3.3版本

 rvm use 2.3.3 --default

• 1

安装rubyGems

使用命令：

 rvm rubygems current

• 1

提示已经安装，看来是安装ruby时已经顺带安装了，good！

安装Rails

切记，勿使用gem install rails直接安装最新rails版本，当前安装需要指定4.2版本，所以这里安装指定4.2版本  https://rubygems.org/gems/rails/versions/4.2.7.1

安装命令

 gem install rails -v 4.2.7.1

• 1

安装需要一段时间，耐心等待。

提示如下信息：

 [root@VM_254_12_centos redmine]# gem install rails -v 4.2.7.1 Fetching: i18n-0.8.4.gem (100%) Successfully installed i18n-0.8.4 Fetching: thread_safe-0.3.6.gem (100%) Successfully installed thread_safe-0.3.6 Fetching: tzinfo-1.2.3.gem (100%) Successfully installed tzinfo-1.2.3 ...... ............ Done installing documentation for i18n, thread_safe, tzinfo, activesupport, rack, rack-test, mini_portile2, nokogiri, loofah, rails-html-sanitizer, rails-deprecated_sanitizer, rails-dom-testing, builder, erubis, actionview, actionpack, activemodel, arel, activerecord, globalid, activejob, mime-types-data, mime-types, mail, actionmailer, thor, railties, bundler, concurrent-ruby, sprockets, sprockets-rails, rails after 348 seconds 32 gems installed

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11

激动的去查看rails版本信息验证是否安装成功：

报错，提示找不到jquery-rails，不过给了提示在执行“bundle install”时会安装确实的gems，所以不用着急。

我这里还是执行了下几个依赖包的安装，不过不执行应该也没问题，应该会在bundle install时安装。

 gem install jquery-rails gem install rake gem install mysql2

• 1
• 2
• 3

安装其他可能依赖的包

 yum -y install patch make gcc gcc-c++ gcc-g77 flex* bison file 

• 1

 yum -y install libtool libtool-libs libtool-ltdl-devel* autoconf kernel-devel automake libmcrypt* 

• 1

 yum -y install libjpeg libjpeg-devel libpng libpng-devel libpng10 libpng10-devel gd gd-devel 

• 1

 yum -y install freetype freetype-devel libxml2 libxml2-devel zlib zlib-devel 

• 1

 yum -y install glib2 glib2-devel bzip2 bzip2-devel libevent libevent-devel 

• 1

 yum -y install ncurses ncurses-devel curl curl-devel e2fsprogs 

• 1

 yum -y install e2fsprogs-devel krb5 krb5-devel libidn libidn-devel 

• 1

 yum -y install openssl openssl-devel vim-minimal nano sendmail 

• 1

 yum -y install fonts-chinese gettext gettext-devel 

• 1

 yum -y install gmp-devel pspell-devel 

• 1

 yum -y install readline* libxslt* pcre* net-snmp* gmp* libtidy* 

• 1

 yum -y install ImageMagick* subversion* 

• 1

添加一个系统用户redmine

因为在执行bundle install命令时，提示不建议使用root执行，导致其他用户目录权限问题。  使用普通用户安装过程中，如果需要使用sudo权限的，会提示你输入sudo密码。

新建用户redmine

 useradd –d /usr/redmine -m redmine

• 1

修改redmine用户密码

用户名：redmine，密码：redmine

 passwd redmine New password: redmine

• 1
• 2

此命令创建了一个用户redmine，其中-d和-m选项用来为登录名redmine产生一个主目录/usr/redmine（/usr为默认的用户主目录所在的父目录）。

给予redmine用户sudo权限：

参考：http://blog.csdn.net/u012102306/article/details/50851200

切换redmine用户

 su redmine

• 1

安装依赖

切换至用户redmine后，安装依赖：

 bundle install

• 1

中间有多次请求输入remine sudo密码：redmine

提示信息：  Fetching i18n 0.7.0  Fetching json 1.8.6  Fetching minitest 5.10.2  ……

可能的错误提示：  Gem::FilePermissionError: You don’t have write permissions for the /usr/local/rvm/gems/ruby-2.3.3

提示当前用户没有写入权限。

赋予redmine用户权限：

 sudo chmod -R 777 /usr/local/rvm/ sudo chmod -R 777 /opt/redmine/

• 1
• 2

可能多次提示无写入权限并授权后，install成功：

添加会话缓存

当前依然使用的redmine用户

 bundle exec rake generate_secret_token

• 1

生成表结构

 RAILS_ENV=production bundle exec rake db:migrate

• 1

设置语言，选择中文（zh）

 RAILS_ENV=production bundle exec rake redmine:load_default_data

• 1

文件系统权限设置

 mkdir -p tmp tmp/pdf public/plugin_assets

• 1

 sudo chown -R redmine:redmine files log tmp public/plugin_assets

• 1

 sudo chmod -R 755 files log tmp public/plugin_assets

• 1

运行WEBrick服务，启动项目

 nohup bundle exec rails server webrick -e production -b 0.0.0.0 -p 3000 &

• 1

说明：官方命令为bundle exec rails server webrick -e production，这里做了一点装饰。nohup 不挂断地运行命令，& 让程序在后台自动运行，-b 0.0.0.0 授权所有IP访问权限，-p 3000 端口。另外nohup使原程序的的标准输出自动改向到当前目录下的nohup.out文件，起到了log的作用。如果当前目录的 nohup.out 文件不可写，输出重定向到 $HOME/nohup.out 文件中。

启动成功！  可通过ip:3000端口访问redmine主页了，admin初始密码为admin，第一次登录要求更改管理员密码。

其他配置待续