搭建redmine环境问题总结

步骤可参看:http://www.redmine.org/projects/redmine/wiki/RedmineInstall#Supported-database-back-ends

1. 首先得确保电脑已经安装好了ruby和rails,安装ruby很简单,只需要从http://www.ruby-lang.org/en/downloads/下载rubyinstaller双击运行即可,安装好之后将其ruby下的bin目录添加到path环境变量中。

2. 接下来安装rails:cmd运行gem install rails,如果此步出错请确保ruby已经正确安装并且path变量已经修改。

3. 安装mysql:gem install mysql。

4. 接下来就可以正式开始安装redmine了,到http://rubyforge.org/frs/?group_id=1850下载redmine的最新版本并将redmine解压至任何位置。

5. 创 建redmine使用的数据库并分配用户权限:create database redmine character set utf8,grant all privileges on redmine.* to ‘redmine’@’localhost’ identified by ‘password’,这里redmine@localhost中的redmine是你计算机中的mysql用户,一般可设置为root(即mysql的 默认最高权限用户),password即root用户登录mysql的密码。

6. 数据库连接配置:将解压后的redmine目录下的config/database.yml.example拷贝纸config/database.yml并且修改里面的内容为:

production:
adapter:mysql2(因为我使用的是ruby1.9.3,小于该版本的为mysql
database:redmine
host:localhost
username:root
password:password

这 里需要注意这么几点:adapter是你使用的数据库类型,如果是mysql则为mysql或mysql2,如果是postgreSQL则为 postgresql,sqlserver则为sqlserver。database是你在第五步创建的database名。host就是你需要连接的数 据库服务器地址,如果是本地则填localhost,但是在这里我填localhost接下来会遇到can’t connect to mysql server on ‘localhost’这样的失败提示,这时我将localhost改为127.0.0.1就行了,在网上说是localhost不能映射到 127.0.0.1,但是我查看了我的hosts文件确实将localhost映射到了127.0.0.1了啊,我也就不知道为什么了。username 是你在第五步中创建的用户名,密码就是username连接数据库的密码了。

7. 安装相关依赖:cmd至redmine解压的目录:gem install bundler,这个命令如果提示gemfilenotfound则说明该命令的执行目录下没有gemfile文件,你需要确保cmd到redmine的 根目录了,因为redmine的根目录就有一个gemfile文件。如果报类似ssl connect的问题(具体报错信息不记得了,昨晚搭建的,现在才来总结),你可以将redmine目录下的那个Gemfile文件打开将第一行 source ‘https://rubygems.org’中的https改为http即可,这个时候如果很久都没有执行成功也没有报错,这个时候可能就是网络问题 了,因为这个命令需要去下载东西,国内的网络环境大家也是清楚的,这个时候你可以执行以下命令:

gem sources remove https://rubygems.org/
gem sources a http://ruby.taobao.org/
gem sources l(查看是否只有http://ruby.taobao.org/)

在 执行这几个命令过程中如果出现类似xxx not present in current repository(也记不清了,大致是这样的报错信息)那么你首先执行以下gem sources –l查看有哪些ruby的gem源,然后再执行以上命令即可,执行完也要修改Gemfile的source。这样速度会快很多,感谢taobao的贡献。 执行完该命令后再执行bundle install –without development test,执行这个命令大概花了我一个多小时,因为出现的问题太多了,下面就一一讲解一下: 如果出现类似failed to build gem native extension,rmagick xxx或者could not find a valid gem rmagick的信息时这时候就需要去安装rmagick了,首先得安装Devkit,在http://rubyinstaller.org/downloads/下 载相应版本的devkit,因为我的ruby版本是1.9.3则下载DevKit-tdm-32-4.5.2-20111229-15559- sfx.exe即可并双击解压至任何位置(如果你使用的是其他版本则可以阅读该网页以确定下载哪个版本的devkit),接下来cmd切换到devkit 解压的位置并执行:ruby dk.rb init和ruby dk.rb install,如果执行ruby dk.rb init时出现类似please review and modify the config.yml xxxx则将devkit解压的目录下的config.yml文件下加上-D:/ruby193(该路径是ruby的路径),如果执行ruby dk.rb install时出现skipping existing devkit helper libraryxxx的信息时则需要到ruby目录下的lib/ruby/site_ruby目录将devkit.rb文件删除重新执行该命令即可。 接 下来才真正开始安装rmagick,在http://www.imagemagick.org/script/binary- releases.php#windows下载imagemagick-6.8.5-7-Q16-x86-dll.exe文件双击执行,在select additional tasks这步需要将add application directory to your system path和install development headers and libraries for c and c++这两项勾上next至安装成功即可。安装完成之后重新打开cmd运行:

set CPATH=d:\xxx\ImageMagick-6.xx-Q16\include
set LIBRARY_PATH=d:\xxx\ImageMagick-6.xx-Q16\lib

接下来将cmd切换至redmine目录运行gem install rmagick如果运行失败则确保你上面的两条命令执行成功。运行成功后重新运行bundle install –without development test。

8. 生成会话存储密钥:cmd切换至redmine目录运行:rake generate_secret_token.

9. 创建数据库结构:set RAILS_ENV=production,rake db:migrate,运行过程中如果出现类似this gem was compiled for 6.0.0的信息则说明redmine使用的连接mysql的lib和你系统安装的mysql提供的lib包版本不一致,这时到http://dev.mysql.com/downloads/connector/c/6.0.html#downloads下载6.0.2版本的mysql-connector-c-noinstall-6.0.2-win32.zip并解压将其中的libmysql.dll文件拷贝到ruby的bin目录下重新运行上述命令即可。

10. 生成数据库默认配置:运行set RAILS_ENV=production,set REDMINE_LANG=zh,rake redmine:load_default_data。

11. 启动redmine:ruby script/rails server webrick –e production,启动会有点慢,等待xxx start字样出现就说明启动成功接下来访问http://localhost:3000就可以了,然后以login:admin,password:admin登录即可开始redmine之旅了。



Previous     Next
uohzoaix /
Published under (CC) BY-NC-SA in categories redmine  tagged with