最后更新:2016年11月1日(Debian 8 (64位)上的Redmine 3.3)
从我的网站下载原始文档的PDF版本:http://files.hz6.de/redmine/InstallingRedmine_EN.pdf
德语版本在http://files.hz6.de/redmine/InstallingRedmine_DE.pdf
阅读本指南后,您应该有一个可以工作的redmine实例.
如果这不是情况,或者某个步骤失败,请在论坛上发布详细信息,并参考此维基页面。请确保包括gem env
和/或RAILS_ENV=production /opt/redmine/script/about
的输出。
如果本指南有问题,请联系我或自行纠正。
关于本指南¶
这是在“Debian稳定版”(写作时称为Wheezy)上安装Redmine的逐步指南。
它是为熟悉Debian、shell、MySQL、Apache和Linux的一般用户编写的。
为了使本指南简短,它没有详细解释每一步。
本文档中的版本、文件名和路径经常发生变化。我将尽最大努力保持它们是最新的,但请务必检查。
请注意:我假设您知道如何使用手头的工具。如果不是这样(例如,您不知道如何创建新的数据库或不知道如何重新启动Apache),请使用您选择的搜索引擎,然后在之后回来。
第一章:安装ruby、rails、gems和passenger¶
阅读第一章阅读第一章
1.1 准备您的系统¶
apt-get install gcc build-essential zlib1g zlib1g-dev zlibc libssl-dev libyaml-dev libcurl4-openssl-dev apache2-mpm-prefork apache2-dev libapr1-dev libxslt1-dev checkinstall
apt-get build-dep ruby
1.2 下载、构建和安装ruby¶
在此处双查合规性
https://redmine.ruby-lang.org.cn/projects/redmine/wiki/RedmineInstall
cd ~
wget -c ftp://ftp.ruby-lang.org/pub/ruby/2.3/ruby-2.3.1.tar.gz
tar xvfz ruby-2.3.1.tar.gz
cd ruby-2.3.1
./configure --enable-pthread --prefix=/usr/local
make
su
checkinstall --type=debian --install=yes --fstrans=no --pakdir='~'
1.3 检查ruby是否工作¶
预期输出:ruby 2.3.1pXXX (2016-06-27 revision 41675) [x86_64-linux]
ruby –v
1.4 使ruby支持OpenSSL¶
cd ext/openssl/
ruby extconf.rb
make
su
checkinstall --type=debian --install=yes --fstrans=no --pakdir='~'
1.5 gem已安装?¶
Ruby 1.9默认带有RubyGems,因此现在应该已经安装了gem
。如果正确安装,以下命令将输出类似1.8.2x
的版本号
gem -v
现在我们可以安装rdoc了
gem install rdoc
1.6 安装rails¶
在此检查
https://rubygems.org.cn/gems/rails/versions
https://redmine.ruby-lang.org.cn/projects/redmine/wiki/RedmineInstall
并强制指定版本号(否则将安装最新版本)
gem install rails -v=4.2.7.1 --no-ri --no-rdoc
注意:您可能会收到错误消息“没有找到文件来加载 --zlib (LoadError)”。在这种情况下
您需要首先安装zlib
cd ruby-1.9.3-p547/ext/zlib/
ruby extconf.rb
make
make install
1.7 安装passenger(应用程序服务器)¶
gem install passenger
passenger-install-apache2-module
1.8 配置apache¶
将此放在 /etc/apache/mods-available/passenger.load
中(如有必要,请记得调整路径)。
LoadModule passenger_module /usr/local/lib/ruby/gems/1.9.1/gems/passenger-4.0.46/ext/apache2/mod_passenger.so
并将此放在 /etc/apache/mods-available/passenger.conf
中(如有必要,请记得调整路径)。
PassengerRoot /usr/local/lib/ruby/gems/1.9.1/gems/passenger-4.0.46
PassengerRuby /usr/local/bin/ruby
PassengerDefaultUser www-data
1.9 激活模块¶
a2enmod passenger
第二章:安装redmine¶
阅读第二章阅读第二章
2.1 下载redmine¶
从这里获取最新版本的zip文件并将其解压缩到/opt/redmine
2.2 进一步准备系统¶
注意:安装libmagickwand-dev
会安装很多软件包(依赖项/推荐项)
注意:如果您遇到bundle install错误,则可以尝试清除,然后安装*-dev软件包
gem install bundler mysql2
apt-get install libmagickwand-dev libmysqlclient-dev
cd /opt/redmine
bundle install --without postgresql
2.3 创建数据库¶
create database redmine character set utf8;
create user 'redmine'@'localhost' identified by 'XXX';
grant all privileges on redmine.* to 'redmine'@'localhost';
2.4 配置数据库连接¶
将此放在 /opt/redmine/config/database.yml 中
production:
adapter: mysql2
database: redmine
host: localhost
username: redmine
password: XXX
2.5 生成会话存储密钥¶
rake generate_secret_token
2.6 准备数据库/创建表¶
RAILS_ENV=production rake db:migrate
2.7 设置文件系统权限¶
cd /opt/redmine
mkdir tmp tmp/pdf public/plugin_assets
chown -R www-data:www-data files log tmp public/plugin_assets
chmod -R 755 files log tmp public/plugin_assets
2.8 测试是否工作¶
Redmine 2.x.x
ruby script/rails server webrick -e production
Redmine 3.x.x
bundle exec rails server webrick -e production
现在转到 https://127.0.0.1:3000 并查看redmine的实际效果。
第三章:配置apache和passenger¶
在本指南中,我们将部署到子URI。如果您想要基于名称的虚拟主机配置,请阅读其他指南。
阅读第三章阅读第三章
3.1 配置apache(子URI部署)¶
ln -s /opt/redmine/public /var/www/redmine
将此放在 /etc/apache2/sites-available/redmine
注意:选项RackBaseURI用于rails 3,在rails 2中它被称为RailsBaseURI。它永远不会被称为RakeBaseURI。
<Location /redmine>
RailsEnv production
RackBaseURI /redmine
Options -MultiViews
</Location>
重启apache,测试http://yourhost.com/redmine是否正常工作,如果正常工作,则欢呼吧 :-)
如果您看到意外的内容,请在论坛上发布详细信息,并参考此维基页面。请确保包括gem env
的输出以及/或RAILS_ENV=production /opt/redmine/script/about
。