Redmine安裝和使用心得

最終目標鎖定為兩個開源的項目管理系統，禪道和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

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

http://192.168.1.30:3000

就可以看到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，所有新建賬號都需要通過管理員賬號激活才能正常使用