共计 5935 个字符,预计需要花费 15 分钟才能阅读完成。
在 Scientific Linux 6.4(64 位)上安装 Redmine 2.5.1
目录
- 安装依赖项
- 安装 Ruby 2.0
- 下载安装 Redmine
- 创建数据库和数据库用户
- 配置数据库连接信息
- 安装依赖项
- 会话存储密钥生成
- 生成数据库结构
- 填充缺省配置数据
- 设置文件系统访问权限
- 测试安装是否成功
- 登录 Redmine
- 进一步配置系统
- 整合到 Apache
- 复制到 Apache 专用目录
- 配置 fcgid
- 配置 redmine 虚拟主机
- 测试是否成功
- 修改日志配置
- 备份
Redmine 是一款优秀的项目管理和 Bug 跟踪软件,基于 RoR(Ruby on Rails)开发。
下面记录安装过程。
安装依赖项
sudo yum install vim-enhanced git mysql-server mysql-devel ImageMagick ImageMagick-devel mod_fcgid fcgi fcgi-devel
阿里云的云主机中操作系统是 CentOS 5.x,其 ImageMagick 版本过低,需要源码编译:
wget http://mirrors-usa.go-parts.com/mirrors/ImageMagick/ImageMagick-6.8.8-9.tar.gz
tar zxvf ImageMagick-6.8.8-9.tar.gz
cd ImageMagick-6.8.8-9
./configure
make
make install
/sbin/ldconfig /usr/local
ln -f /usr/local/bin/Magick-config /usr/bin/Magick-config
安装 Ruby 2.0
如果已经安装好 Ruby 2.0 可略过这一步。
curl –progress ftp://ftp.ruby-lang.org/pub/ruby/2.0/ruby-2.0.0-p247.tar.gz | tar xz
mkdir /tmp/ruby && cd /tmp/ruby
curl –progress ftp://ftp.ruby-lang.org/pub/ruby/2.0/ruby-2.0.0-p247.tar.gz | tar xz
cd ruby-2.0.0-p247
./configure
make
sudo make install
下载安装 Redmine
cd /tmp
git clone https://github.com/redmine/redmine.git
cd redmine
git checkout 2.5-stable
创建数据库和数据库用户
mysql -u root -p
输入口令后进入 mysql> 命令提示符。依次键入下列命令:
CREATE DATABASE redmine CHARACTER SET utf8;
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'my_password';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
这样就创建了数据库 redmine 和数据库用户 redmine,口令是 my_password。
配置数据库连接信息
cp config/database.yml.example config/database.yml
vim config/database.yml
按下面的内容填写:
production:
adapter: mysql2
database: redmine
host: localhost
username: redmine
password: my_password
安装依赖项
修改 Gemfile 文件,在 gem“builder” 一行之后加入下面一行:gem“fcgi”。然后运行命令:
PKG_CONFIG_PATH=/usr/local/lib/pkgconfig/ gem install rmagick
gem install bundler
bundle install --without development test
会话存储密钥生成
这一步生成一个随机密钥,Rails 用来编码存储会话数据的 cookie,防止外界破坏。
rake generate_secret_token
生成数据库结构
RAILS_ENV=production rake db:migrate
填充缺省配置数据
RAILS_ENV=production rake redmine:load_default_data
Redmine 将提问你选择哪种语言。选 zh 代表简体中文。
设置文件系统访问权限
运行 Redmine 的用户(下面我选定 apache 用户运行 Redmine)必须对下面的目录拥有写权限:
- files(存储附件)
- log(应用程序日志文件 application.log)
- tmp 和 tmp/pdf(如果这些目录尚未存在,则先创建之。用于生成 PDF 文档等)
- public/plugin_assets(插件的相关文件)。
通过下面的命令解决上面的问题:
mkdir -p tmp tmp/pdf public/plugin_assets
sudo chown -R apache:apache files log tmp public/plugin_assets
sudo chmod -R 755 files log tmp public/plugin_assets
chmod -R 1777 /tmp
测试安装是否成功
ruby script/rails server webrick -e production
将运行 WEBrick Web 服务器。打开浏览器访问 http://localhost:3000/(如果你安装在别的服务器上,请用服务器域名或 IP 代替 localhost)。如果一切正常,你会看到欢迎页面。
登录 Redmine
用帐号口令 admin/admin 登录系统。可以通过 ” 管理(Administration)“菜单选择“配置(Settings)”来修改应用程序的大部分设置。
回到服务器的终端窗口,按 Ctrl + C 退出 WEBrick。
进一步配置系统
Redmine 配置信息定义在 conf/configuration.yml 中。如果你需要覆盖缺省的配置,可以
cp config/configuration.yml.example config/configuration.yml
然后修改 conf/configuration.yml。修改完毕需要重启动应用。
整合到 Apache
复制到 Apache 专用目录
首先,把 Redmine 从临时目录 /tmp 转移到目标目录。我的设置是创建 /home/apache 目录,apache 用户拥有这个目录,在其下创建 sites 子目录,所有的 Apache 虚拟主机程序都存放在这个目录下。
mkdir -p /home/apache /home/apache/sites
cd ..
sudo mv redmine /home/apache/sites
sudo chown -R apache:apache /home/apache
配置 fcgid
cp public/dispatch.fcgi.example public/dispatch.fcgi
vim public/dispatch.fcgi
将第一行改为 #!/usr/local/bin/ruby,保存退出。
使 public/dispatch.fcgi 拥有执行权限:
sudo chmod 755 public/dispatch.fcgi
配置.htaccess 文件,去掉 fastcgi 支持内容:
cp public/htaccess.fcgi.example public/.htaccess
vim public/.htaccess
将下面的内容删除或注释掉:
<IfModule mod_fastcgi.c>
AddHandler fastcgi-script .fcgi
</IfModule>
和
<IfModule mod_fastcgi.c>
RewriteRule ^(.*)$ dispatch.fcgi [QSA,L]
</IfModule>
修改 config/environment.rb,将 Rails 环境切换到 production:
vim config/environment.rb
在文件开头加入下面一行:
ENV['RAILS_ENV'] ||= 'production'
配置 redmine 虚拟主机
我的虚拟主机配置文件统一放在 /etc/httpd/conf/sites-available 目录下,然后在 /etc/httpd/conf/sites-enabled 目录中分别对 /etc/httpd/conf/sites-available 中要启用的虚拟主机建立符号链接:
sudo mkdir -p /etc/httpd/conf/sites-available /etc/httpd/conf/sites-available
vim /etc/httpd/conf/sites-available/redmine.vhost
输入下面的内容:
<VirtualHost 58.63.245.211:80>
ServerName redmine.dayatang.org
ServerAdmin webmaster@dayatang.org
DocumentRoot /home/apache/sites/redmine/public/
ErrorLog logs/redmine.dayatang.org_error_log
LogLevel warn
CustomLog logs/redmine.dayatang.org_access_log combined
DefaultInitEnv RAILS_ENV production
MaxRequestLen 20971520
<Directory "/home/apache/sites/redmine/public/">
Options Indexes ExecCGI FollowSymLinks
Order allow,deny
Allow from all
AllowOverride all
</Directory>
<Location />
AddHandler fcgid-script .fcgi
FCGIWrapper "/usr/local/bin/ruby /home/apache/sites/redmine/public/dispatch.fcgi" .fcgi
</Location>
</Virtualhost>
存盘退出后在 /etc/httpd/conf/sites-available 中建立符号链接:
sudo ln -s /etc/httpd/conf/sites-available/redmine.vhost /etc/httpd/conf/sites-enabled/redmine.vhost
如果 Apache 主配置文件尚未导入 /etc/httpd/conf/sites-enabled 目录,修改 Apache 主配置文件:
sudo vim /etc/httpd/conf/httpd.conf
在文件末尾加入这么一行:
Include conf/sites-enabled/*.vhost
存盘退出。
测试是否成功
在命令行窗口运行下述命令:
sudo chown -R apache:apache /home/apache
sudo service httpd restart
然后打开浏览器,在地址栏中输入 redmine.dayatang.org,看看是否可进入欢迎页面。
修改日志配置
Redmine 默认将日志记录到应用主目录下的 log 子目录。随着时间的推移,日志文件可能变得很大。为此可以考虑让它们增长到一定大小之后自动分割为多个文件。可以修改 config/additional_environment.rb 做到这一点。
cp config/additional_environment.rb.example config/additional_environment.rb
vim config/additional_environment.rb
输入下面的内容:
#Logger.new(PATH,NUM_FILES_TO_ROTATE,FILE_SIZE)
config.logger = Logger.new('/path/to/logfile.log', 2, 1000000)
config.logger.level = Logger::INFO
我的 /path/to/logfile.log 是 /usr/share/redmine/log/redmine.log。
备份
Redmine 备份要包括下面的内容:
- 数据(存储在 redmine 数据库内)
- 附件(存储在 Redmine 主目录下的 files 子目录内)
下面是一个简单的脚本,可用于每日备份:
# 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
CentOS 下安装 Redmine 并集成 Git http://www.linuxidc.com/Linux/2015-01/111848.htm
最简化的 Ubuntu 10.04 下 Redmine 部署方法 http://www.linuxidc.com/Linux/2010-07/27076.htm
Ubuntu 10.04 默认安装 Redmine 注意事项 http://www.linuxidc.com/Linux/2010-07/27075.htm
CentOS 5 下 Redmine��安装及配置 http://www.linuxidc.com/Linux/2009-12/23311.htm
Ubuntu 9.10 下搭建基于 PostgreSQL 的 Redmine http://www.linuxidc.com/Linux/2009-11/22697.htm
Ubuntu 中安装开源项目管理软件 Redmine http://www.linuxidc.com/Linux/2008-03/11819.htm
如何将 Turnkey Redmine 虚拟机从 Redmine 1.0.5 升级到 1.2 http://www.linuxidc.com/Linux/2011-09/42882.htm
CentOS5 下进行 Redmine 环境搭建, 邮件服务配置,LDAP 配置 http://www.linuxidc.com/Linux/2013-04/83619.htm
Redmine 的详细介绍 :请点这里
Redmine 的下载地址 :请点这里
![post-qrcode](https://www.xgss.net/wp-content/uploads/2023/07/二维码-微信公众号256x256.jpg)