redmine安装指南

kosei0621 贡献于2016-10-12

作者 cmcc  创建于2016-03-04 08:56:00   修改者cmcc  修改于2016-03-07 06:55:00字数4527

文档摘要:
关键词:

本人因为单位需要上一套项目管理软件,就选择了Redmine,主要是看中他的开源、插件丰富、具有中文支持的特点。因为之前接触ROR和Mysql不多,我参考了网上大量文章,同时安装时又遇到诸多曲折。因此把我的安装过程细化至每一个步骤,形成图文安装指南,希望对大家有用。 这篇博文主要参考了如下文章: http://www.redmine.org/projects/redmine/wiki/RedmineInstall http://xinlanzero.iteye.com/blog/857494 有关BUG的疑难解答主要参考: http://www.redmine.org/boards/2/topics/22358 http://www.redmine.org/issues/7516 http://www.redmine.org/boards/2/topics/6423?r=6447 http://rordiary.com/blog/2010/03/192/ 安装准备 先下载下面这些安装过程中要用到的软件,如上图所示: 1. Ruby 1.8.7:http://www.rubyforge.org/frs/download.php/74293/rubyinstaller-1.8.7-p334.exe 2. MySQL:http://www.mysql.com/downloads/mysql/5.5.html#downloads 3. Redmine 主程序:http://www.redmine.org/projects/redmine/wiki/Download 4. Win32 OpenSSL Light:  http://www.slproweb.com/download/Win32OpenSSL_Light-1_0_0d.exe 5. Visual C++ 2008 Redistributables :  http://www.microsoft.com/downloads/details.aspx?familyid=9B2DA534-3E03-4391-8A4D-074B9F2BC1BF&displaylang=en (如果不安装这个,调用 OpenSSL 时可能会报“应用程序配置不正确,程序无法启动,重新安装应用程序可能解决问题。”错误) 6. ZLib 1.2.5: http://www.zlib.net/zlib125-dll.zip (这个地址貌似失效了……那我这个版本哪里来的……汗……那就试试这个吧:http://ishare.iask.sina.com.cn/f/9662774.html) 7. libiconv 1.9.2: http://sourceforge.net/projects/gnuwin32/files/libiconv/ (运行 rake 时要用到) 安装与配置 安装Ruby 1. 安装Ruby运行环境(rubyinstaller-1.8.7-p334.exe),如上图 2. 注意在安装过程中,勾选如上两项 3. 开始安装,直至安装完成。 4. 运行开始菜单中的“Start Command Prompt with Ruby”,打开Ruby命令行 5. 输入如下命令,安装Rails框架: gem install rails -v=2.3.5 Ruby会连接网络下载Rails框架文件及文档,并自动开始安装。此过程时间较长,约10分钟左右。如上图所示。如没有报错信息,则继续下一步安装。 6. 输入如下指令,安装Rake: gem install rack -v=1.0.1 7. 输入如下指令,安装MySQL的C bindings: gem install mysql 该命令将在线安装 MySQL 的 C bindings,可明显提高访问数据库的性能 安装MySQL 1. 运行mysql-5.5.9-win32.msi开始安装,如上图所示 2. 安装完成,使用“MySQL Instance Configuration Wizard”,开始配置MySQL,如上图所示 选择详细配置,以调整参数,如上图 选择服务器环境,MySQL会合理利用现有内存;如果是自己机器上安装,那可以选择开发者机器环境,这样不会占用太多资源。 开启TCP/IP网络,设置合理的数据库端口,如上图。 这里要选择手动设置默认字符集:UTF8,如上图。 这里要勾选“安装为Windows服务”,以及“包含在windows Path环境变量中添加BIN目录”,如上图。 设置服务器默认管理员密码。如上图。 配置完成后,系统开始进行配置,顺利的话将显示上图结果页面。 3. 打开Windows命令行,切换到Mysql安装目录下的Bin目录(我是个小白,但这个切换就不用多讲了吧?),之后使用如下命令进入MySQL命令行: Mysql –u root -p 回车后,输入服务器密码,登录mysql。之后命令行提示符将切换为”mysql>”,代表登录成功 4. 在 MySQL 命令行模式下运行如下命令,创建Redmine数据库: create database redmine character set utf8; 回车后,该命令将创建一个供 Redmine 使用的数据库。 PS:Mysql数据库命令行最后要以“;”结尾,才能执行。如果你没接触过MySQL这一点很关键:P(因为我就是被这个卡住了) 5. 创建Redmine数据库的用户及密码,并赋予权限:(’’引号之间需修改为自己的用户名、服务器名、密码) create user 'redmine'@'localhost' identified by 'my_password'; 无错误提示,则表示创建成功。 下面进行赋权操作: grant all privileges on redmine.* to 'redmine'@'localhost'; PS:如果创建用户出了什么差错,可以使用如下命令删除用户: drop user 'redmine'@'localhost'; 安装OpenSSL并配置Ruby 1. 安装 Visual C++ 2008 Redistributables 2. 安装 Win32 OpenSSL Light 。如上图 3. 注意在本页选择“ Copy OpenSSL DLLs to The Windows system directory ” 否则在安装完毕后需要手工将 OpenSSL 安装目录下的 DLL 文件复制到 Windows 的系统目录(例如: C:\Windows\system32 ),或 Ruby 的 bin 目录(例如: C:\ruby-1.8.7\bin ) 4. 根据向导完成安装。 如上图所示(呵呵,捐赠就不需要选择了:P) 5. 将 ZLib 1.2.3 的安装包中的 zlib1.dll 解压到 Windows 的系统目录或 Ruby 的 bin 目录,并改名为 zlib.dll 6. 将 libiconv 1.9.1 的安装包中的 bin\iconv.dll 解压到 Windows 的系统目录或 Ruby 的 bin 目录(这一步可以不做) 安装Redmine主程序 1. 将 Redmine 的安装包解压到某个目录(例如: C:\redmine-0.9.1 ),将 config\database.yml.example 复制为 config\database.yml ,并修改该文件中的“ production ”段的数据库配置。例如: production: adapter: mysql database: redmine host: localhost username: root (这里填写你希望用来登录 MySQL 的用户名) password: password (这里填写用户密码) 2. 将MySQL安装目录中的libmySQL.dll文件复制到Ruby安装目录下(如:C:\ruby-1.8.7\bin),然后再Windows 命令行模式下切换目录为 Redmine 的安装目录(如c:\redmine-1.1.1\),运行如下命令: rake config/initializers/session_store.rb 如果出现上图的错误提示,则需要下列语句,安装一个国际化组件后再次执行: gem install –v=0.4.2 i18n 3. 使用如下命令创建数据库结构: rake db:migrate RAILS_ENV="production" 该命令将创建生产用的数据库结构。这是关键的一步,笔者就在此处经过多次尝试后才安装好Redmine,而且这一步可能遇到的问题较多。如果遇到其他问题可以到Redmine上搜索问题的描述,一般都有满意的解答。 PS1:如果出现“Mysql::Error: The 'InnoDB' feature is disabled”错误,需要开启MySql数据库对InnoDB的支持,在你的mysql安装文件夹中打开my.ini文件,找到skip-innodb,改成#skip-innodb,然后重启mysql(注:可以通过MySQL命令show variables like "have_%";查看是否开启了InnoDB) PS2:如果出现了上图所示的错误,则需要修改redmine安装目录\config\ environment.rb脚本。 打开environment.rb脚本后,在bootStrap和initialization之间添加如下语句: #在bootStrap和initialization之间添加语句 --espie if Gem::VERSION >= "1.3.6" module Rails class GemDependency def requirement r = super (r == Gem::Requirement.default) ? nil : r end end end end 如上图所示,之后保存退出。 PS3:  如果出现了上图所示错误,是因为rails 与 mysql for win不兼容所致的。需要将Mysql的libmySQL.dll文件替换为老版本。 从这里下载老版本:  http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll http://rordiary.com/blog/wp-content/uploads/2010/03/libmySQL.zip 之后将替换至Ruby安装目录\bin\目录下。 4. 继续运行如下命令: rake redmine:load_default_data RAILS_ENV="production" 该命令将填充默认的配置数据。该命令运行过程中需要选择语言,一般输入zh( 简体中文),成功后如上图所示。如果没有成功,可能是上一步没有成功所导致的。 启动Redmine主程序 5. 在ruby命令行模式下,切换至Redmine主目录,运行如下命令: ruby script/server webrick -e production 该命令将使用Webrick发布运行 Redmine !运行成功后如上图所示。 6. 打开浏览器,访问如下网址: http://localhost:3000/ ,使用用户 admin (密码 admin )登录试试吧! -------------- SPY is here! 为什么是SPY?因为我叫这个名字已经很久了。

下载文档到电脑,查找使用更方便

文档的实际排版效果,会与网站的显示效果略有不同!!

需要 10 金币 [ 分享文档获得金币 ] 0 人已下载

下载文档