在windows下安装redmine及相关问题

Posted 2020-09-12 clnchanpin

转载注明出处，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. 安装过程会提示port3306被占用，原因是本机已经安装有mysql。

  因此，改为3305port。

• 问题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的数据库改本机现有的数据库。

兴许问题解决方式

• 手动完毕初始化3306port的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 数据库。连接至3306port的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提供的一键安装包质量是很高的。

參考

1. redmine部署手冊以及安装包
2. 在Windows上安装Redmine