开源Bug管理系统Redmine安装和使用心得

        最终忍受不了公司使用论坛+Excel来进行bug反馈和管理工作了，于是花了一个上午时间研究了下bug管理系统。这样一个bug管理系统能够轻松的查看bug新增了哪些，攻克了哪些。当前是谁，要在什么时间解决。不管是qa还是程序都能够轻易的在这个系统上面查看当前要解决和复測的bug。

       终于目标锁定为两个开源的项目管理系统，禅道和Redmine，两个都很优秀，而我的需求又很easy------能提交、追踪、反馈bug就能够了，这两个系统都是能够胜任的。尽管这篇文章解说的是Redmine的安装和使用心得，可是对于多数用户，可能禅道是更好的选择。由于它兼具bug管理功能的同一时候，更偏重于项目管理，最重要的是。它的安装很easy。差点儿是一键搞定。 而Redmine的安装部署绝对不是一键简单的工作。

       首先要准备Ruby相关文件，Redmine是基于Ruby on rails开发的。

       1、下载railsinstaller。我这时下载的版本号是railsinstaller-2.2.1.exe，相应的官网：http://railsinstaller.org/en  railsinstaller大大简化了rails的安装。除了windows以下的外，还有iMac以下的安装包。

   2、下载wamp。集成了apache,mysql,php，使用很方便。相应的官网是：http://www.wampserver.com/en/

      站点部署一般都须要wamp，也就是windows+apache+mysql+php的环境。流行的集成环境有两个wampserver和xampp，这里使用的是wampserver

   3、下载ImageMagick，这个是图型生成工具。redmine用于生成pdf等内容，也能够不安装。这个东西我安装的时候有些问题。所以没有安装。

   4、redmine的源文件，这里下载的是redmine2.3.3 ,公布版本号下载列表地址是：http://rubyforge.org/frs/?group_id=1850

   安装文件准备好后。就能够開始安装了。

   1、安装railsinstaller。假设不须要选择文件夹，就一路安装下去就能够了

   2、安装wamp，先安装vc2010的环境vcredist_x86.exe, 再安装wamp,假设不须要选择文件夹，就一路安装下去就能够了

       3、把redmine解压到c:\redmine（你能够自己解压文件夹）

   4、安装ruby下的mysql2。这里使用的是wamp中的mysql，我这里wamp是默认安装。也就是安装在c:\wamp文件夹以下。那边在这里，mysql的文件夹是C:\wamp\bin\mysql\mysql5.6.12。将C:\wamp\bin\mysql\mysql5.6.12\lib下的libmysql.dll和libmysqld.dll拷贝到c:\windows\system32中

        进入dos命令提示符以下，输入

gem install mysql2 -- ‘--with-mysql-lib="C:\wamp\bin\mysql\mysql5.6.12\lib" --with-mysql-include="C:\wamp\bin\mysql\mysql5.6.12\include"‘

注：这里须要mysql相应的头文件和库文件文件夹，否则会安装失败。输入gem list就能够看到mysql2相应的版本

   5、配置数据库    执行wamp。然后配置apache，例如以下图操作

然后找到配置中的directory配置，找到Allow from 127.0.0.1改为Alloc from all,例如以下图所看到的

然后改动C:\wamp\alias下的phpmyadmin.conf,将

<Directory "c:/wamp/apps/phpmyadmin4.0.4/">

    Options Indexes FollowSymLinks ExecCGI

    AllowOverride all

    Order Deny,Allow

    Deny from all

    Allow from 127.0.0.1

    Allow from ::1

    Allow from localhost

</Directory>

中的Allow from 127.0.0.1改为Alloc from all,然后重新启动wamp, 这样就能够局域网对mysql操作了。

我这里的ip是192.168.1.30,在浏览器地址栏输入http://192.168.1.30/phpmyadmin/，这样就能够进入phpmyadmin操作了，这里root默认是没有password，所以，先改动root的password为helloredmine，（你自己实际情况调整）

    6、准备redmine数据库

在phpmyadmin操作sql

CREATE DATABASE redmine CHARACTER SET utf8;
CREATE USER ‘redmine‘@‘localhost‘ IDENTIFIED BY ‘my_password‘;
GRANT ALL PRIVILEGES ON redmine.* TO ‘redmine‘@‘localhost‘;

     7、配置redmine的数据库

在c:\redmine\config文件夹下。复制database.yml.example为database.yml，然后编辑它，来配置。

找到production项，并配置，配置例如以下：（由于都是默认，在这里仅仅要配置password就能够了）

 production:

  adapter: mysql2

  database: redmine

  host: localhost

  username: root

  password: 123456

  encoding: utf8

    8、安装redmine    在dos命令提示下，我们进入到c:\redmine文件夹 然后运行

bundle install --without development test postgresql sqlite

注意：假设在安装过程，有可能由于网络的问题，造成个别的安装不了，那就用gem install xxxxx来安装指定的，安装完毕后。再运行上面的bundle install命令。

直到安装完毕。

成功安装结果例如以下

然后再输入rake generate_secret_token。设置sessiond加密存贮

    9、初始化redmine的数据库    在DOS命令提示符以下，输入以下的命令

set RAILS_ENV=production

rake db:migrate

再输入以下的命令，这里会设置默认语言

set RAILS_ENV=production

set REDMINE_LANG=zh

rake redmine:load_default_data

例如以下图，则表示完毕

    10、执行  在DOS命令提示符下。输入：ruby script/rails server webrick -e production

成功安装，然后在浏览器，输入

http://192.168.1.30:3000

就能够看到redmine的主页了，初始管理员的账号是admin，password是admin，然后就能够进去玩了。

到这里就安装完毕。

假设还须要配置email和svn。请參与官网提示的安装指南 http://www.redmine.org/projects/redmine/wiki/RedmineInstall

一些常见问题的补充说明：

假设运气足够好的话，你能够从第一步一路顺畅的走到第十步。以下是我碰到的一些问题。

1、gem install mysql2 的时候可能由于网络问题，没有成功安装。 多试几次就能够了。

2、正常来说WAMP Server的系统托盘图标应该是绿色的。假设不是的话。可能是某些服务开启失败了。最常见的可能是80port冲突导致apache服务启动失败。

我碰到的情况是由于我之前安装过xamp。所以两个apache冲突了。 删掉xamp后就正常了。

 要想删掉xamp须要先关闭全部的相关服务。

3、mysql的默认是没有password的。

能够通过登陆mysql控制台，然后使用sql语句改动password

       mysql> use mysql;
　  mysql> UPDATE user SET Password = PASSWORD(‘123456‘) WHERE user = ‘root‘;
       mysql> FLUSH PRIVILEGES;

      当中123456就是新的password。

这里要注意sql语句最后的分号不要漏掉。

而且sql运行可能出现失败的情况。多试几次。

4、改动完mysql密码后。php相应的登录password也要改动。否则提示訪问被拒绝。

配置文件的路径是

       C:\wamp\apps\phpmyadmin4.0.4\config.inc.php

      在当中加入

$cfg[‘Servers‘][$i][‘AllowNoPassword‘] = false;
$cfg[‘Servers‘][$i][‘user‘] = ‘root‘; // MySQL user 訪问phpmyadmin使用的mysqlusername 
$cfg[‘Servers‘][$i][‘password‘] = ‘123456‘; // MySQL password (only needed相应上述mysqlusername的密码

5、redmine的mysql登录password配置文件路径是

C:\redmine\config\database.yml

 production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: root
  password: 123456
  encoding: utf8

  因为我们使用的是production,所以仅仅关心这个就足够了。 这里相应上文中第9步。初始化redmine数据库。假设在phpMyAdmin中看不到redmine的数据库，就是这里出问题了。

6、部署好，可以正常訪问了。默认的管理员账户和password都是admin，全部新建账号都须要通过管理员账号激活才干正常使用。