Redmine 安装使用说明文档

dang_54 贡献于2014-09-30

作者 baby_zrq  创建于2009-07-30 03:35:00   修改者baby_zrq  修改于2010-11-29 07:51:00字数7450

文档摘要: Redmine是一个基于web的项目管理软件,是基于ROR(RubyonRails)框架开发的一套跨平台项目管理系统.,是项目管理系统的后起之秀,支持多种数据库,除了和DotProject的功能大致相当外,还有不少自己独特的功能,例如提供wiki、新闻台、时间跟踪、feed聚合、导出pdf等待,还可以集成其他版本管理系统和BUG跟踪系统,例如SVN、CVS、TD等等。总体而言,Redmine是一个轻型,便捷的项目管理系统,具备一般软件开发项目常用的功能,并且有良好的扩展性,非常适合于小型软件项目的开发管理。
关键词:

baby_zrq@163.com Redmine安装使用说明文档 Redmine是一个基于web的项目管理软件,是基于ROR(Ruby on Rails)框架开发的一套跨平台项目管理系统.,是项目管理系统的后起之秀,支持多种数据库,除了和DotProject的功能大致相当外,还有不少自己独特的功能,例如提供wiki、新闻台、时间跟踪、feed聚合、导出pdf等待,还可以集成其他版本管理系统和BUG跟踪系统,例如SVN、CVS、TD等等。总体而言,Redmine是一个轻型,便捷的项目管理系统,具备一般软件开发项目常用的功能,并且有良好的扩展性,非常适合于小型软件项目的开发管理。 一、Redmine的安装 1.1 下载软件: 本文所用的软件有:   Redmine 0.8.4: http://rubyforge.org/projects/redmine/   InstantRails-2.0-win: http://rubyforge.org/projects/instantrails/ 1.2 Remine的安装 1.首先将下载后的InstantRails-2.0-win.zip文件解压,以下假设解压到C:\。 InstantRails是一个Rails应用的集成包括了Ruby运行时需要的Rails框架、PhpMyAdmin、Apache、MySql等,这样就不需要分别下载需要的东西。其中Apache是用的1.3版本,主要用于运行PhpMyAdmin(MySql的管理工具),Redmine本身内置了一个Ruby写的Http服务器:WEBrick 因此并不再需要Apache。 2.将下载后的redmine-0.8.4.zip文件解压缩,将解压缩后的文件夹直接复制到InstantRails目录的rails_apps目录下 3.启动InstantRails(在C:\ C:\InstantRails-2.0-win\下有个InstantRails.exe直接运行即可)会出现一个界面(见下图)上面可以控制Apache和MySql的停止和启动,请确保这两个都启动了。如果你的电脑上安装了IIS,可能需要在httpd.conf(在C:\InstantRails-2.0-win\conf_files目录中,也可以修改与此冲突的其他软件的网络端口,在实际使用时和迅雷冲突过) 本文内容主要来源于互联网,文中已尽量引用出处,但仍有疏忽遗漏之处,请原创作者见谅。 baby_zrq@163.com 中修改Apache的监听端口,默认是80。如上图所示。 1.3 新建数据库并导入数据 新建数据库并导入数据有两种方式,一种是直接使用Redmine自带的例子的数据库,用户再创建一个数据库即可,另一种方式是用户自己创建三个数据库,分别为PRODUCTION,DEVELOPMENT和TEST。(第一种方式已验证成功,第二种方式未验证,应该也可以) 1.3.1 第一种方式 1. 将C:\InstantRails-2.0-win\rails_apps\redmine-0.8.4\config 目录下的database.yml.example更名为database.yml,这个是redmine数据库的配置文件,里面有数据库的相关信息。 2.进入phpMyAdmin下,新建一个数据库,用sql命令方式:   create database redmine character set utf8; 注:进入phpmyadmin下有两种方式。 第一种方式是在InstantRails界面(就是刚才点击InstantRails.exe后的程序界面)的I→Configure→Database (via PhpMyAdmin)。如果该栏是灰色的,表示你安装后没重启机器,重启一下即可)。第二种方式直接在浏览器输入http://127.0.0.1/mysql/即可如下图所示的PhpMyAdmin管理界面,如下图所示。 之后再选择数据库→SQL输入sql命令即可,如下图所示。 本文内容主要来源于互联网,文中已尽量引用出处,但仍有疏忽遗漏之处,请原创作者见谅。 baby_zrq@163.com 创建成功后再返回数据库界面可以看到新增加的数据库文件,如下图所示。    3.往数据库里面导入数据:   点击InstantRails界面的I→Rails Applications→Open Ruby Console Window栏目,然后会跳出dos窗口。在里面输入命令:   cd redmine-0.8.4   rake db:migrate RAILS_ENV="production"   rake load_default_data RAILS_ENV="production"   其中rake db:migrate RAILS_ENV="production" 是会创建相关的44个数据库表(可以在PhpMyAdmin查看);rake load_default_data RAILS_ENV="production" 是指明当前项目运行环境为production ,中间会提示选择语言,选择 zh(中文) 1.3.2 第二种方式 1. 将C:\InstantRails-2.0-win\rails_apps\redmine-0.8.4\config 目录下的database.yml做如下修改: production: adapter: mysql database: redmine host: localhost 本文内容主要来源于互联网,文中已尽量引用出处,但仍有疏忽遗漏之处,请原创作者见谅。 baby_zrq@163.com username: root password: encoding: utf8 development: adapter: mysql database: redmine_development host: localhost username: root password: encoding: utf8 test: adapter: mysql database: redmine_test host: localhost username: root password: encoding: utf8 接下来,修改MySQL的配置。进入phpMyAdmin(参考第一种方式,推荐从InstantRails的I→Configure→Database (via PhpMyAdmin)启动),打开SQL窗口,输入以下语句: create database redmine character set utf8; grant all privileges on redmine.* to redmine@localhost identified by 'redmine'; create database redmine_development character set utf8; grant all privileges on redmine_development.* to redmine_development@localhost identified by redmine_development'; create database redmine_test character set utf8; grant all privileges on redmine_test.* to redmine_test@localhost identified by 'redmine_test'; 从InstantRails的I→Rails Applications→Open Ruby Console Window启动,执行以下命令。马上数据库表就自动生成了。 > cd redmine-0.8.4 > rake db:migrate RAILS_ENV="production" > rake load_default_data RAILS_ENV="production" > rake db:migrate RAILS_ENV="development" > rake load_default_data RAILS_ENV="development" 本文内容主要来源于互联网,文中已尽量引用出处,但仍有疏忽遗漏之处,请原创作者见谅。 baby_zrq@163.com > rake db:migrate RAILS_ENV="test" > rake load_default_data RAILS_ENV="test" 还有两点注意事项: yaml 文件对格式要求比较严,要体现层次 rake load_default_data 命令是可选的,但是推荐使用。 1.4 启动Redmine 在DOS命令行窗口下进入C:\InstantRails-2.0-win\rails_apps\redmine-0.8.4目录下执行ruby script/server -e production,启动Redmine。启动后的界面如下图所示。 然后通过浏览器访问http://localHost:3000即可,缺省管理员用户名是admin,密码也是admin,初始登录界面如下图所示。 二、Redmine的配置 2.1 配置Redmine为Windows服务 按照上面介绍的步骤就可以使用Redmine,但当机器重启后都需要手工启动InstantRails和执行1.4节来启动Redmine,比较麻烦,下面就介绍将Redmine安装成Windows服务,只要系统启动无需登录也跟着启动。 在上述步骤中,MySql只是作为一个普通程序被InstantRails.exe启动,而Redmine又依赖于MySql,因此需要将MySql安装为Windows服务,从DOS命令行窗户中进入到C:\InstantRails\mysql\bin目录下执行:Mysqld -install即可将MySql安装为服务,在服务管理器中将其设为自动启动。如下图所示: 本文内容主要来源于互联网,文中已尽量引用出处,但仍有疏忽遗漏之处,请原创作者见谅。 baby_zrq@163.com Ruby提供一个安装Ruby程序为服务的包:mongrel_service。安装其实很简单,在C:\ InstantRails-2.0-win \ruby\bin目录下运行:gem install mongrel_service,此过程中会下载一些其他必须的包,如下图所示。 然后使用mongrel_service将Redmine安装为服务: mongrel_rails service::install -N RedMine -c C:\InstantRails\rails_apps\redmine-0.8.0 -p 3000 –e production 其中C:\ InstantRails-2.0-win \rails_apps\redmine-0.8.0是Redmine所在目录 3000是监听端口,然后修改启动方式为自动即可。安装服务结果如下。 如果想要移除Redmine服务,可执行如下命令: mongrel_rails service::remove -N RedMine 2.2 配置邮件通知 Redmin可以为一些操作提供邮件通知如主题改变,新增问题等,这样可以让开发人员及时知道变化。在使用此功能前需要先配置邮件服务器,将C:\InstantRails-2.0-win\rails_apps\redmine-0.8.4\config目录下的email.yml.example更名为email.yml,然后用文本编辑器打开此文件,将内容改为如下: production: delivery_method: :smtp smtp_settings: address: mail.XXXXX port: 25 domain: XXXXX.com # authentication: :login # user_name: redmine@XXXXX.com # password: XXXXXX 本文内容主要来源于互联网,文中已尽量引用出处,但仍有疏忽遗漏之处,请原创作者见谅。 baby_zrq@163.com development: delivery_method: :smtp smtp_settings: address: mail.XXXXX port: 25 domain: XXXXX.com # authentication: :login # user_name: redmine@XXXXX.com # password: XXXXXX 注意用#注销掉的那三行信息,那是邮件服务器身份验证信息,但是如果你的用户已经使用了域验证,就不需要那三行信息。如果使用的是外面邮件服务器,一般是需要的;参数设置好了,然后重启Redmine服务,在配置中设置好发送邮件的账号,然后测试。 2.3 集成SubVersion 集成SubVersion就很简单了,在版本库页面选择Subersion,然后填写SVN仓库的url和登录Subversion的用户名,密码即可通过Redmine查看svn仓库中的文件并可比较差异。 关于SubVersion的下载安装及配置可以参考: http://blog.csdn.net/carlward/archive/2009/06/01/4231058.aspx 2.4 Redmine的WIKI Redmine的Wiki功能比较简单,使用wiki时一定要注意在标记的前后都要留有空格,否则会无效如变粗字体:*Ning* 其中第一个 * 的前面要留有一个空格,而第二个*后面也要留有一个空格,其他标记类似。 本文关于Redmine安装级及配置主要参考来自CSDN的博客: http://blog.csdn.net/carlward/archive/2009/06/02/4231065.aspx 三、Redmine的使用 当Redmine配置完成后,内网可以通过输入服务器在局域网上的IP地址加端口号(本例中为http://172.16.1.159:3000)来访问,外网可以通过对服务器所在局域网上的路由器进行端口映射后输入映射后的外网IP地址加端口号来访问(本例中为http://210.76.109.99:3000)。如下图所示为登录后界面(注:本文对Redmine使用说明主要参考数字城市科技公司的ezWORK项目管理系统,图片截取自己现在使用的系统)。 本文内容主要来源于互联网,文中已尽量引用出处,但仍有疏忽遗漏之处,请原创作者见谅。 baby_zrq@163.com 访问主页后,在未登录状态下公显示公开的项目;左中部为系统介绍和使用提示、常用连接等;左下角为全部的新闻;右侧为所有项目的列表;点击左上角“项目”连接后可看到所有公开的项目,右上角为登录和注册按钮。 3.1 登录Redmine 用户登录Redmine的用户名可以通过在主页上点击注册按钮来进行注册后得到,但因为大部分的项目管理均只是针对项目组成员,出于安全性的考虑,一般均为管理员设置用户账号后再通知给项目组成员,项目组成员使用已知的登录名和密码进行登录,登录界面如下图所示: 3.2 我的工作台 登录成功后点击左上角“我的工作台”按钮将进入我的工作台页面,我的工作台就是日常工作时使用的主界面。默认情况下显示两部分内容,左半部分是指派给我的问题(表示分配给自己的任务,需要尽快完成),右半部分是已报告的问题(表示自己提交的问题,可以在这里查看其状态)。如下图所示。 本文内容主要来源于互联网,文中已尽量引用出处,但仍有疏忽遗漏之处,请原创作者见谅。 baby_zrq@163.com 点右上角的“个性化定制本页”可以在我的工作台上新增内容和修改布局。如下图所示。 个性化定制页面上,使用下拉列表可以增加内容,包括内历,耗时等等。点击每部分内容上的X可以关闭该内容,按住每部分内容的标题拖动可以高速该内容所在的位置。 3.3 我的帐号 点击右上角“我的帐号”连接打开此页面。可以进行的操作有:修改姓名等信息,修改页面显示语言;更改邮件通知选项;更改时区和显示注释的顺序;修改密码。如下图所示。 本文内容主要来源于互联网,文中已尽量引用出处,但仍有疏忽遗漏之处,请原创作者见谅。 baby_zrq@163.com 3.4 项目 在任意界面上都可以通过点击左上角的项目连接进入项目列表界面,其中列出了所有自己有权限查看的项目。点击项目名称可进入该项目主页,右上角有2个快捷连接分别可以在一个页面上查看所有项目的问题和活动。 本文内容主要来源于互联网,文中已尽量引用出处,但仍有疏忽遗漏之处,请原创作者见谅。 baby_zrq@163.com 3.4.1 项目主页(概述) 在项目查看中点击概述会出现如下页面。 在项目概述页面点“日历”页面,可以显示出每天开始的问题和结束的问题,并比较直观的显示出问题的进度。如下图所示。 本文内容主要来源于互联网,文中已尽量引用出处,但仍有疏忽遗漏之处,请原创作者见谅。 baby_zrq@163.com 绿色表示项目开始 红色表示项目结束 在项目概述页面点“甘特图”,可以显示每个问题的进度,如果定义了版本,会显示每个版本的结束时间,并且可以导出到PDF或者PNG,连接在右下角。如下图所示。 在项目概述页面还可以点击“耗时”来统计解决每个问题的工作量或者按照问题类型进行统计,前提是要求问题负责人更新问题时要登记工作量。 本文内容主要来源于互联网,文中已尽量引用出处,但仍有疏忽遗漏之处,请原创作者见谅。 baby_zrq@163.com 3.4.2 活动 3.4.3 问题 问题是一个宽泛的概念,在本系统中,发现的错误、新提的要求、对工作的安排等都可以被当作问题来处理。问题是一个过程性的概念,从提出问题到解决问题、关闭问题是一个完整的过程,表示了对错误的处理、对新需求的响应或对工作安排的完成情况正处于什么样的阶段。 系统默认的问题状态有5种: 新建:表示错误刚被发现、新需求刚被提出、或者工作任务刚被下达 已指派:表示已经安排了人来处理该问题 已解决:表示此问题已经被解决 反馈:表示有人对问题的解决效果提出了反馈意见 已关闭:表示问题已经彻底解决并通过审核,可以告一段落。默认情况下问题列表中将不再显示已经关闭的问题。 已拒绝:认为该问题提出的错误不存在、工作任务不合理等,拒绝执行此问题。 如下图所示。 本文内容主要来源于互联网,文中已尽量引用出处,但仍有疏忽遗漏之处,请原创作者见谅。 baby_zrq@163.com 右边栏有3个快捷连接: 查看所有问题:查看所有打开的问题,可以在设置了其他过滤器后返回此页面。 摘要:对所有问题按照多种方式进行统计。 更新日志:显示各个版本已经解决的问题。 点击具体问题后,可以查看问题详情,如下图所示。 下图是更新问题时的页面。 本文内容主要来源于互联网,文中已尽量引用出处,但仍有疏忽遗漏之处,请原创作者见谅。 baby_zrq@163.com 问题的注意事项: 新建问题前请确认已经选择了正确的项目。不要把本项目的问题创建到别的项目中去!项目名称显示在页面左上角! 如果新建问题时已经定下来由谁负责,那就在指派给那里选中他。 如果对问题的解决有时间限制,请务必写上开始时间和完成日期。日期属性非常重要,让负责人可以根据要求安排自己的工作。 更新问题时不必修改指派给谁,因为负责人不会变来变去。创建问题的人、被指派的人、以及跟踪者都会同时收到问题通知。 问题主题一定要写明确(不明确例子:xx工程的问题;明确例子: xx工程需要尽快购买2台ezIBS服务器的问题) 新建问题前请先看问题列表,如果已经有了相应的问题在说一件事,就不要再重复新建问题了,应该是到那个问题上去更新。如果需要通知给多人,应使用跟踪者功能,而不是建立多个问题依次指定给所有人 问题的负责人务必及时更新问题的状态。如果问题解决完了,就把完成度选成100%,状态选成已关闭,同时写上说明,让关心的人知道问题被如何解决。 问题解决完后一定要把状态选为关闭,完成度改成100%不会自动关闭问题。 问题关闭后才会在问题列表中隐藏,否则永远占着位置。 问题是一个过程,一定要有新建处理反馈完成关闭这种类似流程的事情才应该使用问题来处理。 纯通知性问题直接发邮件即可。如果通知特别想要留记录或者得到反馈,也可以新建问题,但应注意及时关闭。 文档的共享和保存应该使用文件或文档功能,而不是问题功能。 信息的共享和保存应该使用Wiki功能。 本文内容主要来源于互联网,文中已尽量引用出处,但仍有疏忽遗漏之处,请原创作者见谅。 baby_zrq@163.com 3.4.4 新建问题 3.4.5 新闻 本文内容主要来源于互联网,文中已尽量引用出处,但仍有疏忽遗漏之处,请原创作者见谅。 baby_zrq@163.com 3.4.5 文档 3.4.6 WiKi 本文内容主要来源于互联网,文中已尽量引用出处,但仍有疏忽遗漏之处,请原创作者见谅。 baby_zrq@163.com 3.4.5 文件 3.4.5 配置 常用的配置请参看: 中文版手册请看http://218.107.133.32:5000/wiki/ezwork/ZhRedmine 本文内容主要来源于互联网,文中已尽量引用出处,但仍有疏忽遗漏之处,请原创作者见谅。

下载文档到电脑,查找使用更方便

文档的实际排版效果,会与网站的显示效果略有不同!!

需要 8 金币 [ 分享文档获得金币 ] 0 人已下载

下载文档