LinuxRedmine安装.docx
《LinuxRedmine安装.docx》由会员分享,可在线阅读,更多相关《LinuxRedmine安装.docx(14页珍藏版)》请在冰豆网上搜索。
LinuxRedmine安装
Redmine安装
初建:
诗香随风
日期:
2014-02-27
审核:
日期:
批准:
日期:
最后修改时间:
2018-02-2614:
07
版本号:
V1.0
文档编号:
单击此处输入文字。
质控状态:
待审核
文档修订历史
版本
作者
修订内容描述
修改日期
审核人
审核日期
V1.0
诗香随风
初稿
2014-02-27
相关文档
文档编号
文档名称
文档类型或相关性说明
目录
文档修订历史i
目录ii
1安装环境1
2前提准备1
2.1下载安装软件1
2.2依赖包安装1
2.3安装Ruby1
2.4安装RubyGems2
2.5安装Rails2
3安装Redmine3
3.1数据库配置3
3.2安装依赖包3
3.3生成会话存储4
3.4创建数据库结构4
3.5插入默认数据4
3.6设置文件权限4
3.7测试安装4
3.8邮箱配置5
3.9集成apache5
3.10使用过程中出现问题6
附录:
文档评审记录10
1安装环境
系统:
CentOSrelease6.4
数据库:
MySQL5.1.73
2前提准备
2.1下载安装软件
Ruby:
2.0.0
RubyGems:
v2.1.11
Rails:
4.0.3
Redmine:
2.4.3
下载以上各个软件(软件均存放在/usr/local路径下)
Ruby:
http:
//cache.ruby-lang.org/pub/ruby/2.0/ruby-2.0.0-p451.tar.gz
RubyGems:
http:
//rubygems.org/pages/download
Redmine:
http:
//www.redmine.org/projects/redmine/wiki/Download
2.2依赖包安装
//如果系统安装了ruby或者rubygems相关的软件,建议先卸载
#yumeraserubyrubygems
//安装ruby可能用的基础包,安装过程中可能还会有缺少,视具体情况而定
#yum-yinstallzlib-develcurl-developenssl-develhttpd-develapr-develapr-util-develmysql-devel
2.3安装Ruby
[root@chances-126~]#cd/usr/local
[root@chances-126local]#tar-xzvfruby-2.0.0-p451.tar.gz
[root@chances-126local]#cdruby-2.0.0-p451
[root@chances-126ruby-2.0.0-p451]#./configure
[root@chances-126ruby-2.0.0-p451]#make
[root@chances-126ruby-2.0.0-p451]#makeinstall
通过以上步骤就已经安装好了ruby,下边验证ruby安装成功
#ruby–v
输出如下图说明安装成功
2.4安装RubyGems
[root@chances-126~]#cd/usr/local
[root@chances-126local]#tar-zxvfrubygems-2.1.11.tgz
[root@chances-126local]#cdrubygems-2.1.11
[root@chances-126rubygems-2.1.11]#rubysetup.rb
通过以上步骤就已经安装好了RubyGems,下边验证RubyGems安装成功
#gem–v
输出如下图说明安装成功
2.5安装Rails
//检查更新
[root@chances-126~]#gemupdate
[root@chances-126~]#gemupdate--system
[root@chances-126~]#geminstallrails-V//-V可以显示出进度
运行上边的命令时出现以下错误:
ERROR:
Whileexecutinggem...(Gem:
:
Exception)
Unabletorequireopenssl,installOpenSSLandrebuildruby(preferred)orusenon-HTTPSsources
解决办法:
1.安装zlib
进入ruby源码文件夹,安装ruby自身提供的zlib包
[root@chances-126~]#cd/usr/local/ruby-2.0.0-p451/ext/zlib
[root@chances-126zlib]#ruby./extconf.rb
[root@chances-126zlib]#make
[root@chances-126zlib]#makeinstall
2.安装openssl:
进入ruby源码文件夹,安装ruby自身提供的openssl包
[root@chances-126zlib]#cd/usr/local/ruby-2.0.0-p451/ext/openssl
[root@chances-126openssl]#rubyextconf.rb--with-openssl-include=/usr/local/ssl/include/--with-openssl-lib=/usr/local/ssl/lib
[root@chances-126openssl]#make
[root@chances-126openssl]#makeinstall
3.将gem的源更换为淘宝网:
[root@chances-126~]#gemsources--removehttps:
//rubygems.org/
[root@chances-126~]#gemsources-ahttp:
//ruby.taobao.org/
[root@chances-126~]#gemsources-l
改完后再执行安装rails的命令
[root@chances-126~]#geminstallrails-V
此安装过程会花一定的时间,请耐心等待。
按照以上步骤安装后检查安装:
[root@chances-126~]#rails-v
Rails4.0.3
3安装Redmine
3.1数据库配置
//创建数据库
CREATEDATABASEredmineCHARACTERSETutf8;
CREATEUSER'redmine'@'localhost'IDENTIFIEDBY'chances';
GRANTALLPRIVILEGESONredmine.*TO'redmine'@'localhost';
//编辑database.yml文件
[root@chances-126~]#cd/usr/local
[root@chances-126local]#tar-zxvfredmine-2.4.3.tar.gz
[root@chances-126local]#mvredmine-2.4.3redmine
[root@chances-126local]#cdredmine
[root@chances-126redmine]#cdconfig
[root@chances-126config]#cpdatabase.yml.exampledatabase.yml
[root@chances-126config]#vidatabase.yml
//调整生产数据库的数据库和密码:
production:
adapter:
mysql
database:
redmine
host:
localhost
username:
redmine
password:
my_password
3.2安装依赖包
[root@chances-126redmine]#geminstallbundler
//在redmine文件路径下执行,否则会报错Error:
Bundler:
:
GemfileNotFound
[root@chances-126redmine]#bundleinstall--withoutdevelopmenttest
报错:
Anerroroccurredwhileinstallingrmagick(2.13.2),andBundlercannotcontinue.
Makesurethat`geminstallrmagick-v'2.13.2'`succeedsbeforebundling.
解决:
[root@chances-126redmine]#bundleinstall--withoutdevelopmenttestrmagick
//出这个错是因为没有安装ImageMagick,可以跳过不安装,因此执行上边命令
3.3生成会话存储
[root@chances-126redmine]#rakegenerate_secret_token
3.4创建数据库结构
[root@chances-126redmine]#RAILS_ENV=productionrakedb:
migrate
//在redmine路径下执行
3.5插入默认数据
[root@chances-126redmine]#RAILS_ENV=productionrakeredmine:
load_default_data
3.6设置文件权限
[root@chances-126redmine]#mkdir-ptmptmp/pdfpublic/plugin_assets
[root@chances-126redmine]#chown-Rredmine:
redminefileslogtmppublic/plugin_assets
[root@chances-126redmine]#chmod-R755fileslogtmppublic/plugin_assets
3.7测试安装
通过WEBrickwebserver测试安装(一般只用这个测试是否安装成功,这个服务器访问比较慢,使用的话一般和apache或者nginx集成)
[root@chances-126redmine]#rubyscript/railsserverwebrick-eproduction
访问服务器:
http:
//IP:
3000
默认登录帐号:
admin/cskj@)!
$
这样启动后,启动窗口一关闭服务就停止了,所以要使Redmine作为服务启动,需添加-d参数:
[root@chances-126redmine]#rubyscript/railsserverwebrick-eproduction–d
停止服务方法:
(ps命令查出此进程的pid号,再杀掉,目前好像只能这样,–help里面,还没有停止的参数。
)
[root@chances-126~]#ps-ef|grepruby
[root@chances-126~]#kill-9PID
3.8邮箱配置
[root@chances-126~]#cd/usr/local/redmine/config/
[root@chances-126~]#viconfiguration.yml
问题:
redmine安装完毕后开启邮件通知,发送测试邮件时报错:
"hostnamewasnotmatchwiththeservercertificate"
解决方法:
修改redmine/config/configuration.yml
增加一行openssl_verify_mode:
'none'
重启服务即可
3.9集成apache
Redmine默认使用RoR自带的web服务器WEBrick,默认的端口是3000,速度一般;很多人将Redmine集成到apache,nginx或tomcat中,集成到apache通常采用CGI方式来集成,配置起来比较繁杂。
PhusionPassenger组件是专门为apache和nginx开发的用来部署RubyonRails应用的,配置起来非常的方便,使用下来感觉页面的操作速度比WEBrick要快很多,以下记录了如何安装passenger来集成Redmine到apache服务器。
1、安装依赖库
[root@chances-126~]#yum-yinstallhttpd-develapr-develapr-util-devel
2、安装passenger
[root@chances-126~]#geminstallpassenger-V
[root@chances-126~]#passenger-install-apache2-module
3、修改apache配置文件
passenger成功安装后,它会给出如下的配置提示信息,需要将它们添加到apache的配置文件/etc/httpd/conf/httpd.conf中(不同版本目录名称不一样)
LoadModulepassenger_module/usr/local/lib/ruby/gems/2.0.0/gems/passenger-4.0.37/buildout/apache2/mod_passenger.so
PassengerRoot/usr/local/lib/ruby/gems/2.0.0/gems/passenger-4.0.37
PassengerDefaultRuby/usr/local/bin/ruby
[root@chances-126~]#vi/etc/httpd/conf/httpd.conf
LoadModulepassenger_module/usr/local/lib/ruby/gems/2.0.0/gems/passenger-4.0.37/buildout/apache2/mod_passenger.so
PassengerRoot/usr/local/lib/ruby/gems/2.0.0/gems/passenger-4.0.37
PassengerDefaultRuby/usr/local/bin/ruby
在httpd.conf中添加虚拟主机:
80>
ServerNameredmine
ServerAdminredmine
DocumentRoot/usr/local/redmine/public
ErrorLoglogs/redmine_error_log
OptionsIndexesExecCGIFollowSymLinks-MultiViews
Orderallow,deny
Allowfromall
AllowOverrideall
4、重启apache
[root@chances-126~]#/etc/init.d/httpdrestart
通过http:
//61.152.75.90/访问redmine
3.10使用过程中出现问题
在用管理员身份进入“管理”-->“设置”时页面出现报错:
internalerror500
查看/usr/local/redmine/log下的production.log日志见如下错误:
ProcessingbySettingsController#indexasHTML
Currentuser:
admin(id=1)
Renderedsettings/_general.html.erb(6.7ms)
Renderedsettings/_display.html.erb(6.8ms)
Renderedsettings/_authentication.html.erb(5.7ms)
Renderedsettings/_projects.html.erb(9.5ms)
Renderedqueries/_columns.html.erb(5.2ms)
Renderedsettings/_issues.html.erb(11.0ms)
Renderedsettings/_notifications.html.erb(8.4ms)
Renderedcommon/_tabs.html.erb(53.1ms)
Renderedsettings/edit.html.erbwithinlayouts/admin(53.5ms)
Completed500InternalServerErrorin59.0ms
ActionView:
:
Template:
:
Error(incompatiblecharacterencodings:
UTF-8andASCII-8BIT):
22:
23:
24:
setting_emails_header)%>
25:
<%=setting_text_area:
emails_header,:
label=>false,:
class=>'wiki-edit',:
rows=>5%>
26:
27:
28:
setting_emails_footer)%>
app/views/settings/_notifications.html.erb:
25:
in`blockin_app_views_settings__notifications_html_erb__1935317851798191062_69962562779280'
app/views/settings/_notifications.html.erb:
2:
in`_app_views_settings__notifications_html_erb__1935317851798191062_69962562779280'
app/views/common/_tabs.html.erb:
24:
in`blockin_app_views_common__tabs_html_erb___3966879556762061664_69962561792500'
app/views/common/_tabs.html.erb:
23:
in`each'
app/views/common/_tabs.html.erb:
23:
in`_app_views_common__tabs_html_erb___3966879556762061664_69962561792500'
app/helpers/application_helper.rb:
272:
in`render_tabs'
app/views/settings/edit.html.erb:
3:
in`_app_views_settings_edit_html_erb__157532002792942897_69962561656140'
app/controllers/settings_controller.rb:
28:
in`index'
解决办法:
1、初步判断是字符集的问题,于是查看mysql字符集:
mysql>showsessionvariableslike'char%';
+--------------------------+----------------------------+
|Variable_name|Value|
+--------------------------+----------------------------+
|character_set_client|latin1|
|character_set_connection|latin1|
|character_set_database|latin1|
|character_set_filesystem|binary|
|character_set_results|latin1|
|character_set_server|latin1|
|character_set_system|latin1|
|character_sets_dir|/usr/share/mysql/charsets/|
+--------------------------+----------------------------+
8rowsinset(0.00sec)
mysql>showglobalvariableslike'char%';
+--------------------------+----------------------------+
|Variable_name|Value|
+--------------------------+----------------------------+
|character_set_client|latin1|
|character_set_connection|latin1|
|character_set_database|latin1|
|character_set_filesystem|binary|
|character_set_results|latin1|
|character_set_server|latin1|
|character_set_system|utf8|
|character_sets_dir|/usr/share/mysql/charsets/|
+--------------------------+------------