最近在找一个bug跟踪工具,找了很多文章,找到了一些比较好的工具比如:Trac、Bugzilla、Redmine、JIRA等。
只是比较失望的是没有一个是asp.net开发的,要不然就可以省去许多折腾了;因部署难度以及免费等因素,最终选择了Redmine。
Redmine官方主页:http://www.redmine.org/projects/redmine
安装过程
1.安装运行环境
下载RubyInstaller:http://rubyinstaller.org/downloads/
下载DevKit:https://github.com/downloads/oneclick/rubyinstaller/DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe (ruby 2.0以下) ruby 2.0以上版本则下载对应的32位或64位的DevKit-mingw64-(32/64)....exe
下载RubyGems:http://rubygems.org/pages/download
1.1.安装RubyInstaller
1.2.解压RubyGems,再使用Ruby命令行工具切换到RubyGems目录安装(安装完之后RubyGems目录可以删除):
ruby setup.rb
以后可以用gem update --system来更新RubyGems
在安装好所有gem包之后,还可以用gem update来更新所有gem包
注意:很多时候可能访问不上rubygems.org,导致无法安装gem或者安装非常慢,所以可以用淘宝的镜像来替代官方源再执行以上gem安装/更新操作:
gem sources --remove https://rubygems.org/ gem sources -a http://ruby.taobao.org/
更新了gem包之后,可以用gem cleanup来清除所有包的旧版本(只保留最新版本)
通过gem list可以查看安装的所有包
1.3.安装bundler:
gem install bundler
1.4.解压DevKit,再使用Ruby命令行工具切换到DevKit目录安装:
ruby dk.rb init ruby dk.rb install
如果觉得以上步骤麻烦的,也可以直接安装RailsInstaller了事,我为了安装最新的Ruby版本所以采用以上步骤。
RailsInstaller下载地址:http://railsinstaller.org/
2.安装Rake及Rails
gem install rake gem install rails
在安装的过程中应该会显示安装i18n,即语言包,如果没有提示的话也可以通过以下命令安装:
gem install i18n
3.安装RMagick
首先,到http://rubyforge.org/projects/rmagick下载rmagick-win32里面的包RMagick-2.12.0-ImageMagick-6.5.6-8-Q8.zip
解压后安装ImageMagick-6.5.6-8-Q8-windows-dll.exe,这里我安装到D:\ImageMagick,注意选中Install…C and C++。
安装完之后,重新打开一个Ruby命令行工具来安装rmagick:
gem install rmagick
若是提示失败则用:
gem install rmagick --platform=ruby -- "--with-opt-include=D:/ImageMagick/include" "--with-opt-lib=D:/ImageMagick/lib"
如果还是失败就用:
gem install rmagick --platform=ruby -- "--with-opt-dir=D:/ImageMagick"
这样就安装上了rmagick 2.1.3(最新版本的Redmine如2.1.5、2.2.0都依赖rmagick 2.1.3而不是2.1.2)
4.安装Redmine
通过http://www.redmine.org/projects/redmine/wiki/Download里的任一种方法下载Redmine
也可以直接从http://rubyforge.org/frs/?group_id=1850下载,我使用的是最新的2.2.0版本
打开Ruby命令行工具,切换到Redmine的目录来检查依赖包:
bundle install --without development test
这样会检查到未安装的包,自动下载安装;without参数就是用于忽略一些gem包,假如rmagick安装不成功,那也可以这样:
bundle install --without development test rmagick
跳过rmagick的安装;我这里只使用SQLite数据库,所以把另外2个数据库也跳过了:
bundle install --without development test postgresql mysql2
在运行的时候可能还会出现sqlite3/sqlite3_native (LoadError),那么还需要下载sqlite3的源码以及dll(http://www.sqlite.org/download.html),并按以下目录存放
include sqlite3.h sqlite3ext.h lib shell.c sqlite3.c sqlite3.def sqlite3.dll
然后再重新安装sqlite3:
gem uninstall sqlite3 gem install sqlite3 --platform=ruby -- "--with-sqlite3-include=F:/Ruby/sqlite3/include --withsqlite3-lib=F:/Ruby/sqlite3/lib"
5.配置Redmine
打开Redmine的config目录,把database.yml.example复制一份并重命名为database.yml,找到其中的production节点配置数据库:
production: adapter: sqlite3 database: db/redmine_production.sqlite3
这是我使用的SQLite数据库配置。
接下来配置邮件发送,把configuration.yml.example复制一份并重命名为configuration.yml,找到default下的email_delivery:
default: # Outgoing emails configuration (see examples above) email_delivery: delivery_method: :smtp smtp_settings: address: smtp.sina.com port: 25 domain: sina.com authentication: :login user_name: "lwme的用户名@sina.com" password: "lwme的密码"
以上使用新浪的邮箱作为例子,这个配置好以后,之后进入系统设置可能还要设置一下发送邮件的邮件地址。
6.生成Session Key
打开Ruby命令行工具,切换到Redmine站点根目录运行:
rake generate_secret_token
7.生成数据库结构
打开Ruby命令行工具,切换到Redmine站点根目录运行:
set RAILS_ENV=production rake db:migrate
8.载入默认数据
打开Ruby命令行工具,切换到Redmine站点根目录运行:
set RAILS_ENV=production set REDMINE_LANG=zh rake redmine:load_default_data
运行Redmine
直接运行(WEBrick)
打开Ruby命令行工具,切换到Redmine站点根目录运行:
ruby script/rails server webrick -e production -p 3000
以上命令使用webrick把Redmine运行在http://localhost:3000,稍等一会就可以通过浏览器打开访问,默认的用户名密码都是admin
直接运行(Thin)
在局域网中使用过程中,发现webrick巨慢无比,网上有说用mongrel,但是发现mongrel已经很久没有更新,所以最终使用了Thin
首先,安装Thin包:
gem install thin
接着,需要在Gemfile加入:
gem "thin"
然后,打开Ruby命令行工具,切换到Redmine站点根目录运行:
thin start -p 3000 -e production
同样的也是在3000端口运行
作为系统服务运行
我这里使用的是Windows Server 2003,需要用到工具Windows NT Resource Kit:http://www.microsoft.com/downloads/details.aspx?familyid=9d467a69-57ff-4ae7-96ee-b18c4790cffd&displaylang=en,下载并安装它
添加一个名为Redmine的服务:
"C:\Program Files\Windows Resource Kits\Tools\INSTSRV.EXE" Redmine "C:\Program Files\Windows Resource Kits\Tools\SRVANY.EXE"
接着打开注册表,定位到HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Redmine,然后在Redmine下新建一个项,名为“Parameters”
打开Parameters节点,在右边的视图分别添加3个字符串值:
- Application: D:\ruby\Ruby193\bin\Ruby.exe
- AppParameters: D:\ruby\Ruby193\bin\thin start -p 3000 -e production
- AppDirectory: D:/ruby/redmine-2.2.0/
如果不是用Thin,而是用webrick,那就添加2个字符串值:
- Application: D:\ruby\Ruby193\bin\Ruby.exe
- AppParameters: D:/ruby/redmine-2.2.0/script/rails server webrick -e production -p 3000
然后在系统服务里把它设置为自动并启动它。
对于不是windows server 2003系统的,可以试试thin_service:
gem install thin_service
使用方法通过下面命令来了解:
thin_service install --help thin_service remove --help
使用方法估计与mongrel_service差不多,mongrel_service是这样:
mongrel_rails service::install -N D:\ruby\redmine-2.2.0 -p 3000 -e production
thin_service安装服务的方法可能会是(未验证):
thin_service install -N D:\ruby\redmine-2.2.0 -p 3000 -e production
升级
备份老的站点数据:
- 备份config目录下配置文件configuration.yml,database.yml
- 备份db目录下数据库redmine_production.sqlite3,schema.rb
- 备份files目录下的上传的文件
下载新的版本,然后在新的站点根目录下运行命令重新检查一下依赖包:
bundle install --without development test postgresql mysql2
把以上备份的文件放到新的站点目录
生成session key:
rake generate_secret_token
升级数据库:
rake db:migrate RAILS_ENV=production
清理缓存和会话:
rake tmp:cache:clear rake tmp:sessions:clear
参考
官方安装指南:http://www.redmine.org/projects/redmine/wiki/RedmineInstall
官方升级指南:http://www.redmine.org/projects/redmine/wiki/RedmineUpgrade
服务安装:http://www.redmine.org/boards/2/topics/30741
最后,额外说一下,如果需要创建Git版本库,需要安装git包:
gem install git
然后git库和redmine是同一台机器的话,就可以在项目设置里把git目录设置为git库地址如:d:\repo\myproj…
如果在配置里提示Git不可用的话,还得设置configuration.yml中的scm_git_command: git安装目录\bin\git.exe
------EOF------