redmin部署记录文档.docx

Redmine部署文档整理：谢春雨20160718目录Redmine部署文档1Redmine简介4说明4依赖安装5部署环境5安装gcc5安装g+5安装Mysql5安装ruby8配置rubygems8安装bundler8Redmine设置8下载redmine8增加空数据库和用户8数据库设置9可选依赖包安装9安装RMagick9安装redmine需要的相关gems包9生成会话库加密9创建数据库对象会话9数据库默认数据设置9文件系统许可10创建文件存储目录10修改hosts文件10启动redmine服务10登录10启动redmine脚本11邮箱配置11其他功能12安装Issue Charts12+SVN13安装SVN13Redmine和SVN集成15Redmine：自动预览附件图片16第一种：显示全图，增加以下代码即可：16第二种：先显示预览图片，则需要增加：17Redmine响应缓慢问题17安装插件17卸载插件18Redmine数据迁移18数据库数据迁移18低版本向迁移高版本问题：18文件附件迁移19插件迁移19Redmine简介Redmine是用Ruby开发的基于web的项目管理软件，是用ROR框架开发的一套跨平台项目管理系统，据说是源于Basecamp的ror版而来，支持多种数据库，有不少自己独特的功能，例如提供wiki、新闻台等，还可以集成其他版本管理系统和BUG跟踪系统，例如Perforce、SVN、CVS、TD等等。这种 Web 形式的项目管理系统通过“项目（Project）”的形式把成员、任务（问题）、文档、讨论以及各种形式的资源组织在一起，大家参与更新任务、文档等内容来推动项目的进度，同时系统利用时间线索和各种动态的报表形式来自动给成员汇报项目进度。主要功能： 多项目和子项目支持 里程碑版本跟踪 可配置的用户角色控制 可配置的问题追踪系统 自动日历和甘特图绘制 支持 Blog 形式的新闻发布、Wiki 形式的文档撰写和文件管理 RSS 输出和邮件通知 每个项目可以配置独立的 Wiki 和论坛模块 简单的任务时间跟踪机制 用户、项目、问题支持自定义属性 支持多 LDAP 用户认证 支持用户自注册和用户激活 多语言支持（已经内置了zh简体中文） 多数据库支持（MySQL、SQLite、PostgreSQL） 外观模版化定制（可以使用 Basecamp 、Ruby安装）项目论坛简单实时跟踪功能SCM in集成 (SVN, CVS, Git, Mecuial, Bazaa and Dacs)说明文中出现的标红命令，如有必要都需要根据实际情况修改。依赖安装部署环境Centos6.5Ruby2.2.5Rails4.2.6Rake11.2.2Redmine3.3.0bundler-1.11.2安装gccyum install -y gcc安装g+在发现该错误时，先在系统中确认是否缺失相对应的包：rpm -qa | grep g+在确认系统未安装之后，查询可安装的相对应的功能的包：yum whatprovides */g+根据提供的包，选择适合系统的进行安装：yum install gcc-c+-4.4.7-17.el6.x86_64安装Mysql二、卸载掉原有mysql因为mysql数据库在Linux上实在是太流行了，所以目前下载的主流Linux系统版本基本上都集成了mysql数据库在里面，我们可以通过如下命令来查看我们的操作系统上是否已经安装了mysql数据库rootxiaoluo # rpm -qa | grep mysql/ 这个命令就会查看该操作系统上是否已经安装了mysql数据库有的话，我们就通过 rpm -e 命令 或者 rpm -e -nodeps 命令来卸载掉rootxiaoluo # rpm -e mysql/ 普通删除模式rootxiaoluo # rpm -e -nodeps mysql/ 强力删除模式，如果使用上面命令删除时，提示有依赖的其它文件，则用该命令可以对其进行强力删除在删除完以后我们可以通过 rpm -qa | grep mysql 命令来查看mysql是否已经卸载成功！三、通过yum来进行mysql的安装我是通过yum的方式来进行mysql的数据库安装，首先我们可以输入 yum list | grep mysql 命令来查看yum上提供的mysql数据库可下载的版本：# yum list | grep mysql执行yum install -y mysql-server mysql mysql-devel命令将mysql mysql-server mysql-devel都安装好(注意:安装mysql时我们并不是安装了mysql客户端就相当于安装好了mysql数据库了，我们还需要安装mysql-server服务端才行)# rpm -qa mysql-servermysql-server-5.1.73-7.el6.x86_64# rpm -qa mysql-develmysql-devel-5.1.73-7.el6.x86_64# rpm -qa mysqlmysql-5.1.73-7.el6.x86_64Centos7安装MysqlCentOS 7的yum源中貌似没有正常安装mysql时的mysql-sever文件，需要去官网上下载# wget /get/mysql-community-release-el7-5.noarch.rpm# rpm -ivh mysql-community-release-el7-5.noarch.rpm# yum install mysql-community-server四、mysql数据库的初始化及相关配置执行service mysqld start命令就可以启动mysql服务。执行chkconfig -list | grep mysqld命令来查看mysql服务是不是开机自动启动，如：rootxiaoluo # chkconfig -list | grep mysqldmysqld 0:关闭 1:关闭 2:关闭 3:关闭 4:关闭 5:关闭 6:关闭如mysqld服务并没有开机自动启动，我们当然可以通过chkconfig mysqld on命令来将其设置成开机启动，这样就不用每次都去手动启动了rootxiaoluo # chkconfig mysqld onrootxiaoluo # chkconfig -list | grep mysqlmysqld 0:关闭 1:关闭 2:启用 3:启用 4:启用 5:启用 6:关闭mysql数据库安装完以后只会有一个root管理员账号，但是此时的root账号还并没有为其设置密码，在第一次启动mysql服务时，会进行数据库的一些初始化工作，在输出的一大串信息中，我们看到有这样一行信息 ：/usr/bin/mysqladmin -u root password new-password/ 为root账号设置密码所以我们可以通过 该命令来给我们的root账号设置密码(注意：这个root账号是mysql的root账号，非Linux的root账号)rootxiaoluo # mysqladmin -u root password root/ 通过该命令给root账号设置密码为 root此时我们就可以通过mysql -u root -p命令来登录我们的mysql数据库了安装ruby获得ruby包：/pub/ruby/2.2/ruby-2.2.5.tar.gztar -xvf ruby-2.2.5.tar.gzcd ruby-2.2.5执行：./configure -prefix=/usr/local -disable-instal-doc -with-opt-dir=/usr/local/libmake & make install编辑配置文件echo /usr/local/lib /etc/ld.so.conf ruby v注：自动安装rubygens，不必单独安装rubygems工具。配置rubygemsgem sources -a 注：此命令替换默认的资源库，这个默认库可以正常下载更新。Centos7报错yum install zlib-devel进入ruby安装目录下的ext/zlib目录，执行ruby extconf.rbmake & make install成功后重新配置rubygems安装bundlergem install bundlercentos7报错yum install openssl-devel进入ruby安装目录下的ext/openssl/目录，执行ruby extconf.rb修改 Makefile 增加 top_srcdir = ./.make & make installRedmine设置下载redmine下载redmine源码/projects/redmine/wiki/Download增加空数据库和用户MySQL5.0以上版本：CREATE DATABASE redmine CHARACTER SET utf8;CREATE USER redminelocalhost IDENTIFIED BY redmine;GRANT ALL PRIVILEGES ON redmine.* TO redminelocalhost IDENTIFIED BY redmine;数据库设置复制config/database.yml.example 到 config/database.yml 并编辑确认数据库配置 production 环境正确。例如 MySQL 数据库使用 ruby 1.9及以上版本 (必须设置为mysql2):production: adapter: mysql2 database: redmine host: localhost username: redmine password: my_password可选依赖包安装安装RMagick对图像进行缩略、剪裁等等的一系列操作。执行：bundle install -without development test rmagick安装redmine需要的相关gems包修改redmine目录下Gemfile文件中的source 修改为source 执行bundle install -without development test生成会话库加密执行bundle exec rake generate_secret_token提示错误/usr/local/rvm/gems/ruby-2.3.0/gems/htmlentities-4.3.1/lib/htmlentities/mappings/expanded.rb:465: warning: key “inodot” is duplicated and overwritten on line 466 (1)vi /usr/local/rvm/gems/ruby-2.3.0/gems/htmlentities-4.3.1/lib/htmlentities/mappings/expanded.rb (2)按下Esc，输入 冒号 ，:set number (3)找到第466行，把它用井号“#”注释掉原因可能是你曾经安装过一次ruby创建数据库对象会话在redmine目录创建数据结构，执行：RAILS_ENV=production bundle exec rake db:migrate数据库默认数据设置插入默认配置数据到数据库，在redmine目录执行：RAILS_ENV=production bundle exec rake redmine:load_default_dataRedmine会提示你的数据集的语言应加载；你也可以定义环境变量的redmine_lang运行命令的值将被自动地拿起面前的任务。执行：RAILS_ENV=production REDMINE_LANG=fr bundle exec rake redmine:load_default_data文件系统许可sudo chmod -R 755 files log tmp public/plugin_assets进入redmine目录下的public目录cp dispatch.fcgi.example dispatch.fcgicp htaccess.fcgi.example .htaccess创建文件存储目录进入redmine的config目录cp configuration.yml.example configuration.ymlvim configuration.ymlattachments_storage_path: /usr/local/redmine/files# 红色字样根据实际路径替换修改hosts文件如果不修改可能导致通过IP地址无法访问问题。增加18 localhost注：localhost是前面database.yml文件中hosts相对应。关闭防火墙service iptables stopCentos7关闭防火墙systemctl stop firewalld.service启动redmine服务bundle exec rails server webrick -e production注：错误提示，语法错误Psych:SyntaxError。点：邮箱配置。登录登录用户名/密码：admin/admin启动redmine脚本脚本startredmine.sh可完成启动和重启操作。#!/bin/bash# Program：startredmine.sh# Function:# 启动redmine服务# Notice：# Maximal 2016/07/18# 停止原redmine服务 #output=$(ps -ef|grep webrick|grep -v grep|awk print $2)if !$output ; thenkill -9 $outputelse echo start service redmine .fi# 启动redmine服务 #cd /usr/local/redmine # redmine安装目录bundle exec rails server webrick -e production &邮箱配置编辑redmine3.2.1/config/configuration.yml，添加邮件地址 email_delivery: delivery_method: :smtp # async_smtp异步邮件发送 smtp_settings: address: # SMTP地址 port: 25 authentication: :login domain: 163.com # 域名 user_name: myaccount # 邮箱登录账号 password: myaccount # 登录密码保存后，重新启动redmine。管理员登录，配置-邮件通知，邮件发件人地址填写发件人邮箱即配置文件中的邮箱账号。注：此处配置不正确可能导致启动redmine时提示语法错误。其他功能安装Issue Charts1 在redmine的plugin目录执行git clone /masweetman/issue_charts.git命令。2 执行bundle install，安装需要程序。3 执行rake redmine:plugins:migrate RAILS_ENV=production，安装插件。4 重启Redmine5 在【管理】-【角色和权限】，修改插件的功能。+SVN安装SVN查看是否可以从yum软件仓库找到SVN安装包yum list *svn*从使用yum软件仓库安装SVN，执行yum install -y subversion-svn2cl.noarch中间会列出要关联的包，并提示下载：输入“y”并确认查看SVN命令svn help创建版本库创建版本库目录mkdir -p /root/test/svn/svnfile创建版本库svnadmin create /root/test/svn/svnfile生成以下目录进入conf目录（这是该SVN版本库的配置目录）查看配置文件authz（文件权限控制文件），passwd（账号密码文件），svnserve.conf（服务器配置文件）设置密码vim passwd注：test为用户名，test123为密码设置权限vim authz在末尾添加/ver=rw版本库的根目录ver对其具有读写权限（r为读权限w为写权限）修改svnserver.conf设置anon-access=none #匿名用户不可访问auth-access=write #认证用户可以执行写操作password-db=passwd #密码文件authz-db=authz #认证文件启动SVN执行svnserve -d -r /root/test/svnRedmine和SVN集成进入Redmine目录下config，有文件“configuration.yml.example”，复制该文件重命名“configuration.yml”，修改其中的SVN配置scm_subversion_command: svn # (default: svn)，这里需要设置在环境变量PATH中添加svn所在的目录再重启服务器，配置SCM，选用SVN设置库路径，就可以看到代码了。Redmine：自动预览附件图片redmine用做项目管理的工具，新增加图片的话，在查看问题时候，无法预览，必须点击一次，在新窗口打开，很不人性化。解决方法：安装目录下，修改文件：redmine-3.2.1/app/views/attachments/_links.html.erb第一种：显示全图，增加以下代码即可： attachments, :action = show, :id = attachment, :filename = attachment.filename ), :controller = attachments, :action = show, :id = attachment, :filename = attachment.filename , :class = lightbox, :rel = attachments, :title = #attachment.filename# (- + attachment.description) unless attachment.description.blank? % 第二种：先显示预览图片，则需要增加： attachments, :action = show, :id = attachment, :filename = attachment.filename ), :width = 180), :controller = attachments, :action = show, :id = attachment, :filename = attachment.filename , :class = lightbox, :rel = attachments, :title = #attachment.filename# (- + attachment.description) unless attachment.description.blank? % 多了一个参数“width = 180”180就是你设置的图片宽度Redmine响应缓慢问题 在新建问题、修改问题，会发送邮件，而且是同步操作的，就是说需要等到邮件发送成功后才会提交成功。发送邮件的方式改为异步操作：进入redmine安装路径：redmine-3.2.1/config编辑 configuration.yml 找到 delivery_method: :smtp，将smtp改为async_smtp，保存退出重启 redmine相关服务从excel导入bug列表到redmine1. 下载插件在redmine/plugins执行git clone /zh/redmine_importer.git。2. 安装fastercsv，执行：gem install fastercsv 3. 安装插件执行：bundle exec rake redmine:plugins:migrate RAILS_ENV=production 4. 重启redmine5. 在项目=配置=模块中，勾选中Importer，并保存。6. 在配置标签的左侧，会出现一个导入标签，我们现在就可以开始导入实验。(1) 熟悉csv格式：我们可以在redmine中新建一个issue，并在问题页面的右下角，点击导出CSV。这个csv文件打开后，我们可以看到最上一行有许多项目，对应着一个。我们就是要将自己的buglist按照这些列进行整理，如果没有的内容，可以留空。(2) 注意，请不要在csv文件中直接编辑，我们要新建一个excel，在excel中整理完之后，将excel另存为csv格式。(3) 将csv文件转为utf-8编码格式。可以使用notepad+，格式=转为utf8编码，并保存。在redmine上导入。导入时需要注意的是，在csv中，为空的列，我们应该在“字段配对”中，相应的选择忽略。导入完成后，redmine发送邮件推送，可能比较慢。安装插件1 将进入redmine插件目录plugins，执行git clone git://bradbeattie/plugin_name.git ./plugin_name2 执行rake redmine:plugins:migrate RAILS_ENV=production，安装插件。3 重启redmine服务 登录redmine进入【管理】-【插件】查看插件列表，如果需要配置该新插件可在这里进行配置。注：plugin_name根据卸载的插件名称按实际情况修改。卸载插件rake redmine:plugins:migrate NAME=plugin_name VERSION=0 RAILS_ENV=production注：plugin_name根据卸载的插件名称按实际情况修改。Redmine数据迁移数据库数据迁移备份还原mysql数据库的命令备份：mysqldump -hhostname -uusername -ppassword databasename backupfile.sql还原：mysql -hhostname -uusername -ppassword databasename backupfile.sql-h后是主机名，可以省略不写 -u后是用户名 -p后是密码 databasename 是数据库名需切换到mysql安装程序的路径下执行，如环境变量有问题，可在执行前，备份还原前，执行Redmine的setenv.sh(在Redmine安装路径的scripts目录中)数据库名和数据库访问用户名口令，可在Redmine安装配置文件database.yml中获取：redmine-3.2.1/configproduction: adapter: mysql2 database: bitnami_redmine host: localhost socket: /opt/bitnami/mysql/tmp/mysql.sock port: 3306 username: xxx password: xxx encoding: utf8低版本向迁移高版本问题：事例redmine 从 2.6 升级到 3.0 数据库结构发生的改变，所以涉及到的数据表，需要手动修复主要修改如下：用户表 users