本文为CentOS 6.4下安装redmine-2.5.0的笔记,按照 官方文档 进行安装。
安装 ruby
yum install ruby yum install ruby-devel yum install rubygems
安装 redmine
wget 'http://www.redmine.org/releases/redmine-2.5.0.tar.gz' tar xzvf redmine-2.5.0.tar.gz gem install bundler gem install mysql2. yum install ImageMagick ImageMagick-devel bundle install --without development test
配置 redmine
以 root 用户登录
mysql
mysql -uroot -p
创建
redmine
用户及库CREATE DATABASE redmine CHARACTER SET utf8; CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'redmine'; GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
修改数据库配置文件
cp config/database.yml.example config/database.yml diff config/database.yml config/database.yml.example 10,11c10,11 < username: redmine < password: "redmine" --- > username: root > password: ""
初始化会话存储
rake generate_secret_token
创建数据库表结构
RAILS_ENV=production rake db:migrate
解决上一步可能出现的错误
rake aborted! Can't connect to local MySQL server through socket '/var/lib/mysql/mysql.sock' (2)
Tasks: TOP => db:migrate => environment
确定
mysql
启动时指定的mysql.sock
文件的路径ps aux | grep mysql.sock
显示的
mysql.sock
路径可能为“--socket=/tmp/mysql.sock
”修改
redmine
数据库配置,在production
配置中添加socket
项:production: ... socket: /tmp/mysql.sock
重新进行上一步操作。
初始化数据
RAILS_ENV=production REDMINE_LANG=zh rake redmine:load_default_data
创建相关目录
mkdir -p tmp tmp/pdf public/plugin_assets sudo chown -R nobody:nobody files log tmp public/plugin_assets sudo chmod -R 755 files log tmp public/plugin_assets
试运行 redmine
ruby script/rails server webrick -e production
浏览器打开页面
使用 用户名
admin
,密码admin
登录后,立即修改密码。使用下面的命令生成随机的密码:
cat /dev/urandom | head -1 | md5sum | head -c 8
配置 redmine
- 修改
config/settings.yml
使用 Nginx
和 passenger
wget 'http://nginx.org/download/nginx-1.4.6.tar.gz'
tar xzvf nginx-1.4.6.tar.gz
gem install passenger
yum install pcre-devel
passenger-install-nginx-module
- 交互式安装过程
Automatically download and install Nginx?
选 2. No: I want to customize my Nginx installation. (for advanced users)
Where is your Nginx source code located?
填解压的
nginx
源码包路径Where do you want to install Nginx to?
填
/usr/local/nginx
修改 /usr/local/nginx/conf/nginx.conf
在最后的
}
前添加以下配置include vhosts/*.conf;
添加站点配置文件
/usr/local/nginx/conf/vhosts/redmine.conf
server { listen 80; server_name <域名>; root <redmine根目录>/public; passenger_enabled on; client_max_body_size 10m; # Max attachemnt size }
启动
nginx
/usr/local/nginx/sbin/nginx
现在可以正式访问站点了
http://<域名>
支持 OpenID
第三方帐号登录
安装
openid
库gem install ruby-openid
- 使用
admin
帐号登录系统,在“管理 - 配置 - 认证”中勾选上“允许使用OpenID登录和注册”。 - 用户注册时“密码”可以省略, 填上
OpenID URL
即可。 如何获得Google的OpenID URL?
- 先在
Google
的站点上登录 - 打开 https://profiles.google.com 后会跳转到类似这样(
https://plus.google.com/000000000000000000000/posts
)的网页 - 你的
OpenID URL
为 http://profiles.google.com/000000000000000000000
上面的
000000000000000000000
可能为任意的数字串- 先在
管理员确认注册后即可在登录界面上输入
OpenID URL
直接登录一般浏览器的输入框是有记忆功能的,双击后会出现输入历史下拉列表,直接选择即可。
安装插件简化
OpenID
登录- https://github.com/jorgebg/redmine-openid-selector (不推荐) 为原始分枝,在
redmine-2.5.0
下不能直接安装会导致站点登录界面出现404错误,解决方案在 这里 ,简而言之就是把插件目录名中的-
改为_
。 - https://github.com/computerminds/redmine_openid_selector (不推荐) 这个分枝安装后可用,但界面为英文(其实界面就一句英文)。
- https://github.com/tangxinfa/redmine_openid_selector (推荐) 为支持中文我fork了上一个分枝。
通用的插件安装过程:
cd plugins git clone https://github.com/tangxinfa/redmine_openid_selector.git rake redmine:plugins:migrate RAILS_ENV=production touch tmp/restart.txt
通用的插件卸载过程:
rake redmine:plugins:migrate NAME=redmine-openid-selector VERSION=0 RAILS_ENV=production rm -rf plugins/redmine-openid-selector touch tmp/restart.txt
现在在登录及注册页面直接点击第三方站点Logo即可。
- https://github.com/jorgebg/redmine-openid-selector (不推荐) 为原始分枝,在
样式美化
git clone git://github.com/pixel-cookers/redmine-theme.git public/themes/pixel-cookers touch tmp/restart.txt
现在可以使用 admin
登录后台,在“管理 - 配置 - 显示 - 主题”中启用主题 Pixel-cookers
。