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目录:
railsinstaller安装完成后会自动弹出一个dos窗口,命令符停留在“C:\Sites”下,关闭了dos窗口,重新通过运行cmd开启:
把redmine1.3.2整个文件夹复制到安装railsinstaller后所产生的sites目录下(该目录在C盘根目录),通过DOS进入redmine1.3.2目录下。
根据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
3. 安装MySQL:
双击mysql-5.5.9-win32.msi,进入如下画面:
继续点击next,进入下一个画面,如下:
Typical是指典型安装,Complete是完全安装,Custom自定义安装,我们选择自定义安装,点击next,如下画面:
点击下方“Change”更改安装目录。 在“MySQL Server(MySQL服务器)”上左键单击,选择“This feature,and all subfeatures, will be installed on local hard drive.”,即“此部分,及下属子部分内容,全部安装在本地硬盘上”,你也可以手动指定安装目录:
都更改好后,点击next记如下一个画面:
确认一下先前的设置,尤其是两个安装路径,如果有误,”Back”返回重做。确定后点击”Install”开始安装,安装完成后,出现如下画面:
继续点击next,进入下一步:
选中”Configure theMysql Server now(开始配置MYSQL)“前面的勾打上,点”Finish”结束软件的安装并启动mysql配置向导,进入如下画面:
继续点击next,如图:
这里是选择配置方式:
“DetailedConfiguration(手动精确配置)”
“StandardConfiguration(标准配置)”
选择“DetailedConfiguration”,点击next,进行详细配置:
第一步,选择服务器类型:
“DeveloperMachine(开发测试类,mysql 占用很少资源)”;
“ServerMachine(服务器类型,mysql占用较多资源)”;
“DedicatedMySQL Server Machine(专门的数据库服务器,mysql占用所有可用资源)”,我由于在自己电脑上所以选择选择第一个,点击next,继续:
第二步选择mysql数据库的用途:
“MultifunctionalDatabase(通用多功能型)”;
“TransactionalDatabase Only(服务器类型,专注于事务处理)”;
“Non-TransactionalDatabase Only(非事务处理型,较简单,主要做一些监控、记数用,对MyISAM数据类型的支持仅限于non-transactional),
这里我选择”MultifunctionalDatabase”,按next继续:
第三步对InnoDBTablespace进行配置,就是为InnoDB 数据库文件选择一个存储空间,如果修改了,要记住位置,重装的时候要选择一样的地方,否则可能会造成数据库损坏,当然,对数据库做个备份就没问题了。使用默认位置就可以了,点击next继续:
第四步选择您的网站的一般mysql 访问量,同时连接的数目:
“DecisionSupport(DSS)/OLAP(20个左右)”;
“OnlineTransaction Processing(OLTP)(500个左右)”;
“ManualSetting(手动设置,自己输一个数)”,
由于我主要在自己机器上做开发测试用,我这里选”ManualSetting”,然后选填的是10个连接数,点击next,继续下一步配置:
第五步,是否启用TCP/IP连接,设定端口,如果不启用,就只能在自己的机器上访问mysql 数据库了,如果启用,把前面的勾打上,Port Number(端口号):3306,”Add firewallexception for this port”是一个关于防火墙的设置,将监听端口加为windows防火墙例外,避免防火墙阻断。还有一项”Enable StrictMode(启用标准模式)”,如果选中MySQL就不会允许细小的语法错误。如果您还是个新手,我建议您取消标准模式以减少麻烦。但熟悉MySQL以后, 尽量使用标准模式,因为它可以降低有害数据进入数据库的可能性。都配置好后,点击next继续:
第六步,选择数据库编码,就是对mysql默认数据库编码进行设置,第一个是西文编码,第二个是多字节的通用utf8编码,第三个可以在 Character Set下拉框多种编码中进行自由选择,我们常使用的就是gbk、gb2312和utf8,需要注意的是如果要用原来数据库的数据,最好能确定原来数据库用的是什么编码,如果这里设置的编码和原来数据库数据的编码不一致,在使用的时候可能会出现乱码,点击 next继续配置:
第七步.由于我已经安装过,所以“Install setthe Windows options”项是灰色的。
选择是否将mysql 安装为windows服务,还可以指定Service Name(服务标识名称),是否将mysql的bin目录加入到Windows PATH(加入后,就可以直接使用bin下的文件,而不用指出目录名,比如连接,”mysql.exe-uusername -ppassword;”就可以了,不用指出mysql.exe的完整地址,很方便),我这里全部打上了勾,Service Name不变,按”Next”继续:
第八步,设置服务器默认管理员密码 ,这里需要记住password,在通过DOS进入MySql时需要验证。“Enable rootaccess from remotemachines(是否允许root 用户在其它的机器上登陆,如果要安全,就不要勾上,如果要方便,就勾上它)”。最后一项“Create AnAnonymous Account(新建一个匿名用户,匿名用户可以连接数据库,不能操作数据,包括查询)”,一般就不用勾了,完成后,点击next继续:
确保你上面的设置无误后,点击Execute,是设置生效,如果有误,按Back返回检查。 在点击Execute后的过程中,有可能弹出如下弹窗:
不用担心,点下OK就可以了,这是因为你在前面选择了”Add firewallexception for this port”,而防火墙没有开启引起的,如果关闭防火墙和杀毒软件就不会出现,不过不会对配置造成影响。设置完成后,按”Finish”结束MySql5的安装与配置。
安装成功后应显示如下界面:
接下来需要创建MySql的库、用户、赋权,等。
a. 通过DOS进入MYSQL安装目录,输入正确的password:
b. 创建数据库,运行以下命令符:
createdatabase redmine character set utf8;
运行:
createdatabase redmine_development character set utf8;
运行:
createdatabase redmine_test character set utf8;
如下图:
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如下截图:
修改该文件(即: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);
b.
如果出现了上图所示的错误,则需要修改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
end
end
end
如上图所示,之后保存退出。
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\目录下。
这一步若正常运行,会输出一下内容:
以上没有问题后,运行命令符:
rakeredmine:load_default_data RAILS_ENV=”production”
该命令将填充默认的配置数据。该命令运行过程中需要选择语言,输入zh( 简体中文),成功后如上图所示。如果没有成功,可能是上一步没有成功所导致的。
4. 最后,在DOS下进入redmine-1.3.2,通过以下命令符来启动:
ruby script/server webrick -e production
在这里可能提示没有session,可以输入rake generate_session_store来解决。
如下图,说明启动成功。
打开浏览器,输入: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端口号:
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
运行以上命令符后:
后面还需要修改,现尚还不清楚。
我采用的是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>
将其注释掉
<!–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部分的图片是借用网上资源,若无意侵权或冒犯之处,还望作者尽快联系我,我便及时作出修改或撤销。
回想当初花了整整7天时间去不要命的完成这件事时,总是很骄傲,时时刻刻提醒着自己,不能让他们任何人看不起我,所以我会很认真、用心的去做每一件事。
最后写上一句一直陪伴鼓励我的话:“一份耕耘,一份收获”