Windows下Redmine 2.1.2安装和配置_20121105.doc

Windows下Redmine 2.1.2安装和配置
参考：
The required Ruby versions for a given Redmine version is:
Redmine version
Supported Ruby versions
Rails version used
Supported RubyGems versions
current trunk
ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7
Rails 3.2.8
RubyGems <= 1.8
2.1.0
ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7
Rails 3.2.8
RubyGems <= 1.8
2.0.3
ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7
Rails 3.2.6
RubyGems <= 1.8
2.0.2
ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7
Rails 3.2.5
RubyGems <= 1.8
2.0.0, 2.0.1
ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7
Rails 3.2.3
RubyGems <= 1.8
1.4.x
ruby 1.8.7, 1.9.2, 1.9.3, jruby-1.6.7
Rails 2.3.14
RubyGems <= 1.8
http://www.redmine.org/projects/redmine/wiki/RedmineInstall
准备：
redmine官网：http://www.redmine.org/
ruby官网：http://rubyforge.org/
1.       下载rubygems-1.8.24.zip，下载地址：
http://files.rubyforge.vm.bytemark.co.uk/rubygems/rubygems-1.8.24.zip
2.       下载redmine-2.1.2.zip ，下载地址：
http://www.redmine.org/projects/redmine/wiki/Download
3.       下载rails-ftw-v0.11-1.9.3-3.2.8.exe，下载地址：

4.       下载mysql-connector-c-noinstall-6.0.2-win32.zip
5.       下载DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe
6.       下载RMagick-2.12.0-ImageMagick-6.5.6-8-Q8.zip，下载地址：
http://files.rubyforge.vm.bytemark.co.uk/rmagick/RMagick-2.12.0-ImageMagick-6.5.6-8-Q8.zip
开始：
1. 安装rails-ftw-v0.11-1.9.3-3.2.8.exe
Next→I accept，Next→选择路径：D:\Ruby193,add.. path和associate…rb两个都勾选→Install
（安装ruby1.9.3和rails3.2.8）
2. 解压redmine-2.1.2.zip 到目录：D:\ redmine-2.1.2
3. 安装DevKit库
双击执行DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe，选择路径：DevKit-tdm-32，→Extract。
（这一步的顺序挺重要，否则第4步操作可能会出错）
然后：cmd进入windows命令操作，进入devkit的文件夹下，执行下面的操作：
ruby dk.rb init

ruby dk.rb install

DevKit库就安装成功了。
4. 安装rubygems
解压rubygems-1.8.24.zip，解压到D:\ rubygems-1.8.24
在dos中进到这个目录，输入：gem install bundler，回车。

然后按照下面信息安装所需的文件，输入：bundle install –without development test，回车。

如果不用安装rmagick，则可以执行下面语句，输入bundle install –without development test rmagick，回车。

如果要安装rmagick，则参考文章后面：问题集锦1。
5. 验证rails版本和rake版本
输入：rails –version 或者输入：rails -v

输入：rake --version

6. 版本删除重装
如果要切换安装其他版本，则先删除旧版本，再重新装新版本的。
例如：删除rake-0.9.2.2
输入：gem uninstall rake

安装rake-0.8.7
输入：gem install rake -v=0.8.7

7. 查看gem清单
输入：gem list，回车。

注：执行gem install后，都要执行：bundle install，更新一次。

8. 安装mysql2插件
输入：gem install mysql2

(会出现 no definition问题，未发现影响）
9. 启动mysql，创建数据库
进入mysql命令行 ，执行如下命令：
mysql> create database redmine character set utf8;
mysql> create user 'redmine'@'localhost' identified by 'redmine';
mysql> grant all privileges on redmine.* to 'redmine'@'localhost';
10. 数据库参数修改
复制redmine目录下的config/database.yml.example 重命名为 config/database.yml，打开database.yml，
并修改链接数据库所需要的参数（加粗描红部门是修改的内容）：
production:
adapter: mysql2
database: redmine
host: localhost
username: redmine
password: redmine
encoding: utf8
注意：格式一定要正确，冒号后面都是一个空格。如果你的mysql的端口不是3306就要加上一行port: xxxx,例如：port: 3307
11. 生成session密钥 
打开控制台，用命令进入到redmine的config目录：
Redmin 1.4.X:输入：rake generate_session_store
Redmin 2.X:输入：rake generate_secret_token
我们这里redmine是2.1.2版本，
则输入：rake generate_secret_token

12. 添加MySql的动态链接库文件libmysql.dll
解压mysql-connector-c-noinstall-6.0.2-win32.zip到目录：
D:\ mysql-connector-c-noinstall-6.0.2-win32
然后把D:\mysql-connector-c-noinstall-6.0.2-win32\lib目录下的libmysql.dll复制到D:\Ruby193\bin目录下（你安装rails-ftw-v0.11-1.9.3-3.2.8.exe的目录）
13. 创建数据库结构
输入：SET RAILS_ENV=production

输入：rake db:migrate

14. 插入默认数据
输入：rake redmine:load_default_data

接下来自动会弹出一个选择语言：输入zh
15. 启动rails服务
回到redmine的目录，输入：rails serve，或者输入：rails s，回车。

出现以下界面：

说明安装成功。
16. 打开浏览器：输入http://localhost:3000/
就可以看到redmine的窗口了。
用账户：admin 密码：admin登录
进入系统之后修改语言为中文，在myaccount和setting里面修改。
问题集锦：
1. 安装rmagick
window下安装rmagick， 需要手动安装，不能通过：gem install rmagick 进行安装。
下载rmagick的安装包RMagick-2.12.0-ImageMagick-6.5.6-8-Q8.zip， 解压之后会有两个文件，ImageMagick-6.5.6-8-Q8-windows-dll.exe安装文件和rmagick-2.12.0-x86-mswin32.gem文件。
   先安装exe的文件：
Next→I accept，Next→Next→选择路径：C:\Program Files\ImageMagick-6.5.6-Q8，Next-Next中install…C++勾选上→Next→Install。

   完了再安装gem， gem就是安装解压出来的gem。
   命令提示符切换到rmagick解压的目录， 输入：gem install rmagick-2.12.0-x86-mswin32.gem
   查看gem list里面是否存在rmagick就可以了。
2. Devkit库有关问题
  这里特别指出的就是，在第3步的devkit没有安装的话，可能会出现如下错误。
ERROR: Error installing gherkin:
The 'json' native gem requires installed build tools.

Please update your PATH to include build tools or download the DevKit
from 'http://rubyinstaller.org/downloads' and follow the instructions
at '
根本原因就是缺少DevKit库，解决方案如下：首先需要下载Win下面的DevKit安装文件DevKit-tdm-32-…….exe，解压后通过命令行进入解压文件，依次运行下列命令行：
ruby dk.rb init
ruby dk.rb install
这样DevKit就成功安装了！
3. Mysql驱动问题
rails3.x默认使用的 mysql2 的驱动，ruby1.8.7下没有mysql2驱动， mysql2驱动只能在1.9.2 下面才能使用，但是在1.9.2 中装不上 rails3.x ，官方网站上也没有 rails3.x 的版本。
所以在Windows上安装mysql2 非常困难，无论你的gem 是什么版本，ruby 是什么版本，都无法通过 gem install mysql2 来安装这个驱动， 而且网上下载的包也基本不能安装。
最后通过下载集成包RailsFTW，来安装，一切问题都解决。
 可以直接下载。
· RubyInstaller 1.9.3-p194, 1.8.7-p352, or TCS 1.9.3p28 experimental build
· Ruby on Rails (v3.0.10 in Ruby 1.8.7, v3.2.8 in Ruby 1.9.3), sqlite3 , and mysql2 gems
· SQLite3 DLL and command-line shell
· libmysql.dll from MariaDB
这个配置几乎包括了所有想要的东西， 最重要的是有mysql2驱动！ 
4. Mysql2安装问题
 rails3.1.1+ruby1.9.2+mysql5.5.x 安装mysql2方案：
需要安装 mysql2 0.3.10版本，如果是0.2.8也能成功，但是
  rails server的时候会出现警告。
如果不加版本号直接gem install mysql2 会安装最新的版本0.3.11（这个时候是这个版本，以后就不知道了），安装能成功，但是执行
   rails server
会报
   Incorrect MySQL client library version! This gem was compiled for 6.0.0 but the client library is 5.5.27
这样的错误，所以目前看来安装0.3.10是最合适的。
安装方式也有几种，一种是通过bundle install安装，一种是
  gem install mysql2 -- '--with-mysql-dir="D:\Program Files\MySQL\MySQL Server 5.5"'
#一定要注意引号，很多朋友忘记带引号，导致安装出错
当然也可以只写
  gem install mysql2 -v '0.3.10' 
进行安装 。如果是通过gem install进行安装，请保证Gemfile中为
  gem 'mysql2', '0.3.10'  
不然启动时候会叫你执行bundle install。
 最后安装成功后，把mysql安装目录中的libmysql.dll拷贝到ruby/bin中，一切大功告成。
5. gem install mysql2错误解决
运行 ‘bundle install’ 或者 ‘gem install mysql2′ 遇到如下错误
> gem install mysql2
ERROR: Error installing mysql2:
The 'mysql2' native gem requires installed build tools.

Please update your PATH to include build tools or download the DevKit
from 'http://rubyinstaller.org/downloads' and follow the instructions
at '
或者是
Error installing mysql2:
ERROR: Failed to build gem native extension.

C:/Ruby192/bin/ruby.exe extconf.rb
一般是因为没有安装编译器和没有安装mysql
最简单的解决办法：
如果rails 版本<3.1.0就安装mysql 0.2.6。如果rails 版本是3.1.*才需要安装mysql 0.3.*。切记！
默认安装的是mysql2 0.3.7，这个版本变化较多，可以安装旧版本gem，经测试安装0.2.6不会报错。
gem install mysql2 -v 0.2.6
如果你一定要安装最新版本，可以参照下面方法。
1、Linux下解决方法：
# sudo apt-get install libmysql-ruby libmysqlclient-dev
2Windows下比较麻烦，要先安装DevKit和Mysql。
安装DevKit见上面问题集锦2。
安装Mysql就不细说了，下载后双击即可。
以上两步完成后，要这样安装mysql2
> gem install mysql2 -- '--with-mysql-dir="D:\Program Files\MySQL\MySQL Server 5.5"'
#一定要注意引号，很多朋友忘记带引号，导致安装出错
Updating installed gems
Updating mysql2
Temporarily enhancing PATH to include DevKit...
Building native extensions. This could take a while...
Successfully installed mysql2-0.3.2
Gems updated: mysql2
Installing ri documentation for mysql2-0.3.2...
Enclosing class/module 'mMysql2' for class Client not known
Installing RDoc documentation for mysql2-0.3.2...
Enclosing class/module 'mMysql2' for class Client not known
这表示安装成功了，但是使用时可能还会报错。
最后一步：将mysql安装目录下的bin下的libmysql.dll复制到 ruby安装目录/lib下。
注意：为保证版本一致，libmysql.dll不要从网上下载。尽量从自己安装目录下复制。
附：有时启动服务器时报错
Please install the mysql2 adapter: `gem install activerecord-mysql2-adapter` (no such file to load -- active_record/connection_adapters/mysql2_adapter) (RuntimeError)
但是当gem install activerecord-mysql2-adapter 时会报找不到这个gem。
一般是因为安装的mysql2版本过新，因为mysql2 0.3.2版本开始放弃支持rails 3.0.*。
解法：
gem uninstall mysql2
gem install mysql2 -v 0.2.7