Redmine安裝完全圖文指南

蝸牛之窩 2012-03-04

展開全文

原文出處：http://www.cnblogs.com/espie/archive/2011/05/01/2034135.html

這篇博文主要參考了如下文章：

http://www./projects/redmine/wiki/RedmineInstall

http://xinlanzero./blog/857494

有關(guān)BUG的疑難解答主要參考：

http://www./boards/2/topics/22358

http://www./issues/7516

http://www./boards/2/topics/6423?r=6447

http:///blog/2010/03/192/

安裝準(zhǔn)備

先下載下面這些安裝過程中要用到的軟件，如上圖所示：

1. Ruby 1.8.7：http:///frs/download.php/74293/rubyinstaller-1.8.7-p334.exe

2. MySQL：http://www./downloads/mysql/5.5.html#downloads

3. Redmine 主程序：http://www./projects/redmine/wiki/Download

4. Win32 OpenSSL Light：
http://www./download/Win32OpenSSL_Light-1_0_0d.exe

5. Visual C++ 2008 Redistributables ：
http://www.microsoft.com/downloads/details.aspx?familyid=9B2DA534-3E03-4391-8A4D-074B9F2BC1BF&displaylang=en (如果不安裝這個，調(diào)用 OpenSSL 時可能會報“應(yīng)用程序配置不正確，程序無法啟動，重新安裝應(yīng)用程序可能解決問題?！卞e誤)

6. ZLib 1.2.5： http://www./zlib125-dll.zip (這個地址貌似失效了……那我這個版本哪里來的……汗……那就試試這個吧：http://ishare.iask.sina.com.cn/f/9662774.html)

7. libiconv 1.9.2： http:///projects/gnuwin32/files/libiconv/ (運行 rake 時要用到)

安裝與配置

安裝Ruby

1. 安裝Ruby運行環(huán)境（rubyinstaller-1.8.7-p334.exe），如上圖

2. 注意在安裝過程中，勾選如上兩項

3. 開始安裝，直至安裝完成。

4. 運行開始菜單中的“Start Command Prompt with Ruby”，打開Ruby命令行

5. 輸入如下命令，安裝Rails框架：

gem install rails -v=2.3.5

Ruby會連接網(wǎng)絡(luò)下載Rails框架文件及文檔，并自動開始安裝。此過程時間較長，約10分鐘左右。如上圖所示。如沒有報錯信息，則繼續(xù)下一步安裝。

6. 輸入如下指令，安裝Rake：

gem install rack -v=1.0.1

7. 輸入如下指令，安裝MySQL的C bindings：

gem install mysql

該命令將在線安裝 MySQL 的 C bindings，可明顯提高訪問數(shù)據(jù)庫的性能

安裝MySQL

1. 運行mysql-5.5.9-win32.msi開始安裝，如上圖所示

2. 安裝完成，使用“MySQL Instance Configuration Wizard”，開始配置MySQL，如上圖所示

選擇詳細(xì)配置，以調(diào)整參數(shù)，如上圖

選擇服務(wù)器環(huán)境，MySQL會合理利用現(xiàn)有內(nèi)存；如果是自己機器上安裝，那可以選擇開發(fā)者機器環(huán)境，這樣不會占用太多資源。

開啟TCP/IP網(wǎng)絡(luò)，設(shè)置合理的數(shù)據(jù)庫端口，如上圖。

這里要選擇手動設(shè)置默認(rèn)字符集：UTF8，如上圖。

這里要勾選“安裝為Windows服務(wù)”，以及“包含在windows Path環(huán)境變量中添加BIN目錄”，如上圖。

設(shè)置服務(wù)器默認(rèn)管理員密碼。如上圖。

配置完成后，系統(tǒng)開始進行配置，順利的話將顯示上圖結(jié)果頁面。

3. 打開Windows命令行，切換到Mysql安裝目錄下的Bin目錄（我是個小白，但這個切換就不用多講了吧？），之后使用如下命令進入MySQL命令行：

Mysql –u root -p

回車后，輸入服務(wù)器密碼，登錄mysql。之后命令行提示符將切換為”mysql>”，代表登錄成功

4. 在 MySQL 命令行模式下運行如下命令，創(chuàng)建Redmine數(shù)據(jù)庫：

create database redmine character set utf8;

回車后，該命令將創(chuàng)建一個供 Redmine 使用的數(shù)據(jù)庫。

PS：Mysql數(shù)據(jù)庫命令行最后要以“;”結(jié)尾，才能執(zhí)行。如果你沒接觸過MySQL這一點很關(guān)鍵：P（因為我就是被這個卡住了）

5. 創(chuàng)建Redmine數(shù)據(jù)庫的用戶及密碼，并賦予權(quán)限：（’’引號之間需修改為自己的用戶名、服務(wù)器名、密碼）

create user 'redmine'@'localhost' identified by 'my_password';

無錯誤提示，則表示創(chuàng)建成功。

下面進行賦權(quán)操作：

grant all privileges on redmine.* to 'redmine'@'localhost';

PS：如果創(chuàng)建用戶出了什么差錯，可以使用如下命令刪除用戶：

drop user 'redmine'@'localhost';

安裝OpenSSL并配置Ruby

1. 安裝 Visual C++ 2008 Redistributables

2. 安裝 Win32 OpenSSL Light 。如上圖

3. 注意在本頁選擇“ Copy OpenSSL DLLs to The Windows system directory ”

否則在安裝完畢后需要手工將 OpenSSL 安裝目錄下的 DLL 文件復(fù)制到 Windows 的系統(tǒng)目錄（例如： C:\Windows\system32 ），或 Ruby 的 bin 目錄（例如： C:\ruby-1.8.7\bin ）

4. 根據(jù)向?qū)瓿砂惭b。如上圖所示（呵呵，捐贈就不需要選擇了：P）

5. 將 ZLib 1.2.3 的安裝包中的 zlib1.dll 解壓到 Windows 的系統(tǒng)目錄或 Ruby 的 bin 目錄，并改名為 zlib.dll

6. 將 libiconv 1.9.1 的安裝包中的 bin\iconv.dll 解壓到 Windows 的系統(tǒng)目錄或 Ruby 的 bin 目錄（這一步可以不做）

安裝Redmine主程序

1. 將 Redmine 的安裝包解壓到某個目錄（例如： C:\redmine-0.9.1 ），將 config\database.yml.example 復(fù)制為 config\database.yml ，并修改該文件中的“ production ”段的數(shù)據(jù)庫配置。例如：

production:

adapter: mysql

database: redmine

host: localhost

username: root （這里填寫你希望用來登錄 MySQL 的用戶名）

password: password （這里填寫用戶密碼）

2. 將MySQL安裝目錄中的libmySQL.dll文件復(fù)制到Ruby安裝目錄下(如：C:\ruby-1.8.7\bin)，然后再Windows 命令行模式下切換目錄為 Redmine 的安裝目錄（如c:\redmine-1.1.1\），運行如下命令：

rake config/initializers/session_store.rb

如果出現(xiàn)上圖的錯誤提示，則需要下列語句，安裝一個國際化組件后再次執(zhí)行：

gem install –v=0.4.2 i18n

3. 使用如下命令創(chuàng)建數(shù)據(jù)庫結(jié)構(gòu)：

rake db:migrate RAILS_ENV="production"

該命令將創(chuàng)建生產(chǎn)用的數(shù)據(jù)庫結(jié)構(gòu)。這是關(guān)鍵的一步，筆者就在此處經(jīng)過多次嘗試后才安裝好Redmine，而且這一步可能遇到的問題較多。如果遇到其他問題可以到Redmine上搜索問題的描述，一般都有滿意的解答。

PS1：如果出現(xiàn)“Mysql::Error: The 'InnoDB' feature is disabled”錯誤，需要開啟MySql數(shù)據(jù)庫對InnoDB的支持，在你的mysql安裝文件夾中打開my.ini文件，找到skip-innodb，改成#skip-innodb，然后重啟mysql(注：可以通過MySQL命令show variables like "have_%";查看是否開啟了InnoDB)

PS2：如果出現(xiàn)了上圖所示的錯誤，則需要修改redmine安裝目錄\config\ environment.rb腳本。

打開environment.rb腳本后，在bootStrap和initialization之間添加如下語句：

#在bootStrap和initialization之間添加語句 --espie

if Gem::VERSION >= "1.3.6"

module Rails

class GemDependency

def requirement

r = super

(r == Gem::Requirement.default) ? nil : r

end

如上圖所示，之后保存退出。

PS3：