Windows下安装Redmine
为food项⽬配置了项⽬管理平台,综合了trac、dotProject、Redmine等⼏个开源平台,最终选择了Redmine。Redmine主页
本⽂介绍,以及最后的bug补丁,仅针对Redmine 1.2.1版本,不能确定后续版本是否需要同样操作。欢迎留⾔反馈。
==
下⾯是安装⽅法:
⼀、Redmine安装。
1、准备
安装之前请阅读:
英⽂原⽂:
作者:Rob Bazinet 译者:张龙
向Windows开发者提供了⼀种便捷的⽅式以轻松、快速创建Ruby on Rails 3应⽤。到⽬前为⽌,Windows开发者需要⾃⼰搭建好Ruby、RubyGems、Rails以及SQLite才能开始创建Rails应⽤。多亏了来⾃的Nic Williams博⼠及其团队,现在⼀切都变得简单异常。
⽬前的RailsInstaller提供了如下功能:
通过向导的轻松安装
Rails 3.0.3
Ruby 1.8.7——p330
SLQite 3.7.3
Git 1.7.3.1
DevKit
2、安装
注意:下⾯的操作要在联⽹的情况下进⾏。
转⾃:
最近在⼀家公司实习。公司⽤的项⽬管理软件是开源的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 的⽹站的 » »会清楚的告诉你这些事项的。
2.如果你的电脑上还没有apache ,php,mysql 建议你去下载xampp,如果有的话,跳过这步。
3.去railsinstaller 的官⽅⽹站去下载最新版的railsinstaller 。看它所包含的组件以及其版本。然后安装。
4.做好这些准备⼯作了。就可以开始配置redmine运⾏环境了。把redmine的解压到railsinstaller所产⽣的sites⽬录。在dos窗⼝进⼊
sites\redmine⽬录下。
< install rails -v=2.3.11        安装rails 2.3.11版本,这个redmine 1.2.1所要求的。
< install rack -v=1.1.1          安装rack 1.1.1版本,这个redmine 1.2.1所要求的。
< 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.拷贝l.example⽂件到l,修改l的内容 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.打开浏览器输⼊。账号,密码都是 admin 。
14.安装完了,就可以使⽤admin⽤户登录,密码也是admin,登⼊后,发现页⾯⼜变成了英⽂的,在这⾥要设置个⼈⽤户,修改语⾔为中⽂就可以了。然后进⼊管理页⾯,可以管理项⽬,⽤户,⾓⾊,权限,问题状态,跟踪类型,流程等。
上⾯的步骤是⽐较顺利的,如果是组件的版本有问题,这篇博客⽐较有价值。
如果还有问题,你可以根据问题的提⽰去google.
下⾯我简单翻译⼀下redmine 1.2.1 官⽅的安装向导。(仅 windows 平台)
官⽅发⾏版已经在其 vendor ⽬录包含了适当的Rails 版本,所以不需要为此做什么。
你也可以查看redmine 的版本,运⾏⼀下命令特地的为它安装某个版本的组件:
gem install rails -v=2.3.11
安装rack
gem install rack -v=1.1.0
安装mysql失败兼容性提⽰
· 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 版本有引⽤ ()所描述的bug. 同其他版本的迁移会失败.
· Mongrel1.1.5 需要补丁才能和 Rails 2.3.11⼯作. 在升级的情况下,其他问题可能会出现 ().
·  Redmine >= 1.0.5版本需要I18n 0.4.2
数据库
· 需要mysql 5.0或者更⾼的版本。MySQL 5.0 or higher (建议)
安装步骤
1.获得redmine 的源代码或者发⾏包。参见 .
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 l.example改为 l ,编辑⽂件配置数据库设置。例如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的配置都在l⽂件⾥。不要忘记修改了默认配置都需要重启服务。
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 都适合,请参考
⼆、Redmine集成SVN
参考
进⼊Redmine⽬录下Config,有⽂件“ample”,复制该⽂件重命名“l”,修改其中的SVN配置
scm_subversion_command: svn                                      # (default: svn),
这⾥需要设置在环境变量PATH中添加svn所在的⽬录
再重启服务器,配置SCM,选⽤SVN设置库路径,就可以看到代码了。
三、Redmine配置上传⽂件存储地址、邮件服务器等
参考上步,在这个⽂件中有相应的配置选项。
注意:l 中⽆⽤的项不⽤写,有严格的格式
下⾯这两句是⼀个配置例⼦:
default:
attachments_storage_path: D:\RedmineFiles
scm_subversion_command: svn
四、Redmine以windows服务⽅式启动
参考
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即可,修改⽅法是:在“开始→运⾏”中键⼊“”,打开“注册表编辑器”,展开分
⽀“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
参见
解决办法:
Hi everybody, we are trying to upgrade to 1.2 and we are having both problems the problem is that after applying what here there is problems still remain.
Please, let me know if I'm missing something or doing something wrong!!):
Copy mongrel.rb (), patch_for_mongrel.rb () and rails_6440_patch.rb () files in /<my-redmine-path>/config/initializers
Thx in advance
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
Thanks for clarifications. As I commented in , our problem was not having installed the mongrel gems. Once installed, just with mongrel.rb in /config/initializers, everything is working. :)
六、Q&A
1、Redmine Sprints 插件官⽅主页
- by -

版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。