Redmine安装和使用心得

最终目标锁定为两个开源的项目管理系统，禅道和Redmine，两个都很优秀，而个人需求又很是简单——能提交、追踪、反馈bug就能够了，这两个系统都是能够胜任的。虽然这篇文章讲解的是Redmine的安装和使用心得，可是对于多数用户，可能禅道是更好的选择，由于它兼具bug管理功能的同时，更偏重于项目管理，最重要的是，它的安装很是简单，几乎是一键搞定。 而Redmine的安装部署绝对不是一键简单的工做。

首先要准备Ruby相关文件，Redmine是基于Ruby on rails开发的。

   一、下载railsinstaller，我这时下载的版本是railsinstaller-2.2.1.exe，对应的官网：http://railsinstaller.org/en railsinstaller大大简化了rails的安装。除了windows下面的外，还有iMac下面的安装包。

二、下载wamp，集成了apache,MySQL,php，使用很是方便。对应的官网是：http://www.wampserver.com/en/

网站部署通常都须要wamp，也就是windows+apache+mysql+php的环境。流行的集成环境有两个wampserver和xampp，这里使用的是wampserver

三、下载ImageMagick，这个是图型生成工具，redmine用于生成pdf等内容，也能够不安装。这个东西我安装的时候有些问题，因此没有安装。

四、redmine的源文件，这里下载的是redmine2.3.3 ,发布版本下载列表地址是：http://rubyforge.org/frs/?group_id=1850

安装文件准备好后，就能够开始安装了。

一、安装railsinstaller，若是不须要选择目录，就一路安装下去就能够了

二、安装wamp，先安装vc2010的环境vcredist_x86.exe, 再安装wamp,若是不须要选择目录，就一路安装下去就能够了

三、把redmine解压到c:\redmine（你能够本身解压目录）

四、安装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对应的版本号

五、配置数据库 运行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.1.30/phpmyadmin/，这样就能够进入phpmyadmin操做了，这里root默认是没有密码，因此，先修改root的密码为helloredmine，（你本身实际状况调整）

六、准备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’;

七、配置redmine的数据库

在c:\redmine\config目录下，复制database.yml.example为database.yml，而后编辑它，来配置。

找到production项，并配置，配置以下：（由于都是默认，在这里只要配置密码就能够了）

production:

adapter: mysql2

database: redmine

host: localhost

username: root

password: 123456

encoding: utf8

八、安装redmine    在dos命令提示下，咱们进入到c:\redmine目录 而后执行

bundle install –without development test postgresql sqlite

注意：若是在安装过程，有可能由于网络的问题，形成个别的安装不了，那就用gem install xxxxx来安装指定的，安装完成后，再执行上面的bundle install命令。直到安装完成。

安装成功结果以下

而后再输入rake generate_secret_token，设置sessiond加密存贮

九、初始化redmine的数据库    在DOS命令提示符下面，输入下面的命令

set RAILS_ENV=production

rake db:migrate

再输入下面的命令，这里会设置默认语言

set RAILS_ENV=production

set REDMINE_LANG=zh

rake redmine:load_default_data

以下图，则表示完成

十、运行  在DOS命令提示符下，输入：ruby script/rails server webrick -e production

安装成功，而后在浏览器，输入

http://192.168.1.30:3000

就能够看到redmine的主页了，初始管理员的帐号是admin，密码是admin，而后就能够进去玩了。到这里就安装完成。若是还须要配置email和svn，请参与官网提示的安装指南 http://www.redmine.org/projects/redmine/wiki/RedmineInstall

一些常见问题的补充说明：

若是运气足够好的话，你能够从第一步一路顺畅的走到第十步。下面是我碰到的一些问题。

一、gem install mysql2 的时候可能由于网络问题，没有安装成功。 多试几回就能够了。

二、正常来讲WAMP Server的系统托盘图标应该是绿色的。若是不是的话，多是某些服务开启失败了。最多见的多是80端口冲突致使apache服务启动失败。我碰到的状况是由于我以前安装过xamp，因此两个apache冲突了。 删掉xamp后就正常了。 要想删掉xamp须要先关闭全部的相关服务。

三、mysql的默认是没有密码的。能够经过登录mysql控制台，而后使用sql语句修改密码

mysql> use mysql;

mysql> UPDATE user SET Password = PASSWORD(‘123456’) WHERE user = ‘root’;
mysql> FLUSH PRIVILEGES;

其中123456就是新的密码。这里要注意sql语句最后的分号不要漏掉。 而且sql执行可能出现失败的状况，多试几回。

四、修改完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用户名的密码

五、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的数据库，就是这里出问题了。

六、部署好，可以正常访问了，默认的管理员帐户和密码都是admin，全部新建帐号都须要经过管理员帐号激活才能正常使用