代码改变世界

在Windows下安装Redmine

2012-12-24 21:13 by 囧月, ... 阅读, ... 评论, 收藏, 编辑

最近在找一个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个字符串值:

  1. Application: D:\ruby\Ruby193\bin\Ruby.exe
  2. AppParameters: D:\ruby\Ruby193\bin\thin start -p 3000 -e production
  3. AppDirectory: D:/ruby/redmine-2.2.0/

如果不是用Thin,而是用webrick,那就添加2个字符串值:

  1. Application: D:\ruby\Ruby193\bin\Ruby.exe
  2. 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

升级

备份老的站点数据:

  1. 备份config目录下配置文件configuration.yml,database.yml
  2. 备份db目录下数据库redmine_production.sqlite3,schema.rb
  3. 备份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------