Redmine的安装、总结和心得

系统管理员 2022-06-15 10:58 444阅读 0赞

**一．安装：**

1.       安装Redmine，注意版本的控制，如：redmine的版本是：1.3.2则相应的：Ruby 1.8.7、rails 2.3.14、rack 1.1.1；

2.       利用RailsInstaller一键式安装Ruby，Rails，Rake等一系列东西，单个去安装配置，相当容易出错，而且很繁琐；由于选择redmine-1.3.2，所以选择下载RailsInstaller-1.1.1.exe，安装railsinstaller的目的在于获得redmine所需要的支持ruby的各个组件。这时会自动在C盘下面生成一个Sites目录：![1351417585_5403.png][]

railsinstaller安装完成后会自动弹出一个dos窗口，命令符停留在“C:\\Sites”下，关闭了dos窗口，重新通过运行cmd开启：

![1351417608_9051.png][]

把redmine1.3.2整个文件夹复制到安装railsinstaller后所产生的sites目录下(该目录在C盘根目录)，通过DOS进入redmine1.3.2目录下。

![1351417665_6604.png][]

根据redmine的要求，rails需要2.3.14版本，运行以下命令安装rails2.3.14：

gem install rails -v=2.3.14

完成rails安装后，安装rack 1.1.1版本，这个是redmine 1.3.2所要求的。运行命令：

gem install rack -v=1.1.1

完成rack安装后，继续运行命令：

gem install -v=0.4.2 i18n

![1351417687_4373.png][]

3.       安装[MySQL][]:

双击mysql-5.5.9-win32.msi，进入如下画面：

![1351417834_8784.jpg][]

继续点击next，进入下一个画面，如下：

![1351417850_9879.jpg][]

Typical是指典型安装，Complete是完全安装，Custom自定义安装，我们选择自定义安装，点击next，如下画面：

![1351417871_1977.jpg][]

点击下方“Change”更改安装目录。 在“MySQL Server（MySQL服务器）”上左键单击，选择“This feature,and all subfeatures, will be installed on local hard drive.”，即“此部分，及下属子部分内容，全部安装在本地硬盘上”，你也可以手动指定安装目录：

![1351417898_3696.jpg][]

都更改好后，点击next记如下一个画面：

![1351417920_7974.jpg][]

确认一下先前的设置，尤其是两个安装路径，如果有误，”Back”返回重做。确定后点击”Install”开始安装，安装完成后，出现如下画面：

![1351417930_2680.jpg][]

继续点击next，进入下一步：

![1351417945_9028.jpg][]

选中”Configure theMysql Server now(开始配置MYSQL)“前面的勾打上，点”Finish”结束软件的安装并启动mysql配置向导，进入如下画面：

![1351417976_2271.png][]

继续点击next，如图：

![1351418096_6527.png][]

这里是选择配置方式：

“DetailedConfiguration（手动精确配置）”

“StandardConfiguration（标准配置）”

选择“DetailedConfiguration”，点击next，进行详细配置：

![1351418122_9899.png][]

第一步，选择服务器类型：

“DeveloperMachine（开发测试类，mysql 占用很少资源）”；

“ServerMachine（服务器类型，mysql占用较多资源）”；

“DedicatedMySQL Server Machine（专门的数据库服务器，mysql占用所有可用资源）”，我由于在自己电脑上所以选择选择第一个，点击next，继续：

![1351418148_3187.png][]

第二步选择mysql数据库的用途：

“MultifunctionalDatabase（通用多功能型）”；

“TransactionalDatabase Only（服务器类型，专注于事务处理）”；

“Non-TransactionalDatabase Only（非事务处理型，较简单，主要做一些监控、记数用，对MyISAM数据类型的支持仅限于non-transactional），

这里我选择”MultifunctionalDatabase”，按next继续：

![1351418196_3605.jpg][]

第三步对InnoDBTablespace进行配置，就是为InnoDB 数据库文件选择一个存储空间，如果修改了，要记住位置，重装的时候要选择一样的地方，否则可能会造成数据库损坏，当然，对数据库做个备份就没问题了。使用默认位置就可以了，点击next继续：

![1351418336_8921.png][]

第四步选择您的网站的一般mysql 访问量，同时连接的数目：

“DecisionSupport(DSS)/OLAP（20个左右）”；

“OnlineTransaction Processing(OLTP)（500个左右）”；

“ManualSetting（手动设置，自己输一个数）”，

由于我主要在自己机器上做开发测试用，我这里选”ManualSetting”，然后选填的是10个连接数，点击next，继续下一步配置：

![1351418352_9077.png][]

第五步，是否启用TCP/IP连接，设定端口，如果不启用，就只能在自己的机器上访问mysql 数据库了，如果启用，把前面的勾打上，Port Number（端口号）：3306，”Add firewallexception for this port”是一个关于防火墙的设置，将监听端口加为windows防火墙例外，避免防火墙阻断。还有一项”Enable StrictMode（启用标准模式）”，如果选中MySQL就不会允许细小的语法错误。如果您还是个新手，我建议您取消标准模式以减少麻烦。但熟悉MySQL以后， 尽量使用标准模式，因为它可以降低有害数据进入数据库的可能性。都配置好后，点击next继续：

![1351418374_6658.png][]

第六步，选择数据库编码，就是对mysql默认数据库编码进行设置，第一个是西文编码，第二个是多字节的通用utf8编码，第三个可以在 Character Set下拉框多种编码中进行自由选择，我们常使用的就是gbk、gb2312和utf8，需要注意的是如果要用原来数据库的数据，最好能确定原来数据库用的是什么编码，如果这里设置的编码和原来数据库数据的编码不一致，在使用的时候可能会出现乱码，点击 next继续配置：

![1351418387_7141.png][]

第七步.由于我已经安装过，所以“Install setthe Windows options”项是灰色的。

选择是否将mysql 安装为windows服务，还可以指定Service Name（服务标识名称），是否将mysql的bin目录加入到Windows PATH（加入后，就可以直接使用bin下的文件，而不用指出目录名，比如连接，”mysql.exe-uusername -ppassword;”就可以了，不用指出mysql.exe的完整地址，很方便），我这里全部打上了勾，Service Name不变，按”Next”继续：

![1351418405_8501.png][]

第八步，设置服务器默认管理员密码 ，这里需要记住password，在通过DOS进入MySql时需要验证。“Enable rootaccess from remotemachines（是否允许root 用户在其它的机器上登陆，如果要安全，就不要勾上，如果要方便，就勾上它）”。最后一项“Create AnAnonymous Account（新建一个匿名用户，匿名用户可以连接数据库，不能操作数据，包括查询）”，一般就不用勾了，完成后，点击next继续：

![1351418418_3678.png][]

确保你上面的设置无误后，点击Execute，是设置生效，如果有误，按Back返回检查。 在点击Execute后的过程中，有可能弹出如下弹窗：

![1351418430_3966.jpg][]

不用担心，点下OK就可以了，这是因为你在前面选择了”Add firewallexception for this port”，而防火墙没有开启引起的，如果关闭防火墙和杀毒软件就不会出现，不过不会对配置造成影响。设置完成后，按”Finish”结束MySql5的安装与配置。

安装成功后应显示如下界面：

![1351418569_5021.png][]

接下来需要创建MySql的库、用户、赋权，等。

a.      通过DOS进入MYSQL安装目录，输入正确的password：

![1351418589_1758.png][]

b.      创建数据库，运行以下命令符：

createdatabase redmine character set utf8;

运行：

createdatabase redmine\_development character set utf8;

运行：

createdatabase redmine\_test character set utf8;

如下图：

![1351418656_8530.jpg][]

c.      创建Redmine数据库的用户及密码，并赋予权限：（’’引号之间需修改为自己的用户名、服务器名、密码）

create user ‘redmine’@’localhost’identified by ‘password’;

无错误提示，则表示创建成功。

下面进行赋权操作：

grant allprivileges on redmine.\* to ‘redmine’@’localhost’;

如果在创建过程中出现什么错误，可以使用下面命令删除用户：

drop user‘redmine’@’localhost’;

以上创建暂时结束。

以我自己电脑为例，将C:\\Sites\\redmine-1.3.2\\config\\database.yml.example复制后重命名为database.yml如下截图：

![1351418707_4915.png][]

修改该文件（即：database.yml文件）中的“ production ”段的数据库配置。例如：

production:

adapter: mysql

database:redmine

host:localhost

username: root（这里填写你希望用来登录 MySQL 的用户名）

password:password （这里填写用户密码）

我自己电脑上的配置是：

production:

adapter: mysql

database: redmine

host: localhost

username: redmine

password: chris

encoding: utf8

回到上面的DOS界面，使用如下命令创建数据库结构：

rakedb:migrate RAILS\_ENV=”production”

此处还有可能出现的错误如下：

a.      如果出现“Mysql::Error:The ‘InnoDB’ feature is disabled”错误，需要开启MySql数据库对InnoDB的支持，在你的mysql安装文件夹中打开my.ini文件，找到skip-innodb，改成\#skip-innodb，然后重启mysql(注：可以通过MySQL命令show variableslike “have\_%”;查看是否开启了InnoDB);

![1351418751_2180.jpg][]

如果出现了上图所示的错误，则需要修改redmine安装目录\\config\\environment.rb脚本。

打开environment.rb脚本后，在bootStrap和initialization之间添加如下语句：

\#在bootStrap和initialization之间添加语句 –espie

ifGem::VERSION >= “1.3.6”

module Rails

classGemDependency

defrequirement

r = super

(r ==Gem::Requirement.default) ? nil : r

end

![1351418786_9717.jpg][]

如上图所示，之后保存退出。

c.      我当时运行时提示错误：“!!! Thebundled mysql.rb driver has been removed from Rails 2.2. Please install themysql gem and try again: gem install mysql.rake aborted!no such file to load –mysql ”

解决方案是：运行命令符：gem installmysql。

从mysql的安装目录下找到libmysql.dll文件拷贝至ruby（ruby的安装目录在RailsInstaller的安装下，以我自己电脑为例：D:\\ProgramFiles\\Redmine\\RailsInstaller\\Ruby1.8.7）的bin目录下。这里特别要注意版本兼容问题，MySql版本是5.5与rails2.3.14不兼容，需要找一个老版本的libmysql.dll文件替换就可以了，这里需要将我Installsoftware文件夹中的“libmySQL.dll”文件复制到MySql安装目录中的lib文件夹下和Ruby安装目录\\bin\\目录下。

这一步若正常运行，会输出一下内容：

![1351418832_9366.png][]

以上没有问题后，运行命令符：

rakeredmine:load\_default\_data RAILS\_ENV=”production”

![1351418850_5549.png][]

该命令将填充默认的配置数据。该命令运行过程中需要选择语言，输入zh（ 简体中文），成功后如上图所示。如果没有成功，可能是上一步没有成功所导致的。

4.      最后，在DOS下进入redmine-1.3.2，通过以下命令符来启动：

ruby script/server webrick -e production

在这里可能提示没有session，可以输入rake generate\_session\_store来解决。

如下图，说明启动成功。

![1351418880_4953.png][]

打开浏览器，输入：[http://localhost:3000][http_localhost_3000]。账号，密码都是admin。登录后，进入帐号后，在 “我的账号”里设置语言为中文。

二．备注：

1.       局域网访问慢：

局域网访问Redmine速度慢的突出原因是webrick需要解析目标地址的主机，所以慢。网上比较流行的解决方案是：换一个web服务器，比如：mongrel

a.  在ruby的DOS环境下输入:                 gem install mongrel

b.  安装：gem installmongrel

启动：ruby script/servermongrel -e production –d

2.          修改Redmine端口号：

![1351418929_9896.png][]

3.       配置邮件通知：

Redmin可以为一些操作提供邮件通知如主题改变，新增问题等，这样可以让开发人员及时知道变化。在使用此功能前需要先配置邮件服务器，将C:\\Sites\\redmine-1.3.2\\config目录下的configuration.yml.example更名为configuration.yml，然后用文本编辑器打开此文件，将内容改为如下：

如果配置的是Gmail邮箱：

在Redmine根目录下面运行：

rubyscript/plugin installgit://github.com/collectiveidea/action\_mailer\_optional\_tls.git

运行以上命令符后：

![1351418959_4446.png][]

后面还需要修改，现尚还不清楚。

我采用的是163邮箱。

打开configuration.yml文件，找到：production:开头的地方，如下图：

“此处涉及到公司内容，已将图片删除”

输入上图中的代码，严重注意格式问题，包括空格。

测试是否配置成功：

打开Redmine >管理员登陆 > 管理 > 配置 > 邮件通知 >页面底部:发送测试邮件。将会发送邮件到你目前登陆的用户邮箱中。

可以在这个页面中进行邮件内容的配置，包括邮件头，邮件签名等。还可以在这个页面中选择需要发送邮件通知的动作。

异步发送邮件配置:

当delivery\_method设置为:smtp时, 它的处理流程是这样的:

在触发邮件发生的事件发生后, 首先发送邮件, 直到邮件发送完毕, 页面才跳转. 这就是说在发送邮件的过程中, 页面一直处于等待状态.

那么有没有一种异步发送邮件机制呢? 在Redmien 0.9 之后, 可通过将delivery\_method设置为:async\_smtp, 这时发送邮件和页面跳转属于不同的线程, 当触发邮件的事件发生后, 发送邮件将会通过消息队列在后台执行, 而页面继续向下执行, 不用等到邮件发送完毕

4.       在redmine中，加入自己公司的logo标记

a.       修改“app/views/layouts/base.rhtml”文件

找到

将其注释掉

<！–h1><%=page\_header\_title %></h1–>

增加如下代码

Html代码

<img src=”<%= Redmine::Utils.relative\_url\_root %>/images/easybiz.png” height=”45″ style=”top-margin: 15px; left-margin: 15px;”/>

其中 easybiz.png就是自己公司的图片文件,<%=Redmine::Utils.relative\_url\_root %>是获取redmine的安装目录

b.       将easybiz.png放到public\\images目录下

注意图片的长度和宽度，宽度不要超过50，长度不要超过600.

c.        重启redmine即可

以上多数图片是本人在安装过程中的真实截图，在安装mysql部分的图片是借用网上资源，若无意侵权或冒犯之处，还望作者尽快联系我，我便及时作出修改或撤销。

http://www.redmine.org.cn/463.html

[1351417585_5403.png]: /images/20220615/c41c1b33007c4542a25e3e86545e252b.png
[1351417608_9051.png]: /images/20220615/253f34cd401643c68cbf971b77b6cf82.png
[1351417665_6604.png]: /images/20220615/f718f29c286740128ac06bfd756a09a6.png
[1351417687_4373.png]: /images/20220615/3595960c93ba42309dc6be20ccf75026.png
[MySQL]: http://lib.csdn.net/base/14
[1351417834_8784.jpg]: /images/20220615/7401cc4f659b4c3db8c58bb4bb50f571.png
[1351417850_9879.jpg]: /images/20220615/facb3ecec78444038b022bdd2eaf0e93.png
[1351417871_1977.jpg]: /images/20220615/54c224c3dab04ddaa90784bcf419164c.png
[1351417898_3696.jpg]: /images/20220615/989604148a9042a5a3448c3a1416a9b0.png
[1351417920_7974.jpg]: /images/20220615/36fdc209296040e4baf156ba97f4b3ef.png
[1351417930_2680.jpg]: /images/20220615/2fc239fbf4034d528ee2ebf731780c57.png
[1351417945_9028.jpg]: /images/20220615/e7e4e596f1f144b19862d2ff1dec5101.png
[1351417976_2271.png]: /images/20220615/6ab10b41350e4b9ab6d99f00aa3e3058.png
[1351418096_6527.png]: /images/20220615/b48e2826e42d4f85b1ace160de4401d7.png
[1351418122_9899.png]: /images/20220615/f1165566372948daa9b5f5918b904eb9.png
[1351418148_3187.png]: /images/20220615/5c19fb1eb4cf48c69b6b02fd6722a662.png
[1351418196_3605.jpg]: /images/20220615/4f197cc1cca64101882e1bee849e0174.png
[1351418336_8921.png]: /images/20220615/f88dc201d21541fcb8690c039837f345.png
[1351418352_9077.png]: /images/20220615/bd82838e398545d0a04378886f75e03a.png
[1351418374_6658.png]: /images/20220615/d768cd58b6234fba98aa53b3aecb92d8.png
[1351418387_7141.png]: /images/20220615/0f6440c932c84c68801c109abe93495c.png
[1351418405_8501.png]: /images/20220615/faa54933c3b3498eab0287a25de3453e.png
[1351418418_3678.png]: /images/20220615/67433d90395d49c2ad36dd3b1b21eae9.png
[1351418430_3966.jpg]: /images/20220615/636f4c23dcad40f0b9c0467b4b8c4b6a.png
[1351418569_5021.png]: /images/20220615/847aa883690048bca598c5dcece786aa.png
[1351418589_1758.png]: /images/20220615/a1383fe7dae84c998aa211338d1251a3.png
[1351418656_8530.jpg]: /images/20220615/779ba7071f6a4dd28c177161be746edf.png
[1351418707_4915.png]: /images/20220615/f7f0b47d935741899db521a7ade4962e.png
[1351418751_2180.jpg]: /images/20220615/8a89023df283429f965ceedf6742e6ba.png
[1351418786_9717.jpg]: /images/20220615/8981245493144375a1034a1bfc8432c2.png
[1351418832_9366.png]: /images/20220615/d964dc76661e4e73bb5bae38d4fd1085.png
[1351418850_5549.png]: /images/20220615/c1a165632672491dbe078ae398f95bda.png
[1351418880_4953.png]: /images/20220615/c56dfcf9fa8d488c923b4a2215317042.png
[http_localhost_3000]: http://localhost:3000/
[1351418929_9896.png]: /images/20220615/6c0a1795388f4c9a9340ae653ac7ccf3.png
[1351418959_4446.png]: /images/20220615/8cc90262b2534dc0a6d017c42297cb62.png