Redmine安装手册

有两种安装方式：一键安装和手动安装， 推荐采用一键安装，如果是手动安装会遇到各种版本不兼容问题，解决起来比较麻烦。

一键安装

二、手动安装安装ruby和rails，由于redmine是基于ruby开发的，所以需要先安装ruby。Redmine版本与ruby版本配套关系如下：

Redmine version

Supported Ruby versions

Rails version used

4.0 (upcoming)

ruby 2.2 (2.2.2 and later), 2.3, 2.41, 2.5

Rails 5.2

3.4

ruby 1.9.34, 2.0.03, 2.1, 2.22, 2.3, 2.41

Rails 4.2

3.3

ruby 1.9.34, 2.0.03, 2.1, 2.22, 2.3

Rails 4.2

由于我们使用的remine3.4.6,所以需要下载安装ruby2.4。登录网址：

安装时可以采用默认的安装方式，安装devkit比较慢。默认安装成功之后，验证ruby和devkit是否安装成功，运行窗口“start command prompt with ruby”，将会打开ruby命令行窗口，输入ruby –v 查看ruby版本。安装ruby时会自动安装RubyGems(简称 gems)，是一个用于对 Ruby组件进行打包的 Ruby 打包系统。 它提供一个分发 Ruby 程序和库的标准格式，还提供一个管理程序包安装的工具。RubyGems的功能类似于Linux下的apt-get。使用它可以方便的从远程服务器下载并安装Rails。执行gem –v 查看gem的版本。

Rails是一个MVC开发框架，Rails 提供一个纯Ruby的开发环境。在ruby命令行窗口，输入执行命令 gem install rails –v ‘4.2’ 开始安装rails。安装完成之后执行rails –v 查看版本。安装Mysql

需要mysql5.0-5.5。下载解压版mysql,展开到目录E:\mysql-5.7.19-winx64，进入bin目录，执行mysqld –install 成为windows服务。(如果忘记了mysql root密码，则可以先停止mysql服务，然后以管理员身份执行mysqld –skip-grant-tables; 执行mysql –u root –p ；修改密码use mysql; update user set authentication_string = password(‘new passwd’) where user=’root’; flush privileges;重启mysql服务)

执行以下语句，创建用户：

CREATE DATABASE redmine CHARACTER SET utf8mb4;

CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'redmine';

GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';安装redmine

解压到d:\redmine-3.4.6目录，把配置文件config/database.yml.example另存为config/database.yml，修改数据库连接信息：

production:

adapter: mysql2

database: redmine

host: localhost

username: redmine

password: "my_password"

在d:\redmine-3.4.6目录下执行 bundle install –without development test rmagick 安装依赖包。

在d:\redmine-3.4.6目录下执行gem install mysql2 -v ‘0.4.10’ --platform=ruby。

在d:\redmine-3.4.6目录下执行 bundle exec rake generate_secret_token 生成会话密钥。如果报错的话需要重新安装mysql2，执行如下命令：gem uninstall mysql2, 先卸载再重新安装，gem install mysql2 -v '0.4.10' --platform=ruby -- '--with-mysql-lib="C:\Program Files\MySQL\MySQL Server 5.5\lib" --with-mysql-include="C:\Program Files\MySQL\MySQL Server 5.5\include" --with-mysql-dir="C:\Program Files\MySQL\MySQL Server 5.5"'。

执行：set RAILS_ENV=production

bundle exec rake db:migrate

RAILS_ENV=production bundle exec rake redmine:load_default_data

bundle exec rails server webrick -e production

登录系统：http://127.0.0.1/redmine 默认账号/密码 admin/admin