首先要准备Ruby相关文件,Redmine是基于Ruby on rails开发的。
1、下载railsinstaller,我这时下载的版本是railsinstaller-2.2.1.exe,对应的官网:http://railsinstaller.org/en railsinstaller大大简化了rails的安装。除了windows下面的外,还有iMac下面的安装包。
2、下载wamp,集成了apache,MySQL,php,使用非常方便。对应的官网是:http://www.wampserver.com/en/
网站部署一般都需要wamp,也就是windows+apache+mysql+php的环境。流行的集成环境有两个wampserver和xampp,这里使用的是wampserver
3、下载ImageMagick,这个是图型生成工具,redmine用于生成pdf等内容,也可以不安装。这个东西我安装的时候有些问题,所以没有安装。
4、redmine的源文件,这里下载的是redmine2.3.3 ,发布版本下载列表地址是:http://rubyforge.org/frs/?group_id=1850
安装文件准备好后,就可以开始安装了。
1、安装railsinstaller,如果不需要选择目录,就一路安装下去就可以了
2、安装wamp,先安装vc2010的环境vcredist_x86.exe, 再安装wamp,如果不需要选择目录,就一路安装下去就可以了
3、把redmine解压到c:\redmine(你可以自己解压目录)
4、安装ruby下的mysql2,这里使用的是wamp中的mysql,我这里wamp是默认安装,也就是安装在c:\wamp目录下面,那边在这里,mysql的目录是C:\wamp\bin\mysql\mysql5.6.12。将C:\wamp\bin\mysql\mysql5.6.12\lib下的libmysql.dll和libmysqld.dll复制到c:\windows\system32中
进入dos命令提示符下面,输入
gem install mysql2 — ‘–with-mysql-lib=”C:\wamp\bin\mysql\mysql5.6.12\lib” –with-mysql-include=”C:\wamp\bin\mysql\mysql5.6.12\include”‘
注:这里需要mysql对应的头文件和库文件目录,否则会安装失败。输入gem list就可以看到mysql2对应的版本号
5、配置数据库 运行wamp,然后配置apache,如下图操作
然后找到配置中的directory配置,找到Allow from
127.0.0.1改为Alloc from all,如下图所示
然后修改C:\wamp\alias下的phpmyadmin.conf,将
<Directory “c:/wamp/apps/phpmyadmin4.0.4/”>
Options Indexes FollowSymLinks ExecCGI
AllowOverride all
Order Deny,Allow
Deny from all
Allow from 127.0.0.1
Allow from ::1
Allow from localhost
</Directory>
中的Allow from 127.0.0.1改为Alloc from all,然后重启wamp, 这样就可以局域网对mysql操作了。
我这里的ip是192.168.1.30,在浏览器地址栏输入http://192.168.200.157/phpmyadmin/,这样就可以进入phpmyadmin操作了,这里root默认是没有密码,所以,先修改root的密码为helloredmine,(你自己实际情况调整)
6、准备redmine数据库
在phpmyadmin操作sql
CREATE DATABASE redmine CHARACTER SET utf8;
CREATE USER ‘redmine’@‘localhost’ IDENTIFIED BY ‘my_password’;
GRANT ALL PRIVILEGES ON redmine.* TO ‘redmine’@‘localhost’;
7、配置redmine的数据库
在c:\redmine\config目录下,复制database.yml.example为database.yml,然后编辑它,来配置。
找到production项,并配置,配置如下:(因为都是默认,在这里只要配置密码就可以了)
production:
adapter: mysql2
database: redmine
host: localhost
username: root
password: 123456
encoding: utf8
8、安装redmine 在dos命令提示下,我们进入到c:\redmine目录 然后执行
bundle install --without development test postgresql sqlite rmagick
注意:如果在安装过程,有可能因为网络的问题,造成个别的安装不了,那就用gem install xxxxx来安装指定的,安装完成后,再执行上面的bundle install命令。直到安装完成。
安装成功结果如下
然后再输入rake generate_secret_token,设置sessiond加密存贮
9、初始化redmine的数据库 在DOS命令提示符下面,输入下面的命令
set RAILS_ENV=production
rake db:migrate
再输入下面的命令,这里会设置默认语言
set RAILS_ENV=production
set REDMINE_LANG=zh
rake redmine:load_default_data
如下图,则表示完成
10、运行 在DOS命令提示符下,输入:ruby bin/rails server webrick -e production
安装成功,然后在浏览器,输入
就可以看到redmine的主页了,初始管理员的账号是admin,密码是admin,然后就可以进去玩了。到这里就安装完成。如果还需要配置email和svn,请参与官网提示的安装指南 http://www.redmine.org/projects/redmine/wiki/RedmineInstall
11、邮箱配置:
在安装路径【D:\redmine-3.2.2\redmine-3.2.2\config\configuration.yml】下,找到“production” 在其下,添加
email_delivery:
delivery_method:async_smtp
async_smtp_settings:
address:smtp.qq.com
ssl:true
port:465
domain:qq.com
authentication:login
user_name: <- 个人设置的时候是在.txt文本中都编辑好一次性粘贴的
password: <- 手打时,遇到过 user_name:和password:显红色(notepad++),然后配置就不生效了,别人说是需要加上引号的关系,可我一次性粘贴确实是没有引号也成功的。希望有大神指点
一些常见问题的补充说明:
如果运气足够好的话,你可以从第一步一路顺畅的走到第十步。下面是我碰到的一些问题。
1、gem install mysql2 的时候可能因为网络问题,没有安装成功。 多试几次就可以了。
2、正常来说WAMP Server的系统托盘图标应该是绿色的。如果不是的话,可能是某些服务开启失败了。最常见的可能是80端口冲突导致apache服务启动失败。我碰到的情况是因为我之前安装过xamp,所以两个apache冲突了。 删掉xamp后就正常了。 要想删掉xamp需要先关闭所有的相关服务。
3、mysql的默认是没有密码的。可以通过登陆mysql控制台,然后使用sql语句修改密码
mysql> use mysql;
mysql> UPDATE user SET Password =
PASSWORD(‘123456’) WHERE user = ‘root’;
mysql> FLUSH
PRIVILEGES;
其中123456就是新的密码。这里要注意sql语句最后的分号不要漏掉。 并且sql执行可能出现失败的情况,多试几次。
4、修改完mysql密码后,php对应的登陆密码也要修改,否则提示访问被拒绝。配置文件的路径是
C:\wamp\apps\phpmyadmin4.0.4\config.inc.php
在其中添加
$cfg[‘Servers’][$i][‘AllowNoPassword’]
= false;
$cfg[‘Servers’][$i][‘user’] = ‘root’; // MySQL user
访问phpmyadmin使用的mysql用户名
$cfg[‘Servers’][$i][‘password’] = ‘123456’; // MySQL
password (only needed对应上述mysql用户名的密码
5、redmine的mysql登陆密码配置文件路径是
C:\redmine\config\database.yml
production:
adapter:
mysql2
database: redmine
host: localhost
username: root
password: 123456
encoding: utf8
由于我们使用的是production,所以只关心这个就足够了。 这里对应上文中第9步,初始化redmine数据库,如果在phpMyAdmin中看不到redmine的数据库,就是这里出问题了。
6、部署好,能够正常访问了,默认的管理员账户和密码都是admin,所有新建账号都需要通过管理员账号激活才能正常使用。
参考文献:http://www.redmine.org.cn/499.html