安装Redmine¶

• 目录
• 安装Redmine
  • 要求
    • 操作系统
    • Ruby & Ruby on Rails & Rack
    • 兼容性说明
    • 数据库
    • 可选组件
  • Redmine版本
  • 安装过程
  • 配置
    • 电子邮件/SMTP服务器设置
    • 版本控制设置
    • 附件存储设置
  • 日志配置
  • 备份
  • Windows安装说明
  • 手动安装的替代方法

要求¶

操作系统¶

只要该平台上可用Ruby，Redmine应该能够在大多数Unix、Linux、Mac、Mac服务器和Windows系统上运行。请参阅具体的安装操作这里。

Ruby & Ruby on Rails & Rack¶

特定Redmine版本所需的Ruby和Ruby on Rails版本是

Redmine版本	支持的Ruby版本	所需的Rails版本	支持的Rack版本	支持的RubyGems版本
当前主线	ruby 1.8.7, 1.9.2, 1.9.3	Rails 2.3.14	Rack 1.1.x	RubyGems <= 1.8
1.3.x	ruby 1.8.6, 1.8.7	Rails 2.3.14	Rack 1.1.x	RubyGems <= 1.7
1.2.x	ruby 1.8.6, 1.8.7	Rails 2.3.11	Rack 1.1.x	RubyGems <= 1.6
1.1.x	ruby 1.8.6, 1.8.7	Rails 2.3.5	Rack 1.0.1	RubyGems <= 1.4
1.0.x	ruby 1.8.6, 1.8.7	Rails 2.3.5	Rack 1.0.1	RubyGems <= 1.4
0.9.x	ruby 1.8.6, 1.8.7	Rails 2.3.5	Rack 1.0.1	RubyGems <= 1.4
0.8.x	ruby 1.8.6, 1.8.7	Rails 2.1.2

官方版本在其vendor目录中包含适当的Rails版本，因此您只需确保您已安装正确的Ruby+RubyGems+Rake+Rack堆栈。

否则，如果您从Redmine仓库检出源代码，您必须在您的计算机上安装所需的Rails宝石（使用gem install rails --version=<required version>）。

兼容性说明¶

• Ruby 1.9尚不支持。您必须使用上面所述的Ruby 1.8.x。
• 需要Rake 0.8.7（Rails尚不支持rake 0.9.x）
• 机架 1.1.x版本是必需的，1.1.0版本存在一个关于引号的错误（#8416）。使用其他版本进行数据库迁移将失败。
• Mongrel 1.1.5需要附加一个补丁以与Rails 2.3.11正常工作（#7688）。升级时，在迁移后的一段时间内可能出现另一个问题（#7857）。
• I18n 0.4.2是Redmine >= 1.0.5所必需的。
• Rails 2.3.11到2.3.14在向多个收件人发送邮件方面存在一个主要问题，有关详细信息和解決方案，请参阅#8751。
• Rails 2.3.14是一个小型的安全版本，已知与Redmine 1.2.x系列兼容（除了上一个问题），可以用作2.3.11的替代品（首先阅读config/environment.rb）。

数据库¶

• MySQL 5.0或更高版本（推荐）
  • 请确保安装Ruby的C绑定，这可以显著提高性能。您可以通过运行gem install mysql2来获取它们。如果您在安装mysql宝石时遇到问题，请参阅Rails Wiki页面

• PostgreSQL 8
  • 请确保您的数据库datestyle设置为ISO（Postgresql默认设置）。您可以使用以下命令设置它：ALTER DATABASE "redmine_db" SET datestyle="ISO,MDY";
  • PostgreSQL 8.4.0和8.4.1中的一些错误影响了Redmine的行为（#4259，#4314），它们在PostgreSQL 8.4.2中已修复
  • 请确保安装Ruby的PostgreSQL适配器。您可以通过运行gem install pg来获取它（与SSL连接一起使用，在编译之前可能需要为您的操作系统安装开发库/软件包）
    • Ubuntu OS：可以通过以下方式安装开发库（或类似）：sudo aptitude install libdbd-pg-ruby1.8

• SQLite 3

可选组件¶

• SCM二进制文件（例如svn），用于仓库浏览（必须在您的PATH中可用）。有关SCM兼容性和要求，请参阅RedmineRepositories。
• RMagick（以启用甘特图导出到png图像）
• Ruby OpenID库（以启用OpenID支持）[仅在Redmine trunk / 0.9-dev上]需要2.0或更高版本。

Redmine版本¶

建议大多数用户安装正确的点版本redmine。Redmine目前每6个月发布一个新版本，这些版本被认为非常可用和稳定。**不推荐**从trunk安装redmine，除非您非常熟悉Ruby on Rails并且能够跟上变化——Trunk**确实**会不时出现问题。

安装程序¶

1. 通过下载打包发布或检出代码仓库来获取Redmine源代码。请参阅下载。

2. 创建一个名为redmine的空数据库和相应的用户。

对于MySQL

create database redmine character set utf8;
create user 'redmine'@'localhost' identified by 'my_password';
grant all privileges on redmine.* to 'redmine'@'localhost';

对于低于5.0.2版本的MySQL - 跳过“创建用户”步骤，而是

grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'my_password';

对于PostgreSQL

CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'my_password' NOINHERIT VALID UNTIL 'infinity';
CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;

3. 将config/database.yml.example复制到config/database.yml，并编辑此文件以配置“生产”环境中的数据库设置。

MySQL数据库的示例

production:
  adapter: mysql
  database: redmine
  host: localhost
  username: redmine
  password: my_password

如果您的服务器不是在标准端口（3306）上运行，请使用以下配置

production:
  adapter: mysql
  database: redmine
  host: localhost
  port: 3307
  username: redmine
  password: my_password

PostgreSQL数据库的示例（默认端口）

production:
  adapter: postgresql
  database: <your_database_name>
  host: <postgres_host>
  username: <postgres_user>
  password: <postgres_user_password>
  encoding: utf8
  schema_search_path: <database_schema> (default - public)

4. 生成会话存储密钥。

rake generate_session_store

5. 通过在应用程序根目录下运行以下命令创建数据库结构

RAILS_ENV=production rake db:migrate

这将创建表和一个管理员账户。

如果您收到此错误

Rake aborted!
no such file to load -- net/https

您需要安装libopenssl-ruby1.8，在Ubuntu中，可以这样操作：apt-get install libopenssl-ruby1.8

6. 通过运行以下命令在数据库中插入默认配置数据

RAILS_ENV=production rake redmine:load_default_data

此步骤是可选的，但强烈推荐，因为您可以从头开始定义自己的配置。它将加载默认角色、跟踪器、状态、工作流程和枚举。

7. 设置权限

注意：Windows用户需要跳过本节。

运行Redmine的用户必须对以下子目录具有写权限：files、log、tmp（如果不存在，则创建最后一个）。

假设您使用redmine用户运行Redmine

mkdir tmp public/plugin_assets
sudo chown -R redmine:redmine files log tmp public/plugin_assets
sudo chmod -R 755 files log tmp public/plugin_assets

8. 通过运行WEBrick网络服务器来测试安装

ruby script/server webrick -e production

一旦WEBrick启动，将浏览器指向https://127.0.0.1:3000/。您现在应该看到应用程序欢迎页面。

注意：Webrick不适用于正常使用，请仅将webrick用于测试到这一点的安装是否功能正常。不推荐将webrick用于除开发之外的其他用途。请使用本wiki中的许多其他指南之一来设置redmine，以便使用passenger（即mod_rails）或mongrel来提供redmine服务。

9. 使用默认管理员账户登录

• 用户名：admin
• 密码：admin

您可以通过访问Admin & Settings来修改应用程序设置。

配置¶

从1.2.0版本开始，Redmine设置在名为config/configuration.yml的文件中定义。

如果您需要覆盖默认应用程序设置，只需将config/configuration.yml.example复制到config/configuration.yml，然后编辑新文件；该文件有很好的注释，所以您应该看一下。

这些设置可以按Rails环境（production/development/test）定义。

重要：不要忘记在更改后重启应用程序。

电子邮件/SMTP服务器设置¶

电子邮件配置在专门的页面中描述。

SCM设置¶

此配置部分允许您

• 覆盖默认命令名称，如果PATH变量中存在的SCM二进制文件不使用标准名称（Windows .bat/.cmd名称将不起作用）
• 指定二进文件的完整路径

示例（使用Subversion）

命令名称覆盖

scm_subversion_command: "svn_replacement.exe"

绝对路径

scm_subversion_command: "C:\Program Files\Subversion\bin\svn.exe"

附件存储设置¶

您可以使用attachments_storage_path设置设置Redmine附件存储的路径，该路径与Redmine实例的默认“files”目录不同。

示例

attachments_storage_path: /var/redmine/files

attachments_storage_path: D:/redmine/files

日志配置¶

Redmine默认日志级别为:info，写入到log子目录。根据网站的使用情况，这可能会产生大量数据，因此为了避免日志文件内容无限增长，请考虑通过系统实用程序（如logrotate）或通过config/additional_environment.rb文件来旋转它们。

要使用后者，请将 config/additional_environment.rb.example 复制到 config/additional_environment.rb 并添加以下行。注意，新的记录器默认为高日志级别，因此必须显式设置为 info。

#Logger.new(PATH,NUM_FILES_TO_ROTATE,FILE_SIZE)
config.logger = Logger.new(config.log_path, 2, 1000000)
config.logger.level = Logger::INFO

备份¶

Redmine 备份应包括

• 数据（存储在您的 Redmine 数据库中）
• 附件（存储在您的 Redmine 安装的 files 目录中）

以下是一个简单的 shell 脚本，可用于每日备份（假设您使用的是 mysql 数据库）

# Database
/usr/bin/mysqldump -u <username> -p<password> <redmine_database> | gzip > /path/to/backup/db/redmine_`date +%y_%m_%d`.gz

# Attachments
rsync -a /path/to/redmine/files /path/to/backup/files

关于 Windows 安装的说明¶

从 http://rubyforge.org 获取并安装 rubyinstaller。从开始菜单选择 使用 Ruby 启动命令提示符

在提示符下，按照之前的说明操作

这些命令

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

需要更改

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

您可能需要使用以下命令安装 mysql 模块

gem install mysql

在某些情况下，可能需要将 libmysql.dll 文件复制到您的 ruby/bin 目录中。
并非所有 libmysql.dll 都适用，以下链接中的似乎可以工作 http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll

替代手动安装¶

一些用户可能更喜欢通过使用下载页面上的第三方 Redmine 打包来跳过手动安装。