我决定在项目中引入Redmine来管理开发任务和计划,至于Redmine的优点,请问度娘或者脑补一下。
互联网搜索到的。基本上都是旧版本号的。 1.2.1 的最多,我要新的啊,所以仅仅好自己来啦。
本文主体參考 Redmine Wiki 的安装页面:http://www.redmine.org/projects/redmine/wiki/RedmineInstall ,遇到的问题自己攻克了一下。
总之不是翻译,而是实践记录。
环境描写叙述
服务器操作系统为Windows Server 2008 R2 Enterprise。64位版本号。
Rails 3.2.19,ruby为1.9.3p545。
Redmine 为 2.5.2 版本号。
MySQL 为5.5.40 win32 版本号。
ImageMagick 为 ImageMagick-6.8.9-8-Q16-x86-dll 。
安装与配置
Redmine 是基于 Ruby on Rails 的,我选择最新版本号 2.5.2 。请到 redmine wiki 站点中的安装页面了解详情。
截至我写博文时(2014年10月17日)最新版本号为 2.5.2 。
依赖选择
我们先对 Redmine 依赖的环境和软件做下说明。
能跑 Ruby 的操作系统就能跑 Redmine ,依据公司情况,我找了台 Server 2008 的计算机。
Redmine 对 Ruby 和 Rails 的依赖。例如以下图:
Redmine 2.5 版本号须要 3.2 及以上版本号的 Rails 。支持1.8.7 、 1.9.2 、 1.9.3 、2.0.0, 、 2.1 等版本号的 Ruby 。后面我选择 RailsInstaller-2.2.4 来安装 Ruby 和 Rails ,它里面包括的 Rails 版本号是 3.2.19 , Ruby 版本号是 1.9.3p545 。符合 Redmine 的要求。
Redmine支持 MySQL 作为数据库后端。须要 5.0 或更高的版本号。
我选择社区版 server ,版本号号为 5.5.40 。
ImageMagick是可选依赖,用于将 Remine 中的项目数据如甘特图等导出为 png 图片。其他的可选依赖还有版本号管理工具。比方 svn 。Redmine 能够与版本号管理系统整合。假设你要支持 Open ID 。还须要 Ruby OpenID Library 。2 或者更高 版本号。
好啦。如今開始秀安装过程。
RailsInstaller安装
图省事了。使用 RailsInstaller 来配置 Rails 和 Ruby ,它是一键安装,非常easy。
站点在这里:RailsInstaller 。
按下图所看到的,选择 Windows 下的安装包来下载:
本文写作时 RailsInstaller 的版本号为 2.2.4 ,它带的 Ruby 和 Rails 是用 mingw32 编译出来的, MySQL 要匹配的。也得是 32 位。
安装过程就是一路狂点 Next 。首先是欢迎页:
二话不说。猛戳 Next button,出现许可协议页面:
接受吧,然后再戳 Next button,让你选安装位置还有附加的软件及设置。例如以下图:
须要的空间也不大,咱都选上吧。点击 Install button,開始安装了。
例如以下图:
等着吧,还能干么……
看到下图就 OK 啦:
点击 Finish 吧,亲。然后呢。你看到了 Ruby and Rails 的命令行环境:
到此为止, Ruby 和 Rails 安装就绪。
MySQL安装
MySQL的官网截图例如以下:
你能够随便选择某个版本号,大于 5 就可以。
我使用 5.5.40 x86 32bit MSI installer 。下载了 mysql-5.5.40-win32.msi 。以下是安装欢迎界面:
我是 Next 控,仅仅会点 Next ,点吧点吧不是罪……看呢,协议页面:
惟有接受,才干享受猛戳 Next 的快乐。
戳下,到安装类型页面:
我选了完整安装。也没多占多大空间。再戳 Next ,到准备就绪界面了:
用你无奈的手指,点 Install 吧,然后我们就仅仅能看着进度条发呆了:
咋个回事儿,你造吗?竟然出来了企业版的界面:
Cancel 和 Back 都被灰掉啦,有点儿跟团旅游被强制购物的感觉……没辙啦,带着气儿戳 Next 吧,看看它能变出啥子花样来。
再 Next 吧,耶,木有咧,回到进度条啦哈,原来仅仅是个宣传,而已,没那么坏哈……
以下是安装完毕界面:
MySQL 装完还要做一下配置。你看上图中那个复选框。默认是选中的。
假设本机没有已经配置过的 MySQL ,由他去吧,点击你最爱的 Finish button吧!
(要是安装过而且设置了 MySQL 的 root 账号password,可能有问题,你别选这个 "Launch the MySQL Instance Configuration Wizard" 选项,跑到開始菜单或者安装文件夹下的 bin 文件夹。找到 MySQLInstanceConfig 点下好啦。向导会给你个机会改动 root 的password的。)
我的计算机上原来被同事安装过 MySQL ,我以为删掉啦……结果呢,碉堡的事儿在后面,咱先按下不提吧,来看 MySQL 配置向导咧:
Next 党们,欢乐地戳吧。接下来就让你选配置类型啦:
我选了 Standard Configuration 。继续 Next ,抵达 Service 配置了:
如上图所看到的。我选择了安装 Windows 服务和开机启动,另外把 MySQL 的 bin 文件夹加入到了系统环境变量 PATH 中,这样随时随地就能够訪问了。
戳 Next 吧。然后就该设置账号啦:
我选择了 Modify Security Settings ,不想埋地雷就没有创建匿名用户。欢快的戳了下 Next ,我到了准备就绪的页面:
能看到它。好开心!还等嘛。赶紧拥抱 Execute 吧。注意,開始运行你之前的配置喽:
我心里哼着小曲儿。就等着它往出蹦 Finish 界面呢,谁知道,受了惊吓。请看:
哇喔,安全设置失败!要么是由于防火墙设置导致连接不上 3306 端口,要么是之前有安装 MySQL ,卸载时没有清除数据文件夹,导致 root 的password还在那里。
我是哪种呢……
我认为可能是防火墙吧。由于同事说 MySQL 已经删除了。于是我把 mysqld 、 mysql 等等都加入到例外中,然后又到入站规则那里设置了 3306 端口的规则,费了半天劲。最后回来 Retry 。嘿嘿,又弹这个。
我仅仅好叫来我的同事,询问之前的 MySQL password……然后呢, Skip 了。
回到 bin 文件夹,找到 MySQLInstanceConfig 来运行,保持刚才那一路辛苦的配置。到了改动账号这里了,例如以下图:
看看。看看,有不同吧……
这个插曲告诉我们。前戏一定要充分,不然的话……
这次搞下来后,顺利看到了期待已久的 Finish 啊:
数据库配置 OK 啦,亲们!
ImageMagick安装
到这里去下载:
选择 ImageMagick-6.8.9-8-Q16-x86-dll.exe 那个下载吧。
然后运行它。
我决定先不装这玩意儿啦,先把 Redmine 跑起来看看。后面须要再配置。
Redmine安装与配置
Redmine 到这里下载:http://www.redmine.org/projects/redmine/wiki/Download 。
记住是版本号 2.5.2 哦。
zip 包下载完毕后,解压到 C:\Sites 文件夹以下。这就安装完咧!
以下是配置,挠人的时刻就这么来了,不知道该是欢喜还是悲伤……
拷贝libmysql
为了 Redmine 能够正常连接 MySQL 。须要 MySQL 的 C API 库。即 libmysql.dll 。在这里:
复制到 Ruby 的 bin 文件夹下。如图所看到的:
安装mysql2
Redmine 须要 mysql2(MySQL 针对 Ruby 的 C binding )据说能够提高性能,你能够在 Ruby and Rails 的命令行环境中运行以下的命令来安装:
gem install mysql2
只是我这里出错了哎……
乖乖,缺少 thread.h 。检查了下。 Ruby 中还真没这个头文件。
网络一顿盲搜,时光飞逝啊。我怒了,尼玛,我要找个 thread.h 。我要换 Ruby 版本号!
寻寻觅觅寻不到, thread.h 的踪迹……后来啊,我来到了这里:
啊哈。没错, rubyinstaller.org ,就是它了。我挑了 Ruby 2.0.0-p576 下载,找到 7z 包中的 ruby/thread.h 文件,复制到 C:\RailsInstaller\Ruby1.9.3\include\ruby-1.9.1\ruby 文件夹以下。
万事大吉了吗?
再次运行 gem install mysql2 。又错啦……
霍霍。找不到 mysqlclient 这个库!
依据错误信息,须要指定 mysql c connector 的位置。
使用 --with-mysql-dir 能够指定 mysql 的位置。然后 gem 安装依赖时就会使用指定位置下的 mysql 头文件和库文件。须要说明的是,路径中不能有空格,像 Program Files(x86) 这样的路径会出错,所以我拷贝了 include 和 lib 文件夹,放在 c:\mysql_sdk 文件夹下。因此我运行以下的命令:
gem install mysql2 -- --with-mysql-dir="C:/mysql_sdk"
这次会通关吗?心中忐忑不已……人生的大起大落来得太快。小心肝承受不了呀……你看。事就这样成了:
建库
參考我的建库的图片。里面包括了命令。例如以下:
基本步骤是酱紫的:从開始菜单运行 MySQL 5.5 Comand Line Client ,输入password。登录成功,创建库 redmine ,创建用户 redmine ,授权其訪问 redmine 库。
配置数据库连接
把 C:\Sites\redmine-2.5.2\config文件夹下的 database.yml.example 原地拷贝一份,名字改为 database.yml 。然后用文本编辑器打开它,数据库连接就在 database.yml 中配置。
多幸福啊, Redmine 默认的配置就是针对 MySQL 的。你看:
如图所看到的,我们仅仅须要改动 production这个配置就可以。一般你仅仅要改动 password 就可以(事实上你能够把 username 换成 redmine,password相应)。
比方我的配置:
production:
adapter: mysql2
database: redmine
host: localhost
username: root
password: "zc_redmine"
encoding: utf8
安装依赖
首先要安装 bundler ,Redmine 使用它来维护 gems 依赖。
命令:
gem install bundler
然后要确认你在 C:\Sites\redmine-2.5.2 文件夹以下,不在的话,使用 cd 命令进去,然后运行以下的命令来解决 redmine 须要的依赖:
bundle install --without development test
这里又会尝试安装 mysql2 。由于我们在 production 中指定使用 mysql2 作为数据库适配器。
假设发现已经安装。就直接用本地的。你会看到 Using xxx 之类的信息,例如以下图:
安装过程是漫长的……希望能成功,但是!又夭折啦!
看下图:
原来是 rmagick 啊,先跳过算咧,运行这个命令:
bundle install --without development test rmagick
我的心,在等待。永远在等待……Bingo!有图有真相:
最终能够继续前行啦。真是一把鼻滴一把泪的……
还是要啰嗦两句。假设你 bundle install 失败,能够依据失败提示。看是哪个 gem 有问题。然后单独运行安装操作来查问题在哪里……就这么循环,总能搞定的。
人生须要正能量,一定会搞掂。
生成会话存储秘钥
由于我们的 redmine 版本号是 2.x ,运行这个命令吧:
rake generate_secret_token
上面的命令生成一个随机的 Key , Rails 用它来加密 cookie ……
这么简单一命令,也会错……看图吧:
版本号问题啊,听人劝,这么干:
bundle exec rake generate_secret_token
这里的黎明静悄悄……运行这个命令,竟然木有不论什么 output ,难道是成功了吗?且走着……
创建数据库结构
创建数据库结构,使用以下的命令:
set RAILS_ENV=production
bundle exec rake db:migrate
注意是一条一条运行啊,后面不提醒啦……还有,由于我 rake 版本号问题,仅仅好每次调用 rake 时都在前面附加 bundle exec 喽。
它会创建一系列的表。设置表的权限,还会创建一个管理员账号,就是天上地下无人不知的 admin 。password也是 admin 。
看到以下这个图。说明 OK 啦啦啦:
数据库默认数据设置
使用以下的命令来向数据库中插入默认的配置数据:
set RAILS_ENV=production
bundle exec rake redmine:load_default_data
一条一条运行。
第二条运行时。会然我们设置语言。如图所看到的:
我选择了 zh ,然后回车。非常快就 OK 啦:
又过了一关……我们还要走,由于。安踏,永不止步。
測试安装
不知不觉,竟然到了这一步!这是要结束的节奏吗?
废话少说,赶紧的,运行以下的命令:
ruby script/rails server webrick -e production
你是我的眼,带我领略这四季的变换……快告诉我,你是不是看见了这个图:
恭喜你。 redmine 已成功启动!
从输出信息看到,它监听了 0.0.0.0:3000 ,所以你能够訪问 http://localhost:3000 看看效果。也能够訪问实际的 ip 地址,比方 http://192.168.1.30:3000 。效果例如以下图所看到的:
点击右上角的登录,能够看到以下的页面:
还记得我们的 admin 账号吗。输入进去,点击登录button,就进去了,随便点点,可能看到这个界面:
好啦。到此为止。你能够享受下管理员无上的权力带来的快感。你能够定义角色,定义工作流程,创建成员……哇哦。真的好厉害。
只是,万里长征刚刚開始,环境才就绪,怎样把项目管理过程在 Redmine 中体现出来,但是路漫漫其修远……