在windows下安装redmine及相关问题

2022-04-29 14:16:19

转载注明出处，adousen的博客http://blog.csdn.net/adousen

redmine是一个ticket驱动项目管理工具，与trac等工具相比，它最大特色是可以在一个实例中同时管理多个项目。

安装和使用

下载安装文件
为了省去下载和配置的麻烦，没有选择redmine官方的安装文件，而是下载bitmami的一键安装包bitnami-redmine-2.6.0-1https://bitnami.com/stack/redmine，它的主要特色有：
- 一键安装，无需配置数据库和初始化
- 部署在apache上，更加灵活。
- 集成了版本控制工具，git或subversion。
- 将redmine注册为windows服务，可以自动启动。
- 提供了一个简单的服务管理工具，方便启动和暂停服务。
- 提供了一键卸载
安装操作。根据项目情况，可以去掉以下组件:
- 由于本机已经安装有mysql workbench，故不需要采用PhpMyAdmin的方式进行数据管理。因此，安装时去掉了PhpMyAdmin。
- 由于项目打算采用git或mercury作为版本控制系统，因此去掉了Subversion。
如果整个安装过程无异常，那么安装结束就已经启动了redmine，因此可以从http://localhost/redmine/访问。

安装过程中的问题

问题1. 安装过程会提示端口3306被占用，原因是本机已经安装有mysql。因此，改为3305端口。
问题2. 由于该版本的bitmami中的mysql安装脚本存在的BUG：scripts目录下的serviceinstall.bat中的有关安装Mysql服务的配置脚本处有一个不应该有的换行。因此，会导致"redmineMySQL" 的服务安装不成功。所以，后续的初始化等数据库相关操作等会报错。
注：如果打算在本机上同时启动两个mysql服务，可以在mysql的scripts目录下找到serviceinstall.bat，修正这个BUG。当然这需要在安装报错之前。但是，对于没有经验的人来说，很难确保自己已经改对了，可以尝试复制下面的代码到serviceinstall.bat，并手动执行serviceinstall.bat INSTALL

(注意修改C:\Bitnami\redmine-2.6.0-1为你的安装路径)：


@echo off
rem -- Check if argument is INSTALL or REMOVE

if not ""%1"" == ""INSTALL"" goto remove

"C:\Bitnami\redmine-2.6.0-1\mysql\bin\mysqld.exe" --install "redmineMySQL" --defaults-file="C:\Bitnami\redmine-2.6.0-1/mysql\my.ini"

net start "redmineMySQL" >NUL
goto end

:remove
rem -- STOP SERVICES BEFORE REMOVING

net stop "redmineMySQL" >NUL
"C:\Bitnami\redmine-2.6.0-1\mysql\bin\mysqld.exe" --remove "redmineMySQL"

:end
exit

实际上，安装出错可以让我们有了比较好的机会在本机原来的mysql上安装redmine数据库，虽然多了后续的手动配置。当然，成功安装后也可以参照下面的步骤将redmine的数据库改本机现有的数据库。

后续问题解决方案

手动完成初始化3306端口的Mysql管理帐号及redmine数据库。
出问题的原因：上面提到的Mysql服务安装不成功，以及C:\Bitnami\redmine-2.6.0-1\apps\redmine\scriptsredmineini.bat脚本未被执行（实际上安装程序都没有拷贝这个脚本至目录下）。这个脚本的内容如下（拷贝自已成功安装的机器）：
```
@echo off
rem Populate databases and load default data
CALL C:\Bitnami\REDMIN~1.0-1\scripts\setenv.bat
cd C:\Bitnami\redmine-2.6.0-1/apps/redmine\htdocs
cmd /C bundle install --local --without development test sqlite --binstubs --deployment
C:\Bitnami\redmine-2.6.0-1/ruby\bin\ruby.exe bin\rake generate_secret_token
C:\Bitnami\redmine-2.6.0-1/ruby\bin\ruby.exe bin\rake db:migrate RAILS_ENV="production"
C:\Bitnami\redmine-2.6.0-1/ruby\bin\ruby.exe bin\rake redmine:load_default_data RAILS_ENV="production" < lng.txt
```
我们这里采用的是以下步骤手动完成：
1. 创建redmine 数据库。连接至3306端口的Mysql，执行以下MySQL命令：
```
create database redmine character set utf8;
create user ‘bitnami‘@‘localhost‘ identified by ‘60760284c1‘;
grant all privileges on bitnami_redmine.* to ‘bitnami‘@‘localhost‘;
```
  修改..\redmine-2.6.0-1\apps\redmine\htdocs\config\database.yml中的[production]的设置，并将port设为3306
2. 初始化redmine 数据库结构
  将命令模式的当前目录切换至redmine的安装目录（我的是C:\Bitnami\redmine-2.6.0-1\apps\redmine\htdocs），执行命令：
```
rake db:migrate RAILS_ENV="production"
```
  可能会报错：Could not find eventmachine-1.0.3 in any of the sources
  原因： ruby缺少依赖的gemfile。
  解决办法：执行bundle install解决版本依赖问题后，再执行：
```
bundle exec rake db:migrate RAILS
```
3. 配置redmine数据库
  继续在命令模式下执行如下命令，填充redmine数据库中关于默认配置的数据。执行过程中选择语言时输入"zh"：
```
bundle exec rake redmine:load_default_data RAILS_ENV="production"
```
4. 执行下面的语句，创建session密锁：
```
C:\Bitnami\redmine-2.6.0-1/ruby\bin\ruby.exe bin\rake generate_secret_token
```
启动redmine。
1. 启动windows服务redmineThin2。如果没有这个服务，执行以下命令。
```
C:\Bitnami\redmine-2.6.0-1\apps\redmine\scripts\serviceinstall.bat INSTALL
net start redmineThin2
```
  可以通过http://localhost:3002/redmine/查看是否启动成功。
2. 修复apache的配置文件，使redmine可以从http://localhost/redmine/访问。
  出问题的原因：安装过程中发生异常，apache2的conf文件夹下bitmami中的bitnami-apps-vhosts.conf未正确配置。
  打开该文件输入：
```
# Bitnami applications installed in a prefix URL
Include "C:\Bitnami\redmine-2.6.0-1/apps/redmine/conf/httpd-prefix.conf"
```

完成以上修复后，redmine就可以正常的从http://localhost/redmine/访问了

总结

总体上讲，bitmami提供的一键安装包质量是非常高的。

参考

在windows下安装redmine及相关问题

码农公寓

安装和使用

安装过程中的问题

后续问题解决方案

总结

参考

相关文章