為food項目配置了項目管理平臺,綜合了trac、dotProject、Redmine等幾個開源平臺,最終選擇了Redmine。項目主頁 http://www.redmine.org
下面是安裝方法:
一、Redmine安裝。
1、準備
安裝之前請閱讀:RailsInstaller簡化了Rails在Windows上的安裝過程
英文原文:RailsInstaller Provides Easy Rails on Windows Installation
作者:Rob Bazinet 譯者:張龍
RailsInstaller向Windows開發者提供了一種便捷的方式以輕松、快速創建Ruby on Rails 3應用。到目前為止,Windows開發者需要自己搭建好Ruby、RubyGems、Rails以及SQLite才能開始創建Rails應用。多虧了來自Engine Yard的Nic Williams博士及其團隊,現在一切都變得簡單異常。
目前的RailsInstaller提供了如下功能:
- 通過向導的輕松安裝
- Rails 3.0.3
- Ruby 1.8.7——p330
- SLQite 3.7.3
- Git 1.7.3.1
- DevKit
2、安裝
注意:下面的操作要在聯網的情況下進行。
轉自:http://www.cppblog.com/giigie/archive/2011/07/31/152160.html
最近在一家公司實習。公司用的項目管理軟件是開源的redmine,體驗非常不錯。我想這個東西不僅可以用來管理項目,也可以用來管理個人的學習工作進展啊。于是,我也在自己的虛擬機的2003 server 下安裝。
之前為了安裝wordpress,我已經在我的電腦上安裝了 xampp。這是一個搭建服務器環境的傻瓜式安裝包,里面集成了apache,php,mysql,phpMyAdmin,FileZilla FTP Server,Tomcat,這些組件可以選擇安裝。.
因為redmine是需要apache 和mysql的,所以正好。此外,redmine使用ruby寫的,所以還需要ruby的環境。
配置ruby 的環境我選用的是railsinstaller 。
之前我在網上搜索安裝redmine 的教程,配置ruby環境大多是用InstantRails。我實際用了一下,效果不太好。因為InstantRails從2007年開始就沒有更新了,里面包含的很多組件版本都很舊,直接搭建的話需要升級各種組件,而且組件之間的依賴關系比較混亂,反正我是在里面繞了很多彎路。而且InstantRails 里面自帶有很低版本的apache,mysql,phpMyAdmin,如果你電腦本來安裝了這些,那么又要改這些服務的端口和對應的配置文件。總之一句話,InstantRails 已經過時了。
好了,現在開始進入正題吧。
1.去redmine的官方網站下載 redmine 的最新版本。我下載的的是redmine 1.2.1.然后弄清楚這個版本的需要的環境。Redmine 的網站的Guide » Installation Guide » 會清楚的告訴你這些事項的。
2.如果你的電腦上還沒有apache ,php,mysql 建議你去下載xampp,如果有的話,跳過這步。
3.去railsinstaller 的官方網站去下載最新版的railsinstaller 。看它所包含的組件以及其版本。然后安裝。
4.做好這些準備工作了。就可以開始配置redmine運行環境了。把redmine的解壓到railsinstaller所產生的sites目錄。在dos窗口進入sites\redmine目錄下。
5.gem install rails -v=2.3.11 安裝rails 2.3.11版本,這個redmine 1.2.1所要求的。
6.gem install rack -v=1.1.1 安裝rack 1.1.1版本,這個redmine 1.2.1所要求的。
7.gem install -v=0.4.2 i18n 這個根據安裝時返回的錯誤命令提示來決定。比如的我就是提示Missing the i18n 0.4.2 gem. Please `gem install -v=0.4.2 i18n`
8.進入phpMyAdmin 創建數據庫。執行以下三條sql 語句。
create database redmine character set utf8;
create user 'redmine'@'localhost' identified by 'my_password';
grant all privileges on redmine.* to 'redmine'@'localhost';
9.拷貝config/database.yml.example文件到config/database.yml,修改database.yml的內容 production:
adapter: mysql
database: redmine
host: localhost
username: redmine
password: my_password
Username 和password字段就是自己要設置的數據庫的賬號和密碼。
10.回到dos 窗口下,設置Session Key,執行 rake generate_session_store
如果提示 mysql 錯誤,再執行如下語句 gem install mysql
11.然后set RAILS_ENV=production
rake db:migrate
rake redmine:load_default_data
執行rake load_default_data RAILS_ENV="production" 完后,會提示Select language: bg, bs, ca, cs, da, de, el, en, en-GB, es, eu, fi, fr, gl, he, hr, hu, id, it, ja, ko, lt, lv, mn, nl,no, pl, pt, pt-BR, ro, ru, sk, sl, sr, sr-CY, sv, th, tr, uk, vi, zh, zh-TW [en] zh
輸入zh選擇中文
12.最后ruby script/server webrick -e production 啟動。以后每次開機后都需要這句來啟動。
13.打開瀏覽器 輸入 http://localhost:3000 。賬號,密碼都是 admin 。
14.安裝完了,就可以使用admin用戶登錄,密碼也是admin,登入后,發現頁面又變成了英文的,在這里要設置個人用戶,修改語言為中文就可以了。然后進入管理頁面,可以管理項目,用戶,角色,權限,問題狀態,跟蹤類型,流程等。
上面的步驟是比較順利的,如果是組件的版本有問題,這篇博客比較有價值http://like-eagle.iteye.com/blog/847218。
如果還有問題,你可以根據問題的提示去google.
下面我簡單翻譯一下redmine 1.2.1 官方的安裝向導。(僅 windows 平臺)
官方發行版已經在其 vendor 目錄包含了適當的Rails 版本,所以不需要為此做什么。
你也可以查看redmine 的版本,運行一下命令特地的為它安裝某個版本的組件:
gem install rails -v=2.3.11
安裝rack
gem install rack -v=1.1.0
兼容性提示
· Ruby 1.9 版本目前還不支持,但你必須安裝ruby 1.8.x 以上的版本。
· RubyGems 1.3.7 或者更高版本有以下限制 :
o Rails 2.3.5 與rubygems 1.5.0或者更高的版本工作會失敗,請使用rubygems的更早的版本!
o Rails 2.3.11 與rubygems 1.7.9或者更高版本工作會失敗,請使用rubygems更早的版本 !
· 需要Rake 0.8.7 (rake 0.9.x 尚未被 Rails 支持)
· 需要Rack1.1.x , 1.1.0 版本有引用 (#8416)所描述的bug. 同其他版本的遷移會失敗.
· Mongrel1.1.5 需要補丁 #7688 才能和 Rails 2.3.11工作. 在升級的情況下,其他問題可能會出現 (#7857).
· Redmine >= 1.0.5版本需要I18n 0.4.2
數據庫
· 需要mysql 5.0或者更高的版本。MySQL 5.0 or higher (建議)
安裝步驟
1.獲得redmine 的源代碼或者發行包。參見 Download.
2.用mysql 創建一個空的數據庫和一個名為 redmine的用戶,例如:
create database redmine character set utf8;
create user 'redmine'@'localhost' identified by 'my_password';
grant all privileges on redmine.* to 'redmine'@'localhost';
對于mysql 5.0.2 的版本 跳過create user ,用這個代替grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'my_password';
3.復制Copy config/database.yml.example改為 config/database.yml ,編輯文件配置數據庫設置。例如mysql:
production:
adapter: mysql
database: redmine
host: localhost
username: redmine
password: my_password
如果服務器沒有工作在3306端口,用下面的配置代替:
production:
adapter: mysql
database: redmine
host: localhost
port: 3307
username: redmine
password: my_password
4.生成會話密鑰:
rake generate_session_store
5.創建數據庫:
AILS_ENV=production rake db:migrate
這將創建一個管理員賬戶。
如果你得到以下錯誤:
Rake aborted!
no such file to load -- net/https
你需要安裝libopenssl-ruby1.8
6.向數據庫插入默認的配置數據
RAILS_ENV=production rake redmine:load_default_data
7.運行使用ruby script/server webrick -e production命令
配置:
從1.2.0版本開始,redmine的配置都在config/configuration.yml文件里。不要忘記修改了默認配置都需要重啟服務。
Window 用戶的特別提醒
RAILS_ENV=production rake db:migrate
RAILS_ENV=production rake redmine:load_default_data
等命令已經變成了
set RAILS_ENV=production
rake db:migrate
rake redmine:load_default_data
如果你需要安裝mysql ,使用如下命令:
gem install mysql
在一些情況下,你需要復制libmysql.dll到你的ruby/bin目錄,但不是所有的libmysql.dll 都適合,請參考
http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll
二、Redmine集成SVN
參考http://www.cnblogs.com/Quincy/archive/2011/06/03/2070479.html
進入Redmine目錄下Config,有文件“configuration.yml.example”,復制該文件重命名“configuration.yml”,修改其中的SVN配置
scm_subversion_command: svn # (default: svn),
這里需要設置在環境變量PATH中添加svn所在的目錄
再重啟服務器,配置SCM,選用SVN設置庫路徑,就可以看到代碼了。
三、Redmine配置上傳文件存儲地址、郵件服務器等
參考上步,在這個文件中有相應的配置選項。
注意:configuration.yml 中無用的項不用寫,有嚴格的格式
下面這兩句是一個配置例子:
default:
attachments_storage_path: D:\RedmineFiles
scm_subversion_command: svn
四、Redmine以windows服務方式啟動
參考 http://bufeifang.blog.163.com/blog/static/558981512009421113134391/
Redemine的啟動是用命令行執行的,在Redmine根目錄下執行:ruby script/server -e production即可,但是執行后不能關閉控制臺,不然服務就會關閉,這對于重啟服務器來說是一件很麻煩的事情,每次都要手動啟動Redmine;
既然Windows有服務,可自啟,那就安裝成服務,安裝步驟如下:
A、先安裝mongrel_service,在在C:\InstantRails\ruby\bin目錄下運行:gem install mongrel_service,此過程中會下載一些其他必須的包;
B、使用mongrel_service將Redmine安裝為服務:mongrel_rails service::install -N RedMine -c C:\redmine -p 3000 –e production;C:\redmine是具體的目錄,參考修改;
C、安裝服務后,查看-e后的參數是不是production,如果不是production而是development,則在注冊表中把參數手動改為production即可,修改方法是:在“開始→運行”中鍵入“regedit.exe”,打開“注冊表編輯器”,展開分支“HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services”,在下面都是系統服務的名稱,右側窗格中顯示的就是服務的詳細參數。找到ImagePath項,修改保存后在服務列表中啟動服務,并把服務設置自動啟動。
然后修改啟動方式為自動啟動,并添加MySQL服務為其依賴服務(如果你的MySQL服務器不是本機就不用麻煩了):
sc config RedMine start= auto depend= MySQL
注意:上面命令=后有一個空格。
注意,執行sc config系列指令,服務必須是未啟動的才行,否則會出錯。
將來如果想去掉這個服務,只要執行:
mongrel_rails service::remove -N RedMine
五、Redmine服務方式不能正常運行bug補丁
注意:
補丁(很重要)
上面第四步操作完以后,Redmine并不能正常運行,log中有這日志
A NoMethodError occurred in account#login
參見 http://www.redmine.org/issues/7857
解決辦法:
Hi everybody, we are trying to upgrade to 1.2 and we are having both problems here described... the problem is that after applying what here is detailed... there is no way... problems still remain.
Please, let me know if I'm missing something or doing something wrong!!):
Thx in advance
由 Etienne Massip
- mongrel.rb is mandatory to get mongrel 1.1.5 work with RoR 2.3.11. It's the only patch I'm actually running with.
- patch_for_mongrel.rb might be useful for a sub-URL Redmine setup ?
- rails_6440_patch.rb might be useful at start to prevent the hereby discussed issue (maybe only in case of a Redmine upgrade) but can be remove after some time
由 Alfredo Bonilla
Thanks for clarifications. As I commented in http://www.redmine.org/issues/7688, our problem was not having installed the mongrel gems. Once installed, just with mongrel.rb in /config/initializers, everything is working. :)