Redmine安装与入门指南

Redmine是一个免费且开源的，基于Web的灵活项目管理和错误跟踪工具，使用Ruby on Rails框架编写。

Redmine通过其自己的Wiki，论坛，时间跟踪器和问题管理支持多个项目。

此外， Redmine实现了一个插件平台，因此可以根据您的要求进行自定义。 存在用于看板，Scrum，通知插件或报告的插件。

我真正喜欢Redmine的地方是，尽管它无法解决您必须使用的工作方式，但它包含了足够的选项来适用于任何类型的项目管理方法。

Redmine可以通过不同的方式安装：

• 使用webrick（在生产环境中不建议使用）。
• 与杂种和fastcgi一起运行。
• 使用乘客。
• 或将Redmine打包成战争并部署到Tomcat或Glassfish之类的Java容器中。

在这篇文章中，我将向您展示如何将Redmine 1.3打包到war文件中，以便可以在Tomcat7和Linux中执行。 从理论上讲，应该与Glassfish ， JBoss或任何其他OS一起使用 。

首先下载JRuby 1.6.6，所以打开一个终端

wget http://jruby.org.s3.amazonaws.com/downloads/1.6.6/jruby-bin-1.6.6.tar.gz

然后解压缩下载的文件并移至/ usr / share目录。

焦油xvzf jruby-bin-1.6.6.tar.gz
sudo mv jruby-1.6.6 / /usr/share/jruby-1.6.6

然后使用JRuby安装目录更新环境变量。

须藤gedit / etc / environment

PATH= … :/usr/share/jruby-1.6.6/bin
JRUBY_HOME="/usr/share/jruby-1.6.6"

最后尝试执行jruby以查看已正确安装：

茹比-v

而且， JRuby版本信息应打印在控制台上。

下一步是安装所需的gems ：

gem install rack -v=1.1.1
gem install rails -v=2.3.14
gem install rdoc -v=2.4.2
gem install activerecord-jdbcmysql-adapter -v=1.2.2
gem install warbler -v=1.3.2
gem install jruby-openssl -v=0.7.5
gem install rubytree -v=0.8.2
gem install i18n -v=0.4.2
gem install tree -v=0.2.1

Redmine安装

下载Redmine 1.3并将它们安装在/ usr / share目录中：

wget http://rubyforge.org/frs/download.php/75597/redmine-1.3.0.tar.gz

tar xvzf redmine-1.3.0.tar.gz
sudo mv redmine-1.3.0 /usr/share/redmine-1.3.0

Redmine需要数据库才能工作。 在这种情况下，我已经安装了mySQL5 ，但也支持postgeSQL 。 因此，让我们将mySQL配置为Redmine 。

光盘/usr/share/redmine-1.3.0/config/

安装随附数据库模板配置文件，我们将对其进行重命名并进行修改以适合我们的环境。 此外， Redmine包含不同的启动模式（ 生产，开发，测试 ）。 在本例中，因为我们正在配置生产环境，所以仅涉及生产部分。

cp database.yml.example database.yml
sudo gedit database.yml

production:
  adapter: jdbcmysql
  database: redmine
  host: localhost
  username: redmine
  password: redmine
  encoding: utf8

进行此修改后，是时候将Redmine用户和数据库创建到mySQL中了 。

mysql -u root -p

create database redmine character set utf8;
create user ‘redmine’@’localhost’ IDENTIFIED BY ‘redmine’;
grant all privileges on redmine.* to ‘redmine’@’localhost’;

现在是时候初始化Redmine了

cd /usr/share/redmine-1.3.0
rake generate_session_store

因为我们要安装Redmine 1.3，所以下一步是必需的，因此在Redmine 1.4和更高版本的下一版本中将是不必要的。 打开config / environment.rb ，然后像下面这样注释：

config.gem'rubytree'，：lib =>'树'

然后创建数据库架构，并使用下一个脚本用默认数据填充它们。

RAILS_ENV=production rake db:migrate
RAILS_ENV=production rake redmine:load_default_data

现在，我们将测试Redmine是否已正确配置。 为此，我们将使用webrick 。

cd /usr/share/redmine-1.3.0
jruby script/server webrick -e production

并打开位于http：// localhost：3000的浏览器以开始检查安装。

将显示Redmine网页，您可以使用用户名和密码admin / admin登录

至此，我们已经正确安装了Redmine 。

配置电子邮件

当通过更改创建或修改新问题时，问题跟踪程序应该能够将邮件发送给受影响的用户。

如果您的邮件服务器需要tls安全协议，则应安装action_mailer_optional_tls插件。

此插件需要git，如果尚未安装，请键入：

须藤apt-get install git

然后在Redmine目录上运行next命令：

jruby脚本/插件安装git：//github.com/collectiveidea/action_mailer_optional_tls.git

让我们配置电子邮件传递：

cd /usr/share/redmine-1.3.0/config/
cp configuration.yml.example configuration.yml
sudo gedit configuration.yml

在配置文件中，您会找到常用的电子邮件设置。 根据您的电子邮件服务器，这些属性的差异可能很大，因此，在这一点上，我将向您展示在生产环境中使用普通身份验证的简单smtp服务器配置。 转到configuration.yml文件的最后一行，然后将下一行附加到生产部分。

production: # this line is already present in configuration.yml.
   email_delivery:
  delivery_method: :smtp
  smtp_settings:
    address: "example.com"
    port: 25
    authentication: :plain
    domain: 'example.com'
    user_name: 'myaccount'
    password: 'password'

所有属性都是不言自明的。

在创建war文件之前，让我们检查电子邮件是否已正确配置。 同样，我们使用webrick 。

cd /usr/share/redmine-1.3.0
jruby script/server webrick -e production

然后在http：// localhost：3000中打开浏览器，并使用admin帐户登录。

通过单击“ 我的帐户”链接来调整管理员电子邮件，然后在“ 电子邮件”部分设置管理员电子邮件。

之后，我们要测试电子邮件配置，请从主菜单转到管理 -> 设置 -> 电子邮件通知，添加发射电子邮件并单击测试电子邮件。 一段时间后，测试消息将发送到管理员电子邮件帐户。

我们已经成功安装了Redmine ，现在是时候将其打包以部署到Tomcat了 。

包装Redmine

在开始之前，由于与已安装的jruby-rack gem不兼容，我们应该运行下一个命令来安装1.0.10版本的jruby-rack 。

gem uninstall jruby-rack
gem install jruby-rack -v=1.0.10

Warble命令需要一个配置文件。 该文件是使用下一条命令创建的：

cd /usr/share/redmine-1.3.0
warble config

cd config/
sudo gedit warble.rb

编辑Warble :: Config部分，并将config.dirs ， config.gems和config.webxml.rails.env部分配置为：

Warbler::Config.new do |config|
  config.dirs = %w(app config lib log vendor tmp extra files lang)
  config.gems += ["activerecord-jdbcmysql-adapter", "jruby-openssl", "i18n", "rack", "tree"]
  config.webxml.rails.env = ENV['RAILS_ENV'] || 'production'
end

最后运行：

颤声

Redmine战争已经创建，可以部署到Tomcat中 。

尽管我们有一个war文件，但我还是建议您不要删除Redmine安装目录，因为以后可以将其用于安装新插件或修改任何配置。 修改后，调用warble命令，将创建具有该更改的新战争 。

我希望您发现这很有用。

参考：来自JCG合作伙伴的 Redmine安装和入门指南   在一个罐子统治他们所有博客的亚历克斯·索托。

翻译自: https://www.javacodegeeks.com/2012/02/redmine-installation-getting-started.html