Redmine安裝和使用心得

最終目標鎖定爲兩個開源的項目管理系統，禪道和Redmine，兩個都很優秀，而個人需求又很是簡單——能提交、追蹤、反饋bug就能夠了，這兩個系統都是能夠勝任的。雖然這篇文章講解的是Redmine的安裝和使用心得，可是對於多數用戶，可能禪道是更好的選擇，由於它兼具bug管理功能的同時，更偏重於項目管理，最重要的是，它的安裝很是簡單，幾乎是一鍵搞定。 而Redmine的安裝部署絕對不是一鍵簡單的工做。

首先要準備Ruby相關文件，Redmine是基於Ruby on rails開發的。

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

二、下載wamp，集成了apache,MySQL,php，使用很是方便。對應的官網是：http://www.wampserver.com/en/

網站部署通常都須要wamp，也就是windows+apache+mysql+php的環境。流行的集成環境有兩個wampserver和xampp，這裏使用的是wampserver

三、下載ImageMagick，這個是圖型生成工具，redmine用於生成pdf等內容，也能夠不安裝。這個東西我安裝的時候有些問題，因此沒有安裝。

四、redmine的源文件，這裏下載的是redmine2.3.3 ,發佈版本下載列表地址是：http://rubyforge.org/frs/?group_id=1850

安裝文件準備好後，就能夠開始安裝了。

一、安裝railsinstaller，若是不須要選擇目錄，就一路安裝下去就能夠了

二、安裝wamp，先安裝vc2010的環境vcredist_x86.exe, 再安裝wamp,若是不須要選擇目錄，就一路安裝下去就能夠了

三、把redmine解壓到c:\redmine（你能夠本身解壓目錄）

四、安裝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對應的版本號

五、配置數據庫 運行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，（你本身實際狀況調整）

六、準備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’;

七、配置redmine的數據庫

在c:\redmine\config目錄下，複製database.yml.example爲database.yml，而後編輯它，來配置。

找到production項，並配置，配置以下：（由於都是默認，在這裏只要配置密碼就能夠了）

production:

adapter: mysql2

database: redmine

host: localhost

username: root

password: 123456

encoding: utf8

八、安裝redmine    在dos命令提示下，咱們進入到c:\redmine目錄 而後執行

bundle install –without development test postgresql sqlite

注意：若是在安裝過程，有可能由於網絡的問題，形成個別的安裝不了，那就用gem install xxxxx來安裝指定的，安裝完成後，再執行上面的bundle install命令。直到安裝完成。

安裝成功結果以下

而後再輸入rake generate_secret_token，設置sessiond加密存貯

九、初始化redmine的數據庫    在DOS命令提示符下面，輸入下面的命令

set RAILS_ENV=production

rake db:migrate

再輸入下面的命令，這裏會設置默認語言

set RAILS_ENV=production

set REDMINE_LANG=zh

rake redmine:load_default_data

以下圖，則表示完成

十、運行  在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

一些常見問題的補充說明：

若是運氣足夠好的話，你能夠從第一步一路順暢的走到第十步。下面是我碰到的一些問題。

一、gem install mysql2 的時候可能由於網絡問題，沒有安裝成功。 多試幾回就能夠了。

二、正常來講WAMP Server的系統托盤圖標應該是綠色的。若是不是的話，多是某些服務開啓失敗了。最多見的多是80端口衝突致使apache服務啓動失敗。我碰到的狀況是由於我以前安裝過xamp，因此兩個apache衝突了。 刪掉xamp後就正常了。 要想刪掉xamp須要先關閉全部的相關服務。

三、mysql的默認是沒有密碼的。能夠經過登錄mysql控制檯，而後使用sql語句修改密碼

mysql> use mysql;

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

其中123456就是新的密碼。這裏要注意sql語句最後的分號不要漏掉。 而且sql執行可能出現失敗的狀況，多試幾回。

四、修改完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用戶名的密碼

五、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的數據庫，就是這裏出問題了。

六、部署好，可以正常訪問了，默認的管理員帳戶和密碼都是admin，全部新建帳號都須要經過管理員帳號激活才能正常使用