redmine安装配置过程.docx

项目管理系统redmine安装配置过程
安装项目管理工具redmine
APP NOTE 6004
日期：2010-4-20
部门：信息部
作者：姜虹
关键字：redmine安装、创建数据库

摘要：
安装项目管理软件redmine。
一、下载
InstantRails
 Redmine
二、安装
1、解压缩已下载的InstantRails 和 Redmine。
 2、将 Redmine 解压缩的文件夹直接拷贝到 InstantRails 目录的 rails_apps 目录下。
 3、在 InstantRails 目录下，启动InstantRails.exe。  
4、在redmine根目录下，找到 rails_apps\redmine\config 目录下的 database.yml.example文件，重命名为 database.yml，并修改成下面这样：
Ruby代码
1. production:   //注意这段代码
2.   adapter: mysql   
3.   database: redmine   
4.   host: localhost   
5.   username: root   
6.   password:   
7.   encoding: utf8   
8.     
9. development:   
10.   adapter: mysql   
11.   database: redmine_development   
12.   host: localhost   
13.   username: root   

14. password:   
15.   encoding: utf8   
16.   
17. test:   
18.   adapter: mysql   
19.   database: redmine_test   
20.   host: localhost   
21.   username: root   
22.   password:   
23.   encoding: utf8  
production:
adapter: mysql
database: redmine
host: localhost
username: root
password:
encoding: utf8

development:
adapter: mysql
database: redmine_development
host: localhost
username: root
password:
encoding: utf8

test:
adapter: mysql
database: redmine_test
host: localhost
username: root
password:
encoding: utf8
  5、创建数据库：
create database redmine character set utf8;
可以通过 InstantRails 进入 phpMyAdmin ，创建数据库，如下图：

创建成功后：

6、创建数据表：
进入 Redmine 项目的命令行，方法如下图所示：

在控制台中执行命令：
cd redmine 进入redmin目录

rake db:migrate RAILS_ENV="production"   用来创建数据库，完成后应该创建 43 个表。 自动生成
如果报错“could not find RubyGem rack”错误，则有可能是InstantRails包内的ruby版本过低，可以用新版本的ruby覆盖InstantRails目录下相应文件夹。
如果依然报“A……”的错误，可以尝试再创建数据库前运行如下命令：”rake config/initializers/session_store.rb”

创建后可在数据库中查看到：

rake redmine:load_default_data RAILS_ENV="production"   指明当前项目运行环境为 production ，中间会提示选择语言，选择 zh 。

7、到这里其实就算安装结束了，现在启动 web 服务，还是在上面的在命令行里 执行：
ruby script/server -e production
执行成功后控制台应如下图所示：

8、在浏览器中访问地址： http://localhost:3000/ 进入 Redmine

常用文件
中文汉化文件：/lang/zh.yml
数据库地址：http://127.0.0.1/mysql/
修改端口号
假设要改为的端口号为3307（可改为你想用的端口号）
步骤1.修改 InstantRails\mysql目录下的my.ini ，加入以下几行
[client]
port=3307 
[mysqld]
port=3307
步骤2.修改InstantRails\conf_files目录下的my.ini，修改内容同步骤1（也可直接拷贝mysql目录下的my.ini到此目录）。
步骤3.修改InstantRails\phpmyadmin\config.inc.php文件
找到：
$cfg['Servers'][1]['host'] = 'localhost';
改为
$cfg['Servers'][1]['host'] = 'localhost:3307';
步骤3（可选）.InstantRails\rails_apps\redmine\database.yml文件（不加上无法创建数据库）
找到  production:的配置段
加入  port: 3307

资源推荐：

相关资料：

创建mysql数据库
Mysql安装（略，暂时请参考我的其它文章，如： 以后我会把mysql的各版本安装单独整理出来）
# /usr/local/mysql/bin/mysql -u root -p
Mysql> create database redmine default character set utf8;
grant all on redmine.* to root;
grant all on redmine.* to root@localhost;
grant all on redmine.* to redmineuser;
grant all on redmine.* to redmineuser @localhost;
set password for redmineuser@localhost=password('redminpw');
Mysql>exit;
Remine设定
（注意此时的目录一定要在redmine/config里，不然会出错，本文后面有错误信息。）
# rake db:migrate RAILS_ENV="production"         //创建表
# rake redmine:load_default_data RAILS_ENV="production"        //加载默认配置
这里会要求选择默认语言，我选的中文zh：
Select language: bg, ca, cs, da, de, en, es, fi, fr, he, hu, it, ja, ko, lt, nl, no, pl, pt, pt-br, ro, ru, sk, sr, sv, th, tr, uk, vn, zh, zh-tw [en] zh
这个默认设置只是在未登录时的界面语言，当用户登录后，默认语言还是英语，在My account里可以修改成其它语言。
启动WEB服务
# ruby script/server webrick -e production
或# ruby /usr/local/redmine/script/server webrick -e production
停止web服务方法：在当前启动窗口按ctrl+C
访问http://ip:3000/
初始用户名/密码：admin/admin
这样启动后，启动窗口是不能关闭的，所以要使Redmine作为服务启动，需添加-d参数：
# ruby script/server webrick -e production -d
或# ruby /usr/local/redmine/script/server webrick -e production –d
停止服务方法：（ps命令查出此进程的pid号，再杀掉，目前好像只能这样，我看了--help里面，还没有停止的参数。）
# ps aux | grep ruby
# kill -9 [PID]
OK，安装完毕！可以进去玩了！哈哈！
贴个图，秀一下，嘿嘿~~~

我在安装过程中遇到的错误记录：
1:在rake db:migrate时出错了，弄了半天才发现，原来是自己窗口开多了，执行目录弄乱了！
在执行这个命令时，操作目录一定要在redmine/config这个目录里，不然就会出现下面的错误，嘿嘿~~~误打误撞啊~~~错误信息如下：
执行rake db:migrate RAILS_ENV="production"命令后出错：
(in /usr/local/ruby/lib/ruby/gems/1.8/gems/rake-0.8.7)
RCov is not available
rake aborted!
Don't know how to build task 'db:migrate'
(See full trace by running task with --trace)
加上—trace后执行rake db:migrate RAILS_ENV=production --trace出错：
(in /usr/local/ruby/lib/ruby/gems/1.8/gems/rake-0.8.7)
RCov is not available
rake aborted!
Don't know how to build task 'db:migrate'
/usr/local/ruby/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:1728:in `[]'
/usr/local/ruby/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:2050:in `invoke_task'
/usr/local/ruby/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:2029:in `top_level'
/usr/local/ruby/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:2029:in `each'
/usr/local/ruby/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:2029:in `top_level'
/usr/local/ruby/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:2068:in `standard_exception_handling'
/usr/local/ruby/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:2023:in `top_level'
/usr/local/ruby/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:2001:in `run'
/usr/local/ruby/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:2068:in `standard_exception_handling'
/usr/local/ruby/lib/ruby/gems/1.8/gems/rake-0.8.7/lib/rake.rb:1998:in `run'
/usr/local/ruby/lib/ruby/gems/1.8/gems/rake-0.8.7/bin/rake:31
/usr/local/ruby/bin/rake:19:in `load'
/usr/local/ruby/bin/rake:19
如果有不对的地方，请高手批评交流哦~~~
更新了一张图片~~~呵呵

最初知道这个软件是在公司开发一个大型项目的时候，当时看到项目页面的最下脚有“redmine”字样后，还在网上搜索了一番，知道是管理项目用的程序，而且是开源的。在笔记上写下了“readmine 项目管理工具”（囧）......多了个“a”，害我前天白搜索了好半天。
      最近又头热，想学学这个软件，说不定以后还可以科学的管理一下（自己的）项目。不过网上的教程我搜索了一下，大多都告诉你怎么做，而不是为什么这么做：知其然不知其所以然。让人觉得非常高深很难似的。其实非常简单。我昨天郁闷到2点都没搞定，今天再设置，竟然就直接成功了......原因：没重启........
      好了，说了这么多废话，下面入正题。
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（中文） 。

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

F：浏览器输入：http://localhost:3000/ 即可。（注意：管理员id和密码都是“admin”。