開源Bug管理系統Redmine安裝和使用心得
終於忍受不了公司使用論壇+Excel來進行bug反饋和管理工作了，於是花了一個上午時間研究了下bug管理系統。這樣一個bug管理系統可以輕鬆的查看bug新增了哪些，解決了哪些，當前是誰，要在什麼時間解決。無論是qa還是程序都可以輕易的在這個系統上面查看當前要解決和複測的bug。
最終目標鎖定爲兩個開源的項目管理系統，禪道和Redmine，兩個都很優秀，而我的需求又非常簡單------能提交、追蹤、反饋bug就可以了，這兩個系統都是可以勝任的。雖然這篇文章講解的是Redmine的安裝和使用心得，但是對於多數用戶，可能禪道是更好的選擇，因爲它兼具bug管理功能的同時，更偏重於項目管理，最重要的是，它的安裝非常簡單，幾乎是一鍵搞定。 而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默認是沒有密碼，所以，先修改root的密碼爲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項，並配置，配置如下：（因爲都是默認，在這裏只要配置密碼就可以了）
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
安裝成功，然後在瀏覽器，輸入
就可以看到redmine的主頁了，初始管理員的賬號是admin，密碼是admin，然後就可以進去玩了。到這裏就安裝完成。如果還需要配置email和svn，請參與官網提示的安裝指南 http://www.redmine.org/projects/redmine/wiki/RedmineInstall
一些常見問題的補充說明：
如果運氣足夠好的話，你可以從第一步一路順暢的走到第十步。下面是我碰到的一些問題。
1、gem install mysql2 的時候可能因爲網絡問題，沒有安裝成功。 多試幾次就可以了。
2、正常來說WAMP Server的系統托盤圖標應該是綠色的。如果不是的話，可能是某些服務開啓失敗了。最常見的可能是80端口衝突導致apache服務啓動失敗。我碰到的情況是因爲我之前安裝過xamp，所以兩個apache衝突了。 刪掉xamp後就正常了。 要想刪掉xamp需要先關閉所有的相關服務。
3、mysql的默認是沒有密碼的。可以通過登陸mysql控制檯，然後使用sql語句修改密碼
mysql> use mysql;
mysql> UPDATE user SET Password = PASSWORD('123456') WHERE user = 'root';
mysql> FLUSH PRIVILEGES;
其中123456就是新的密碼。這裏要注意sql語句最後的分號不要漏掉。 並且sql執行可能出現失敗的情況，多試幾次。
4、修改完mysql密碼後，php對應的登陸密碼也要修改，否則提示訪問被拒絕。配置文件的路徑是
C:\wamp\apps\phpmyadmin4.0.4\config.inc.php
在其中添加
$cfg['Servers'][$i]['AllowNoPassword'] = false;
$cfg['Servers'][$i]['user'] = 'root'; // MySQL user 訪問phpmyadmin使用的mysql用戶名
$cfg['Servers'][$i]['password'] = '123456'; // MySQL password (only needed對應上述mysql用戶名的密碼
5、redmine的mysql登陸密碼配置文件路徑是
C:\redmine\config\database.yml
production:
adapter: mysql2
database: redmine
host: localhost
username: root
password: 123456
encoding: utf8
由於我們使用的是production,所以只關心這個就足夠了。 這裏對應上文中第9步，初始化redmine數據庫，如果在phpMyAdmin中看不到redmine的數據庫，就是這裏出問題了。
6、部署好，能夠正常訪問了，默認的管理員賬戶和密碼都是admin，所有新建賬號都需要通過管理員賬號激活才能正常使用。
