Redmine最新版4.1.1安装

testerzhang 8/26/2020 redmine

本文主要讲解如何在CentOS7安装Redmine4.1.1。

# 前言

本文主要记录CentOS7.8安装 Redmine 4.1.1，记录一下安装和配置过程。

# Redmine是什么？

维基百科是这么定义的：

Redmine是一个网页界面的项目管理与缺陷跟踪管理系统的自由及开放源代码软件工具。它集成了项目管理所需的各项功能：日历、燃尽图和甘特图以协助可视化表现项目与时间限制，问题跟踪和版本控制。此外，Redmine也可以同时处理多个项目。

一般用来发布问题，了解问题的进展，也可以当成bug系统录入bug进行跟踪。

# 系统安装说明

本例是在CentOS7环境进行安装：

# cat /etc/redhat-release 
CentOS Linux release 7.8.2003 (Core)

1
2

# ROOT系统用户安装Redmine依赖库

# yum install mysql-devel libcurl-devel ImageMagick ImageMagick-devel

# ROOT系统用户移除Ruby

因为系统自带的Ruby版本太低，不支持最新版本Redmine，为此我们先移除系统的Ruby，然后下面再安装最新版本的Ruby。

移除的命令：

# yum remove ruby

# ROOT系统用户安装RVM

可能大家对RVM是什么，没有概念。RVM英文全称Ruby Version Manager（Ruby版本管理器），它是用于类UNIX操作系统的软件平台，用于管理同一设备上Ruby的多个安装。

执行以下命令进行安装

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

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

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

1
2
3
4
5

# 将普通用户加入到RVM组

因为本次安装Redmine，最终我是用普通用户db进行安装，所以先看看当前普通用户的组信息。

# id db
uid=1004(db) gid=1005(db) 组=1005(db)

1
2

将用户添加到 rvm 用户组中，本例将 db 用户添加到 rvm 用户组中

# gpasswd -a db rvm

加完之后，可以看到1007(rvm)已经加入到普通用户db组里。

# id db
uid=1004(db) gid=1005(db) 组=1005(db),1007(rvm)

1
2

然后系统用户root进行退出重新登录，使用如下命令加载 RVM 环境。

# source /etc/profile.d/rvm.sh 

# rvm reload

加载之后，使用如下命令校验依赖项，该命令会提示缺失的依赖，按要求安装即可。
# rvm requirements run

1
2
3
4
5
6

# ROOT系统用户安装Ruby

上面我们已经移除系统Ruby，下面我们来安装Ruby2.6版本。

当然你要先看看目前有哪些Ruby版本可以用，可以先执行以下命令。

# rvm list known

这里因为支持2.6，所以执行下面这个命令即可。

# rvm install 2.6

设置默认 Ruby 版本

# rvm use 2.6 --default

检验是否生效成功

#  ruby --version
ruby 2.6.5p114 (2019-10-01 revision 67812) [x86_64-linux]

1
2

# 安装MySQL

以前我已经专门写过一篇如何安装MySQL，有兴趣的可以点击查看：数据库-CentOS6安装MySQL-5.7.28

# 初始化数据库

我们连接到MySQL的root用户，进行创建普通用户redmine和设置密码权限。

mysql> CREATE DATABASE redmine CHARACTER SET utf8mb4;
mysql> CREATE USER 'redmine'@'localhost' IDENTIFIED BY '你的密码';
mysql> GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
mysql> exit

1
2
3
4

# 普通用户安装Redmine

终于进入主角的安装说明了，不容易。

下载Redmine安装包

$ curl -LO http://www.redmine.org/releases/redmine-4.1.1.tar.gz

解压Redmine安装包

$ tar -zxvf redmine-4.1.1.tar.gz

配置数据库参数

这里我安装在了家目录的redmine-4.1.1，请各位以实际安装目录进行操作。

$ cd /home/db/redmine-4.1.1/config
$ vi database.yml

1
2

编辑这个数据库配置文件修改production配置节信息即可

production:
  adapter: mysql2
  database: redmine
  host: 127.0.0.1
  port: 13306
  username: redmine
  password: "你的具体密码"
  # Use "utf8" instead of "utfmb4" for MySQL prior to 5.7.7
  encoding: utf8mb4

1
2
3
4
5
6
7
8
9

配置邮件信息

$ cd /home/db/redmine-4.1.1/config
$ vi configuration.yml

1
2

按照邮件配置项进行配置，这里我提供下我的配置信息。

default:
  # Outgoing emails configuration
  # See the examples below and the Rails guide for more configuration options:
  # http://guides.rubyonrails.org/action_mailer_basics.html#action-mailer-configuration
  email_delivery:
    delivery_method: :smtp
    smtp_settings:
      address: smtp.163.com
      port: 465
      ssl: true
      enable_starttls_auto: true
      domain: 163.com
      authentication: :login
      user_name: "用户邮箱地址"
      password: "授权码"

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

依赖安装

$ cd /home/db/redmine-4.1.1

$ gem install bundler

$ bundle install --without development test

$ bundle exec rake generate_secret_token

1
2
3
4
5
6
7

创建数据库 Schema

$ bundle exec rake db:migrate RAILS_ENV=production

初始化redmine数据库

$ bundle exec rake redmine:load_default_data RAILS_ENV=production

启动redmine服务（前台运行启动测试）

$ bundle exec rails server webrick -e production

看看系统启动有没有报错，如果没有报错，就按住Ctrl+C两个键退出进程。

启动redmine服务（后台运行）

$ bundle exec rails server webrick -e production -d

看到这里，恭喜你，是个比较有耐心的人。

# 访问网页版入口

因为Redmine默认是3000端口，那么你访问的地址应该是：

http://10.10.10.10:3000/

然后进行配置即可，默认用户密码都是admin。

这里需要提示一点：在配置邮件通知的时候要保持你的邮件发件人地址和配置文件配置的账号信息一致。

Redmine最新版4.1.1安装

到这里，Redmine完成安装了，至于界面的操作，相信你们可以自行操作，这里就不讲解。

# 结束

感谢大家的耐心观看，码字不易，希望能帮助到你。

欢迎关注我的公众号testerzhang，原创技术文章第一时间推送。

公众号二维码

testerzhang个人博客

Choose mode