Redmine安裝和使用心得

最終目標(biāo)鎖定為兩個開源的項目管理系統(tǒng)，禪道和Redmine，兩個都很優(yōu)秀，而我的需求又非常簡單——能提交、追蹤、反饋bug就可以了，這兩個系統(tǒng)都是可以勝任的。雖然這篇文章講解的是Redmine的安裝和使用心得，但是對于多數(shù)用戶，可能禪道是更好的選擇，因為它兼具bug管理功能的同時，更偏重于項目管理，最重要的是，它的安裝非常簡單，幾乎是一鍵搞定。 而Redmine的安裝部署絕對不是一鍵簡單的工作。

   首先要準(zhǔn)備Ruby相關(guān)文件，Redmine是基于Ruby on rails開發(fā)的。

   1、下載railsinstaller，我這時下載的版本是railsinstaller-2.2.1.exe，對應(yīng)的官網(wǎng)：http://railsinstaller.org/en railsinstaller大大簡化了rails的安裝。除了windows下面的外，還有iMac下面的安裝包。

2、下載wamp，集成了apache,MySQL,php，使用非常方便。對應(yīng)的官網(wǎng)是：http://www.wampserver.com/en/

  網(wǎng)站部署一般都需要wamp，也就是windows+apache+mysql+php的環(huán)境。流行的集成環(huán)境有兩個wampserver和xampp，這里使用的是wampserver

3、下載ImageMagick，這個是圖型生成工具，redmine用于生成pdf等內(nèi)容，也可以不安裝。這個東西我安裝的時候有些問題，所以沒有安裝。

4、redmine的源文件，這里下載的是redmine2.3.3 ,發(fā)布版本下載列表地址是：http://rubyforge.org/frs/?group_id=1850

安裝文件準(zhǔn)備好后，就可以開始安裝了。

1、安裝railsinstaller，如果不需要選擇目錄，就一路安裝下去就可以了

2、安裝wamp，先安裝vc2010的環(huán)境vcredist_x86.exe, 再安裝wamp,如果不需要選擇目錄，就一路安裝下去就可以了

   3、把redmine解壓到c:\redmine（你可以自己解壓目錄）

4、安裝ruby下的mysql2，這里使用的是wamp中的mysql，我這里wamp是默認(rèn)安裝，也就是安裝在c:\wamp目錄下面，那邊在這里，mysql的目錄是C:\wamp\bin\mysql\mysql5.6.12。將C:\wamp\bin\mysql\mysql5.6.12\lib下的libmysql.dll和libmysqld.dll復(fù)制到c:\windows\system32中

    進(jìn)入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對應(yīng)的頭文件和庫文件目錄，否則會安裝失敗。輸入gem list就可以看到mysql2對應(yīng)的版本號

5、配置數(shù)據(jù)庫 運(yùn)行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, 這樣就可以局域網(wǎng)對mysql操作了。

我這里的ip是192.168.1.30,在瀏覽器地址欄輸入http://192.168.1.30/phpmyadmin/，這樣就可以進(jìn)入phpmyadmin操作了，這里root默認(rèn)是沒有密碼，所以，先修改root的密碼為helloredmine，（你自己實際情況調(diào)整）

6、準(zhǔn)備redmine數(shù)據(jù)庫

在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的數(shù)據(jù)庫

在c:\redmine\config目錄下，復(fù)制database.yml.example為database.yml，然后編輯它，來配置。

找到production項，并配置，配置如下：（因為都是默認(rèn)，在這里只要配置密碼就可以了）

production:

adapter: mysql2

database: redmine

host: localhost

username: root

password: 123456

encoding: utf8

8、安裝redmine    在dos命令提示下，我們進(jìn)入到c:\redmine目錄 然后執(zhí)行

bundle install –without development test postgresql sqlite

注意：如果在安裝過程，有可能因為網(wǎng)絡(luò)的問題，造成個別的安裝不了，那就用gem install xxxxx來安裝指定的，安裝完成后，再執(zhí)行上面的bundle install命令。直到安裝完成。

安裝成功結(jié)果如下

然后再輸入rake generate_secret_token，設(shè)置sessiond加密存貯

9、初始化redmine的數(shù)據(jù)庫    在DOS命令提示符下面，輸入下面的命令

set RAILS_ENV=production

rake db:migrate

再輸入下面的命令，這里會設(shè)置默認(rèn)語言

set RAILS_ENV=production

set REDMINE_LANG=zh

rake redmine:load_default_data

如下圖，則表示完成

10、運(yùn)行  在DOS命令提示符下，輸入：ruby script/rails server webrick -e production

安裝成功，然后在瀏覽器，輸入

http://192.168.1.30:3000

就可以看到redmine的主頁了，初始管理員的賬號是admin，密碼是admin，然后就可以進(jìn)去玩了。到這里就安裝完成。如果還需要配置email和svn，請參與官網(wǎng)提示的安裝指南 http://www.redmine.org/projects/redmine/wiki/RedmineInstall

一些常見問題的補(bǔ)充說明：

如果運(yùn)氣足夠好的話，你可以從第一步一路順暢的走到第十步。下面是我碰到的一些問題。

1、gem install mysql2 的時候可能因為網(wǎng)絡(luò)問題，沒有安裝成功。 多試幾次就可以了。

2、正常來說WAMP Server的系統(tǒng)托盤圖標(biāo)應(yīng)該是綠色的。如果不是的話，可能是某些服務(wù)開啟失敗了。最常見的可能是80端口沖突導(dǎo)致apache服務(wù)啟動失敗。我碰到的情況是因為我之前安裝過xamp，所以兩個apache沖突了。 刪掉xamp后就正常了。 要想刪掉xamp需要先關(guān)閉所有的相關(guān)服務(wù)。

3、mysql的默認(rèn)是沒有密碼的。可以通過登陸mysql控制臺，然后使用sql語句修改密碼

   mysql> use mysql;

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

  其中123456就是新的密碼。這里要注意sql語句最后的分號不要漏掉。 并且sql執(zhí)行可能出現(xiàn)失敗的情況，多試幾次。

4、修改完mysql密碼后，php對應(yīng)的登陸密碼也要修改，否則提示訪問被拒絕。配置文件的路徑是

   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對應(yīng)上述mysql用戶名的密碼

5、redmine的mysql登陸密碼配置文件路徑是

C:\redmine\config\database.yml

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

由于我們使用的是production,所以只關(guān)心這個就足夠了。 這里對應(yīng)上文中第9步，初始化redmine數(shù)據(jù)庫，如果在phpMyAdmin中看不到redmine的數(shù)據(jù)庫，就是這里出問題了。

6、部署好，能夠正常訪問了，默認(rèn)的管理員賬戶和密碼都是admin，所有新建賬號都需要通過管理員賬號激活才能正常使用