Redmine安装指南

莘康裕

2023-12-01

安装Redmine
安装Redmine
要求
操作系统
Ruby解释器
支持的数据库后端
可选组件
Redmine版本
安装步骤
第1步-Redmine应用程序
第2步-创建一个空数据库和伴随的用户
的MySQL
PostgreSQL的
SQLite的
SQL服务器
步骤3-数据库连接配置
步骤4-依赖项安装
可选依赖项
其他依赖项（Gemfile.local）
步骤5-会话存储秘密生成
步骤6-创建数据库架构对象
步骤7-数据库默认数据集
步骤8-文件系统权限
步骤9-测试安装
步骤10-登录到应用程序
组态
电子邮件/ SMTP服务器设置
单片机设置
附件存储设置
记录配置
后备
关于Linux / Unix安装的注意事项
Windows安装注意事项
替代手动安装
这是Redmine 4.0及更高版本的安装文档。您仍然可以阅读旧版本的文档：3.x，1.4.x-2.6.x，1.3.x

要求
操作系统
只要该平台上提供Ruby ，Redmine就可以在大多数Unix，Linux，macOS和Windows系统上运行。在此处查看特定的安装方法。

Ruby解释器
给定的Redmine版本所需的Ruby版本是：

Redmine版本支持的Ruby版本使用的Rails版本
4.1 Ruby 2.3、2.4、2.5、2.6 Rails 5.2
4.0 红宝石2.2 1，2.3，2.4，2.5，2.6 Rails 5.2
1 4.0.6之前的Redmine支持Ruby> = 2.2.2。Redmine 4.0.6和更高版本不支持Ruby 2.2（请参阅＃32787）。

重要告示：

Ruby社区终止了对Ruby 2.4和更早版本的支持。看官方公告的详细信息：2.2，2.3，2.4
Redmine不支持JRuby，因为activerecord-jdbc-adapter和丝瓜络不支持Rails 4.2或更高版本。
支持的数据库后端
MySQL 5.5-5.7
MySQL的5.6或更高版本和MariaDB的认识问题（＃19344，＃19395，＃17460）。
PostgreSQL 9.2或更高
确保您的数据库日期样式设置为ISO（PostgreSQL默认设置）。您可以使用以下方法进行设置：ALTER DATABASE “redmine_db” SET datestyle=“ISO,MDY”;
Microsoft SQL Server 2012或更高版本
Redmine 4.0.0至4.0.6和4.1.0不支持SQL Server（＃30285，＃32737）。
SQLite 3（不适用于多用户生产！）
可选组件
svn用于存储库浏览的SCM二进制文件（例如）（必须在PATH中可用）。有关SCM兼容性和要求，请参阅RedmineRepositories。
ImageMagick（启用甘特图导出到PNG图像和缩略图生成）。
Ghostscript（为Redmine 4.1或更高版本中的PDF附件启用缩略图生成）。
Redmine版本
建议大多数用户安装正确的Redmine点发布。Redmine当前每6个月发布一个新版本，这些版本被认为非常有用且稳定。这是不建议从后备箱安装redmine的，除非你是深深熟悉Ruby on Rails和跟上变化-中继确实挣脱时间到时间。

安装步骤
第1步-Redmine应用程序
通过下载打包的版本或签出代码存储库来获取Redmine源代码。

有关详细信息，请参见下载页面。

第2步-创建一个空数据库和伴随的用户
Redmine数据库用户将在redmine此后命名，但可以更改为其他名称。

的MySQL
CREATE DATABASE redmine CHARACTER SET utf8mb4;
CREATE USER ‘redmine’@‘localhost’ IDENTIFIED BY ‘my_password’;
GRANT ALL PRIVILEGES ON redmine.* TO ‘redmine’@‘localhost’;
对于MySQL 5.5.2或更低版本-使用utf8而不是utf8mb4

CREATE DATABASE redmine CHARACTER SET utf8;
CREATE USER ‘redmine’@‘localhost’ IDENTIFIED BY ‘my_password’;
GRANT ALL PRIVILEGES ON redmine.* TO ‘redmine’@‘localhost’;
对于MySQL 5.0.2或更低版本-跳过“创建用户”步骤，而是：

CREATE DATABASE redmine CHARACTER SET utf8;
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;
SQLite的
跳过这一步。在步骤6中将创建一个数据库文件。

SQL服务器
只需单击几下，即可在SQL Server Management Studio中创建数据库，登录名和用户。

如果您更喜欢使用命令行选项SQLCMD，请参考以下基本示例：

显示SQL
步骤3-数据库连接配置
复制config/database.yml.example到config/database.yml和编辑这个文件，以配置数据库设置为“生产”环境。

MySQL数据库示例（默认端口）：

production:
adapter: mysql2
database: redmine
host: localhost
username: redmine
password: “my_password”
如果您的服务器不在标准端口（3306）上运行，请改用以下配置：

production:
adapter: mysql2
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)
SQLite数据库的示例：

production:
adapter: sqlite3
database: db/redmine.sqlite3
SQL Server数据库的示例（默认主机localhost，默认端口1433）：

production:
adapter: sqlserver
database: redmine
username: redmine # should match the database user name
password: “redminepassword” # should match the login password
步骤4-依赖项安装
Redmine使用Bundler来管理gem依赖项。

如果您使用Ruby 2.5或更早版本，则需要先安装Bundler：

gem install bundler
然后，您可以使用以下命令安装Redmine所需的所有gem：

bundle install --without development test
可选依赖项
马吉克
RMagick是Ruby编程语言和ImageMagick图像处理库之间的接口。对于Redmine 4.1.0之前的版本，该库对于将甘特图导出到PNG或PDF是必需的。

如果您的系统上未安装ImageMagick（6.4.9-6.9.10），而您正在安装Redmine 4.0或更早版本，则应使用以下步骤跳过rmagick gem的安装：

bundle install --without development test rmagick
如果rmagick在Windows上安装时遇到问题，请参阅此HowTo。

数据库适配器
Redmine通过从config/database.yml文件中读取它来自动安装数据库配置所需的适配器gem （例如，如果仅使用mysql2适配器配置了连接，则将仅mysql2安装gem）。

不要忘记bundle install --without development test …在config/database.yml文件中添加或删除适配器后重新运行！

其他依赖项（Gemfile.local）
如果您需要加载Redmine核心不需要的gem（例如Puma，fcgi），请Gemfile.local在redmine目录的根目录下创建一个名为的文件。它会在运行时自动加载bundle install。

例：

＃Gemfile.local
宝石“彪马”
步骤5-会话存储秘密生成
此步骤生成Rails用来编码存储会话数据的cookie的随机密钥，从而防止其被篡改。
重新生成后，生成新的秘密令牌会使所有现有会话无效。

捆绑执行佣金rake generate_secret_token
另外，您可以将此秘密存储在config / secrets.yml中：http :
//guides.rubyonrails.org/upgrading_ruby_on_rails.html#config-secrets-yml

步骤6-创建数据库架构对象
通过在应用程序根目录下运行以下命令来创建数据库结构：

RAILS_ENV =生产包执行rake db：migrate
Windows语法：

设置RAILS_ENV =生产
捆绑执行rake db：migrate
它将通过逐个运行所有迁移来创建表，然后创建一组权限和名为的应用程序管理员帐户admin。

Ubuntu故障排除：

如果您在Ubuntu上遇到此错误：

耙子流产了！
没有要加载的此类文件-net / https
然后，您需要libopenssl-ruby1.8像这样安装：apt-get install libopenssl-ruby1.8。

步骤7-数据库默认数据集
通过运行以下命令，将默认配置数据插入数据库：

RAILS_ENV=production bundle exec rake redmine:load_default_data
Redmine会提示您输入应该加载的数据集语言；您还可以REDMINE_LANG在运行命令之前将环境变量定义为一个值，该值将由任务自动无提示地拾取。

例如：

Unices：

RAILS_ENV=production REDMINE_LANG=fr bundle exec rake redmine:load_default_data
视窗：

设置RAILS_ENV =生产
设置REDMINE_LANG = fr
捆绑执行rake redmine：load_default_data
步骤8-文件系统权限
注意：Windows用户可以跳过此部分。

运行该应用程序的用户帐户必须对以下子目录具有写许可权：

files （附件的存储）
log（应用程序日志文件production.log）
tmp和tmp/pdf（如果不存在，则创建这些文件，用于生成PDF文档等）
public/plugin_assets （插件资产）
例如，假设您使用Redmine用户帐户运行应用程序：

mkdir -p tmp tmp / pdf public / plugin_assets
sudo chown -R redmine：redmine文件登录tmp public / plugin_assets
sudo chmod -R 755文件登录tmp public / plugin_assets
注意：如果这些目录中有文件（例如，从备份还原文件），请确保这些文件不可执行。

sudo查找文件日志tmp public / plugin_assets -type f -exec chmod -x {} +
步骤9-测试安装
通过运行WEBrick Web服务器来测试安装：

捆绑exec rails服务器webrick -e生产
WEBrick启动后，将浏览器指向http：// localhost：3000 /。现在，您应该看到应用程序欢迎页面。

注意：Webrick 不适合生产使用，请仅使用webrick进行测试，以确认到目前为止的安装是否正常。使用此Wiki中的许多其他指南之一来设置Redmine，以使用Passenger（aka mod_rails），FCGI或Rack服务器（Unicorn，Thin，Puma，hellop;）来提供您的Redmine。

步骤10-登录到应用程序
使用默认管理员帐户登录：

组态
Redmine设置在名为的文件中定义config/configuration.yml。

如果你需要覆盖默认应用程序设置，只需复制config/configuration.yml.example到config/configuration.yml和编辑新的文件; 该文件本身具有很好的注释，因此您应该查看一下。

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

重要：不要忘记进行任何更改后重新启动应用程序。

电子邮件/ SMTP服务器设置
电子邮件配置在专用页面中描述。

单片机设置此配置部分使您可以：
如果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实例的默认“文件”目录不同。

例子：

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(’/path/to/logfile.log’, 2, 1000000)
config.logger.level = Logger::INFO
后备Redmine备份应包括：
数据（存储在您的redmine数据库中）
附件（存储在filesRedmine安装目录中）
请参阅备份和还原Redmine以获得更多详细信息。

关于Linux / Unix安装的注意事项
如果遇到奇怪的权限问题，请确保在安装过程中禁用安全强化工具。这些问题通常是沉默的，可能是由扩展ACL，SELinux或AppArmor之类的工具引起的。这些工具主要用于具有严格安全策略的大公司，默认的Linux / Unix发行版设置应该不是问题。

Windows安装注意事项
从http://rubyinstaller.org有一个预构建的Ruby MRI安装程序。
安装后，在开始菜单中选择“ 使用Ruby启动命令提示符”。

指定RAILS_ENV环境变量：

如本指南所述运行命令时，必须RAILS_ENV使用单独的命令设置环境变量。

即具有以下语法的命令：

RAILS_ENV =生产<任何命令>
<任何命令> RAILS_ENV =生产
必须转换为2个后续命令：

设置RAILS_ENV =生产
<任何命令>
MySQL gem安装问题：

您可能需要使用以下命令手动安装mysql gem：

gem安装mysql
在某些情况下，需要将libmysql.dll文件复制到ruby / bin目录中。
并非所有libmysql.dll都可以，这似乎可以正常使用http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll。

Win7及更高版本的重要说明
在Win7及更高版本上，localhost在主机文件5中已注释掉，而IPV6是默认文件6。由于mysql2 gem不支持IPV6地址7，因此无法建立连接，并且会出现错误“ Can’t connect to MySQL server on ‘localhost’ (10061)”。如果使用ping目标为“ :: 1：” IPV6，则
可以通过ping确认localhost。

解决方法：
在database.yml中替换localhost为127.0.0.1。

5 http://serverfault.com/questions/4689/windows-7-localhost-name-resolution-is-handled-within-dns-itself-why

6 http://www.victor-ratajczyk.com/post/2012/02/25/mysql-fails-to-resolve-localhost-disable-ipv6-on-windows.aspx

7 https://github.com/brianmario/mysql2/issues/279

替代手动安装
一些用户可能更喜欢通过使用下载页面上的第三方Redmine捆绑软件之一来跳过手动安装。

Redmine安装指南

相关阅读

相关文章

相关问答

相关文档