Windows下安装Redmine 2.5.2不全然指南

    我决定在项目中引入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:RailsInstallerRuby1.9.3include uby-1.9.1 uby 文件夹以下。

    万事大吉了吗?

    再次运行 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 edmine-2.5.2config文件夹下的 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 edmine-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 中体现出来,但是路漫漫其修远……


原文地址:https://www.cnblogs.com/mthoutai/p/7351105.html