redmine-1.2.1完整安装说明

 

Windows 下安装项目管理工具 Redmine

1.redmine是什么：是一个基于web的项目管理软件，用Ruby开发的。（可以想象成用php写的n个 文件，可以在网页上浏览，就像wordpress。）

2.在本机配置redmine需要那些文件：
a:配置本机的运行环境：InstantRails。（可以想象成要在本机配置php服务器，里面有mysql，phpmyadmin等等。国内我觉得比 较好的有“PHPNOW”）下载的包是绿色包，里面有mysql数据库phpmyadmin等等，直接复制到任意一个文件夹里面即可。注意，路径中不要有 空格！
b.redmine软件包。也是一个绿色软件包。复制到刚才的“InstantRails” 目录的 “rails_apps”中。

3.好，文件都准备好了。下面开始配置：

现在redmine用到的数据库和InstantRails里面的MySQL数据库是脱离的，也就是说，接下来的任务，实际上是将redmine的数据与数据库关联，即：导入一些数据库到MySQL里面。仅此而已！（可以想象如同在phpMyAdmin里面导入*.sql的 文件，导入数据库。）

方法：
A.“InstantRails/rails_apps/redmine/config"下，有文件“database.yml.example”，重命 名一下，改成“database.yml”。我的想法是大概将如同*.doc.bak文件的bak去掉吧。这个是redmine数据库的配置文件，里面有 数据库的相关信息。（为什么不是下载来了就直接是.yml呢......）

B.点击“InstantRails”目录里面的“InstantRails.exe”文件。这就是启动环境（Apache）的主程序了。

C.进入phpMyAdmin下，新建三个数据库（用sql命令方式）：
     create database redmine character set utf8;
   create database redmine_development character set utf8;
   create database redmine_test character set utf8;
（注：进入phpmyadmin下有两种方式。法1：浏览器输入http://127.0.0.1/mysql/    法2：InstantRails界面（就是刚才点击InstantRails.exe后的程序界面）的I→Configure→Database (via PhpMyAdmin)”。如果该栏是灰色的，表示你安装后没重启机器。重启一下即可。这个问题郁闷了我N个小时）

D.好，数据库建立了。现在应该往数据库里面导入数据了。目的如同用*.sql文件导入数据。这里是在dos命令下导入的。
      点击InstantRails界面（就是刚才点击InstantRails.exe后的程序界面）的I→Rails Applications→Open Ruby Console Window栏目，然后会跳出dos窗口。在里面输入命令：
        cd redmine     //进入redmin目录
        rake db:migrate RAILS_ENV="production"    //创建数据库
        rake redmine:load_default_data RAILS_ENV="production"   //指明当前项目运行环境为production ，中间会提示选择语言，选择 zh（中文） 。

rake db:migrate RAILS_ENV="development"
rake redmine:load_default_data RAILS_ENV="development"

E.现在配置结束了，点击InstantRails界面（就是刚才点击InstantRails.exe后的程序界面）的I→Rails Applications→Manage Rails Applications栏目，如下，点击“Start with Mongrel”（启动redmine这个应用程序）。跳出一个dos窗口，不要关闭。现在就可以浏览你配置好的RedMine了。

 

F：浏览器输入：http://localhost:3000/ 即可。（注意：管理员id和密码都是“admin”。界面还是英文界面，登录后可以在“设置”里面更改成“简体中文”。）

总的流程：下载文件包，配置数据库。没学过Ruby的不要被唬住，虽然redmine 是Ruby编译的，但是使用redmine并不需要了解Ruby。
注意：上文中所提到的文件目录，根据你下载的版本而定。比如上文中说文件夹 “redmine”，我这里实际上是“redmine-0.8.0”。我下的版本是0.8.0版的。
软件下载地址：
Instant Rails - Windows： http://rubyforge.org/frs/?group_id=904
Redmine : http://rubyforge.org/frs/?group_id=1850

 

安装与配置 （补充）

1.       将 Rubyy-1.8.7\bin ）

2.       将 RubyGems 1.3.1  1.8.7 的安装包解压到某个目录下（例如： C:\ruby-1.8.7 ），并将子目录 bin 的路径加入到 Windows 的 PATH 环境变量中（例如：在 PATH 环境变量中加入 C:\rub安装包解压到某个临时目录下（例如： C:\rubygems-1.3.1 ），在 Windows 的命令行模式下切换当前目录为该临时目录，运行如下命令：

ruby setup.rb

该命令将离线安装 RubyGems 。安装完毕后可删除该临时目录

3.       在命令行模式下运行如下命令：

gem install rake

该命令将在线安装 Rake

4.       将 Rails 2.3.3 的安装包解压到某个临时目录下（例如： C:\rails ），在命令行模式下切换当前目录为该临时目录，运行如下命令：

gem install rails -v=2.3.3 --include-dependencies

该命令将离线安装 Rails 。安装完毕后可删除该临时目录

5.      在命令行模式下运行如下命令：

gem install mysql

在命令将在线安装 MySQL 的 C bindings （ C 语言绑定？ C 语言库？），可明显提高访问数据库的性能

6.       安装并运行 MySQL 。参见 MySQL 相关的资源

7.       在 MySQL 命令行模式下运行如下命令：

create database redmine character set utf8;

该命令将创建一个供 Redmine 使用的数据库

8.       安装 Visual C++ 2008 Redistributables

9.       安装 Win32 OpenSSL v0.9.8j Light 。注意在“ Select Additional Tasks ”时选“ Copy OpenSSL DLLs to The Windows system directory ”，否则在安装完毕后需要手工将 OpenSSL 安装目录下的 DLL 文件复制到 Windows 的系统目录（例如： C:\Windows\system32 ），或 Ruby 的 bin 目录（例如： C:\ruby-1.8.7\bin ）

10.   将 ZLib 1.2.3 的安装包中的 zlib1.dll 解压到 Windows 的系统目录或 Ruby 的 bin 目录，并改名为 zlib.dll

11.   将 libiconv 1.9.1 的安装包中的 bin\iconv.dll 解压到 Windows 的系统目录或 Ruby 的 bin 目录

12.   将 Redmine 的安装包解压到某个目录（例如： C:\redmine-0.9.1 ），将 config\database.yml.example 复制为 config\database.yml ，并修改该文件中的“ production ”段的数据库配置。例如：

production:

 adapter: mysql

 database: redmine

 host: localhost

 username: root （这里填写你希望用来登录 MySQL 的用户名）

 password: password （这里填写用户密码）

13.   将MySQL安装目录中的libmySQL.dll文件复制到Ruby安装目录下(如：C:\ruby-1.8.7\bin)，然后再Windows 命令行模式下切换当前目录为 Redmine 的安装目录，运行如下命令：

 

rake config/initializers/session_store.rb

 

rake db:migrate RAILS_ENV="production"

该命令将创建生产用的数据库结构。这是关键的一步，笔者就在此处经过多次尝试后才安装好Redmine.

如果出现“Mysql::Error: The 'InnoDB' feature is disabled”错误，需要开启MySql数据库对InnoDB的支持，在你的mysql安装文件夹中打开my.ini文件，找到skip-innodb，改成#skip-innodb，然后重启mysql(注：可以通过MySQL命令show variables like "have_%";查看是否开启了InnoDB)

 

14.   在命令行模式下运行如下命令：

rake redmine:load_default_data RAILS_ENV="production"

该命令将填充默认的配置数据。该命令运行过程中需要选择语言，一般输入zh（ 简体中文）

15. 在命令行模式下运行如下命令：

ruby script/server webrick -e production

该命令将运行 Redmine ！

16.   打开浏览器，访问如下网址： http://localhost:3000/ ，使用用户 admin （密码 admin ）登录试试吧！

 

注：安装完用admin登录时报错可能是因为漏掉了13与14步的操作 

Rails的升级

文章分类:Ruby编程

最近在选择开源项目管理工具，最后看上了redmine

一开始用Bitnami，可是装好之后总是不能访问redmine

无奈之后选择InstantRails-2.0作为安装环境

可是按照网上的帖子装的过程中总是报错

后来才知道是因为我装的redmine 1.0.0要求的版本要比InstantRails-2.0高，而InstantRails-2.0从2007年开始就没更新过了。

昨晚我弄了2点半，中间几次想放弃，但拗不过自己的牛脾气，最后终于升级成功，并且成功访问了redmine。

过程是痛苦的，结果是甜蜜的。

虽然对ror并不是很了解，但想信我的安装经历对大家多少会有些帮忙。

 

具体过程如下：

1、InstantRails-2.0安装后，在配置环境变量path中配置ruby/bin目录（如果系统中有多个RUBY，执行命令行的时候系统认的就是path中的）

2、进入DOS命令行，执行gem update --system，结果

Updating RubyGems...
ERROR:  While executing gem ... (Gem::RemoteSourceException)
HTTP Response 302 fetching http://rubygems.org/yaml

     这是因为gem的配置过低，无法进行远程更新，执行gem -v 发现是1.0.1

3、从下面这个地址下载 rubygems-update-1.3.7.gem，http://rubyforge.org/frs/download.php/70695/rubygems-update-1.3.7.gem

    然后DOS命令进行该文件所在的目录，执行gem install --local rubygems-update-1.3.7.gem，出现信息

Successfully installed rubygems-update-1.3.7
1 gem installed
Installing ri documentation for rubygems-update-1.3.7...
Installing RDoc documentation for rubygems-update-1.3.7...
Could not find main page README
Could not find main page README
Could not find main page README
Could not find main page README

  执行gem -v查看，发现并没有更新成功，Could not find main page README是什么意思我没弄明白，但是我从http://production.s3.rubygems.org/yaml上发现这么一句

If you have an older version of RubyGems installed, then you can still
do it in two steps:
     
$ gem install rubygems-update  # again, might need to be admin/root
$ update_rubygems              # ... here too
 我照着再执行update_rubygems，接着出现的信息很多，就不帖出来，再执行gem -v，发现更新成功，已经是1.3.7了

 这一步是一切成功的源泉！！！！！！

4、接着再执行gem update --system，提示

Updating RubyGems
Nothing to update

  这是为什么我不明白，请高手指点一下

5、再执行gem update rails --include-dependencies，提示信息

Updating installed gems
Updating rails
ERROR:  Error installing rails:
        actionpack requires rack (~> 1.0.0, runtime)
Gems updated: activesupport, activerecord
Installing ri documentation for activesupport-2.3.3...
Installing ri documentation for activerecord-2.3.3...
Installing RDoc documentation for activesupport-2.3.3...
Installing RDoc documentation for activerecord-2.3.3...

执行rails -v，发现还是2.0.2没有更新成功，根据actionpack requires rack (~> 1.0.0, runtime)，应该是actionpack 需要1.0.0版本的rack

6、执行gem install rack -v=1.0.0

Successfully installed rack-1.0.0
1 gem installed
Installing ri documentation for rack-1.0.0...
Installing RDoc documentation for rack-1.0.0...

更新成功

 7、再次执行 gem update rails --include-dependencies

出现信息

Updating installed gems
Updating rails
Successfully installed rake-0.8.7
Successfully installed activesupport-2.3.8
Successfully installed activerecord-2.3.8
Successfully installed rack-1.1.0
Successfully installed actionpack-2.3.8
Successfully installed actionmailer-2.3.8
Successfully installed activeresource-2.3.8
Successfully installed rails-2.3.8
Gems updated: rake, activesupport, activerecord, rack, actionpack, actionmailer, activeresource, rails
Installing ri documentation for rake-0.8.7...
Installing ri documentation for activesupport-2.3.8...
Installing ri documentation for activerecord-2.3.8...
Installing ri documentation for rack-1.1.0...
Installing ri documentation for actionpack-2.3.8...
Installing ri documentation for actionmailer-2.3.8...
Installing ri documentation for activeresource-2.3.8...
Installing ri documentation for rails-2.3.8...
Installing RDoc documentation for rake-0.8.7...
Installing RDoc documentation for activesupport-2.3.8...
Installing RDoc documentation for activerecord-2.3.8...
Installing RDoc documentation for rack-1.1.0...
Installing RDoc documentation for actionpack-2.3.8...
Installing RDoc documentation for actionmailer-2.3.8...
Installing RDoc documentation for activeresource-2.3.8...
Installing RDoc documentation for rails-2.3.8...

执行rails -v，发现已更新成功

 

总结：rails更新有两种方式：1、联机更新;2本地更新

联机更新过程中如果出现HTTP Response 302 fetching http://rubygems.org/yaml无法更新，有两种情况

一是gem的版本过低，二是与服务器的连接不通

此时可以试着加入其他服务器地址

 gem source -l  查看列表

 gem source -a http://rubygems.org 加入新的服务器地址

 或者直接gem install rubygems-update --source http://rubygems.org

本地更新需要下载相应的gem包，版本需与要更新的rails版本对应，同时安装顺序有要求，因此gem包之间有依赖关系

顺序从上面的显示信息中可以看出来

Successfully installed rake-0.8.7
Successfully installed activesupport-2.3.8
Successfully installed activerecord-2.3.8
Successfully installed rack-1.1.0
Successfully installed actionpack-2.3.8
Successfully installed actionmailer-2.3.8
Successfully installed activeresource-2.3.8
Successfully installed rails-2.3.8

至于gem包的下载地址都在http://rubyforge.org/，但是有些项目的并不好找到，可以在google中直接搜索，就能找到在http://rubyforge.org/中的地址。

 

让 Redmine 自动运行

使用命令行方式运行 Redmine 很不方便，幸好 Ruby 提供了 mongrel_service 包，它可以将 Ruby 程序注册为 Windows 服务。

1.       在命令行下运行如下命令即可安装 mongrel_service ：

gem install mongrel_service

2.      然后使用 mongrel_service 将 Redmine 注册为 Windows 服务：

mongrel_rails service::install - N Redmine -c C:\redmine-0.8.1 -p 3000 –e production

注意：在我的机器上执行该命令后， Windows 服务确实注册了，但 -e 参数的值却是 development 。这需要修改该服务的注册表项，将该参数的值修改为 production ，否则 Redmine 连不上数据库

3.       如果 MySQL 是与 Redmine 安装在同一台机器的，还可以将 MySQL 添加为 Redmine 依赖的服务，这样启动 Redmine 时保证 MySQL 也启动了：

sc config Redmine depend= MySQL

注意 depend= 与 MySQL 之间有一个空格

4.       还可以将 Redmine 设置为自动启动：

sc config Redmine depend= MySQL start= auto

同样， start= 与 auto 之间有一个空格