redmine 安装

Redmine安装总结报告

本次安装Redmine共耗时三天，以下是我的安装过程，仅供参考。

安装之前我们要先了解什么是Redmine？它是用来做什么的？怎样安装？

首先介绍一下Redmine，它是使用Ruby语言，ROR框架编写的基于web的一款项目管理工具，简洁的界面，简单的使用方式使它深受开发项目小组的喜爱，公司以前一直使用的都是别人的，现在自己搭建一个。

首先先上网查询什么事Redmine，它需要什么运行环境，安装过程等，这个过程你会有很多错误，但是不要灰心，我们一步一步来，Bug是无穷无尽的，我们需要的是耐心。

因为我也是第一次安装，小白一个，所以大家按着我的步骤来，我们一步一步往前走。我先百度了一下Redmine，知道了它是什么，用什么编写的，要什么环境来运行，接着我了解了一下编写它的语言Ruby，知道了它来自日本，是一种富有创造性的计算机编程语言，然后知道了它的框架Rails，知道了改变它命运的ROR，那么接下来的我就知道了。我需要Ruby语言的环境和框架Rails，需要Redmine的源代码，还需要一个数据库。接下来我百度了“Redmine安装”，这里吐槽一下，大部分教程其实都一样，很多都没写遇到的错误，然而我遇到了很多错误，否则按照教程一直“下一步”恐怕十分钟就能完成安装，可能他们都是被老天眷顾的人。好了接下来就开始了，首先是我的下载文件如下：

别看很多，其实很多是我自己犯的错误和自己二导致的无用功，希望大家引以为戒，后面我会为大家详细的介绍我的成功以及我犯的错误。

首先介绍我第一步下载的文件，我参考网上的资料，大致有三种安装方式，第一种事集成安装，有一款软件把所有安装步骤集成了，你只用点下一步，感觉很棒噢，我瞬间心动了，然后下载咯，就是上面那个bitnami-redmine-3.4.3-1，然后满怀期待的点开了，然而事实证明我并不是被老天眷顾的主角，我没能成功一直“下一步”下去，感觉心态都爆炸了，为什么别人都可以，我就不可以，然后我发现大家其实好多都没成功，然后我安心的去寻找下一个方法了，前面说了Redmine是使用的ROR技术，我们第一次简单的方法没成功，就只有自己一步一步来了，安装ROR网上有两种方式，一种也是使用别人写好的工具包，直接安装环境和框架，一种是自己先安装语言环境，然后安装框架，这里推荐大家使用工具包，毕竟Ruby的环境安装比Java复杂，很多人Java都玩蹦了，更别说Ruby了，这里使用的工具包我也下载了，叫做railsinstaller,这个工具包就比上一个靠谱，毕竟我成功了，这里的版本选择最新的，毕竟好久没更新了，大家安装好了之后可以查看自己的环境，使用命令提示符查看，首先使用winds+r弹出命令框，运行cmd后出现命令提示符，使用ruby -v,rails -v,gem -v查看安装是否成功，如果出现如下类似的图那么恭喜你成功了。

 

 

 

 

 环境安装好之后我们安装数据库，这里我选择了常用的MySQL数据库。安装过程我就不简述了，网上到处都是。这里要注意的是端口号3306如果被占用了，你修改了端口号，那么一定要记住，因为后面的配置需要修改。安装完成以后你可以去自己的电脑打开程序看一下是否安装成功。确认安装成功后我们再进行下一步，这里推荐使用图形化界面软件navicat来操作数据库。新建一个数据库redmine，这个数据库就是我们redmine后台存取数据的数据库了。表不用建，我们一会使用命令进行填充。到这一步以后接下来基本就是操作命令提示符了，这一步时你可以新创建一个管理员专门管理你的redmine表，我这里就直接使用超级管理员了。在使用railsinstaller之后它会在你安装目录下创建两个文件夹，分别为Railsinstaller和Sites，前者存放ROR，后者存放Redmine，你需要自己去官网下载Redmine，注意查看以下依赖，看一下它匹配的ROR版本，一般不要下载最新版的，选择用的人比较多了版本。下载之后解压到前面说的Sites文件夹下，然后去安装数据库的盘下寻找这个

一个名叫libmysq.dlll的文件把它复制到Railsinstaller文件下的Ruby1.9.3文件夹下的bin文件夹里，百度说的是为了 Redmine 可以正常连接 MySQL，需要 MySQL的 C API库，即 libmysql.dll。我也不知道为什么，不复制一般都会报错，所以还是复制咯。然后进入命令提示符，使用CD..退出和CD进入文件夹，进入到Sites文件夹下的解压的redmine的文件夹里如：C:\Sites\redmine-3.3.5> 然后执行接下来的步骤。

在你的redmine安装目录下找到config文件夹如C:\Sites\redmine-3.3.5\config，在这个文件夹里创建一个新的.yml文件"database.yml"它名字叫database，后缀为.yml。内容为database.yml.example复制一份过来就可以了。用记事本打开新建的这个文件，可以看到如下内容：

 

# Default setup is given for MySQL with ruby1.9.
# Examples for PostgreSQL, SQLite3 and SQL Server can be found at the end.
# Line indentation must be 2 spaces (no tabs).

production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: "my_password"
  encoding: utf8

 

在这里你需要修改就是用户名和密码，注意密码用引号引起来。前面说过如果你修改过数据库的端口号，那么你要记住它，如修改为3303，在这里要做修改，最后添加一行：port:3303

否则连接不上数据库，新建的这个文件就是redmine的数据库配置文件。

在前面已经打开的命令提示符下输入gem sources-l查看下载源，很多人的国外源用不了，只有改变为国内的，我的用的起，就不改变了。如果有需要改变的，步骤如下：

输入更改下载地址: gem sources -l查看当前的下载地址

如果不是这个下载地址先移除原来的地址，移除指令：gem sources -remove https://rubygems.org/

然后：gem sources -a http://gems.ruby-china.org/

然后安装 gem install mysql2

然后 bundle install --without development test rmagick安装所有需要的gems

安装过程中如果提示出错根据提示内容安装所需要的  gem XXX -v=XXXX

或者安装过程中如果提示出错如提示依赖rbpdf-font没有，导致安装中断，就执行一下 gem install rbpdf-font，然后再执行上面的命令。一直到安装完成。

生成会话保存** ，开始命令生成一个随机的 Key ， Rails用它来加密 cookie ……

bundle exec rake generate_secret_token、

一直到安装完成，到这一步你都没出错，那你真的是天选之子，很明显，我不是，所以我出错了，出现了如下错误：

百度了很多终于找到问题，还是和数据库不匹配造成的，需要我们建立mysql2的时候自己指定文件夹，这个东西可以去mysql官网下载，如图：

 

然后先删除以前的mysql2

然后执行下面的语句：

gem installmysql2 --platform=ruby --'--with-mysql-lib="C:\mysql-connector-c-noinstall-6.0.2-win32\lib"--with-mysql-include="C:\mysql-connector-c-noinstall-6.0.2-win32\include"'这里注意修改为自己放置文件的地址。然后执行bundle exec rake generate_secret_token，就没有错了。然后填充数据库，

创建数据库结构，使用下面的命令：

set RAILS_ENV=production

bundle exec rake db:migrate

执行时间比较长，默默等待祈祷成功吧。

使用下面的命令来向数据库中插入默认的配置数据

set RAILS_ENV=production

bundle exec rake redmine:load_default_data  如下图：

 

出现输入zh，如下图：这里使用了别人的图，因为我运行完指令后再次运行就没有这个图了，索性参考别人的！

到这里你可以去查看自己的数据库了，自动填充之后里面会自己建立很多表。

如果你遇到如下的错误：

!] There wasan error parsing `Gemfile`: unknown regexp options - rbyg. Bundler cannotcontinue.

# from C:/sITES/redmine/Gemfile:1

# -------------------------------------------

#   eval_gemfile file

> end

# source ??https://rubygems.org/??

这个错误我百度了很近也没有答案，最后我重新导入了redmine的文件夹，就没有错误了，很神奇的问题，至今不懂。接下来就是最后一步了，执行下面的语句开启服务，注意不要关闭命令提示符，否则服务会停止。railsserver webrick -e production，执行之后如果你看到如图所示，那么恭喜你成功了！

接下来你就可以打开你的浏览器输入http://localhost:3000默认账号和密码都是admin。

以上就是我的总结，如果你还遇到了其他问题那么请自行百度，谢谢！