Redmine1.3.1安装完全手册(验证和总结).doc

安装项目管理工具 SVN+Redmine 最近想装个代码管理工具，以方便管理自己几年来的代码。需要既可以方便的查看和更新，还需要可以方便的索搜代码。 开始想放到Google SVN上面，后来觉得也没必要了，放在本地既安全也很方便。 我知道的可以和SVN集成的管理工具有Trac和Redmine。以前用过Trac，不过配置挺麻烦的，而且好像有一次我改了些配置，导致站点再也打不开了（搞了好久都没搞定，_）。 这次决定使用Redmine来搭建一个自己的代码管理工具，把自己平时积累的代码都提交上去。下面说一下安装步骤： 一、装备文件 我们搭建redmine使用集成环境Instantails。 InstantRails2.0：/projects/instantrails/ redmine 1.2.0： /frs/?group_id=1850 gem1.3.7：/frs/download.php/70695/rubygems-update-1.3.7.gem 二、安装 配置InstantRails2.0与redmine1、解压InstantRails2.0到一个文件夹，文件夹名字不能含有空格（如InstantRails即可）。 2、然后把redmine 1.2.0解压到InstantRails下的rails_apps下。 更新InstantRails2.0由于Instant Rails 官网这个程序最新的2.0版本07年以后就不再更新了，因此自己搭建前请根据自己的需求更新其中的软件，Instant Rails2.0中软件的版本如下:* Upgrades Ruby to version 1.8.6 Patch Level 111* Upgrades Rails to 2.0.2* Upgrades Mongrel to 1.1.2* Upgrades RubyGems to 1.0.1* Upgrades Rake to 0.8.1* Upgraded Cookbook app to support Rails 2.0.2打开Redmine1.2.0软件包中Doc目录下的INSTALL文档，可以看到安装的软件版本需求 = Requirements* Ruby 1.8.6 or 1.8.7* RubyGems 1.3.7* Ruby on Rails 2.3.11 (official downloadable Redmine releases are packaged with the appropriate Rails version)* Rack 1.1.0 gem* Rake 0.8.3 gem* I18n 0.4.2 gem 因此需要更新其中的软件，步骤如下： 1、进入InstantRails根目录下。点击InstantRails.exe文件 2、点击InstantRails界面（就是刚点击InstantRails.exe后的程序界面）的Rails ApplicationsOpen Ruby Console Window栏目，然后会跳出dos窗口。在里面输入命令： 3、更新RubyGem，由于InstantRails2.0 中gem的版本比较低，不能直接通过命令行直接在线更新，需要使用到之前下载gem1.3.7软件包。 DOS窗口里用命令进入gem1.3.7文件所在的目录，执行gem install -local rubygems-update-1.3.7.gem，出现信息: Successfully installed rubygems-update-1.3.7 1 gem installed Installing ri documentation for rubygems-update-1.3.7.Installing RDoc documentation for rubygems-update-1.3.7.Could not find main page READMECould not find main page READMECould not find main page READMECould not find main page README 再执行update_rubygems.会出现的信息很多，等结束完了运行gem -v 发现已经升级到了1.3.7 yeah 4、更新Rack，在命令行中输入gem install rack -v=1.1.0 5、更新Rake，在命令行中输入gem install rake -v=0.8.3 6、在Redmine = 1.0.5时，就需要安装i18n了，在命令行中输入gem install i18n -v=0.4.2 7、最后更新Rails，在命令行中输入gem install rails -v=2.3.11 去这里下更新包：//注意：Rails要在Rack和Rake软件包之后更新，因为Rails 2.3.11依赖Rack和Rake，Rails 更新时如果发现Rack或Rake版本低就会自动更新Rack和Rake， 但是自动更新的Rake的不是0.8.3(我这是0.9.1)，这导致Rake之后会运行失败。 8、更新Mongrel ，InstantRails2.0 自带的Mongrel是1.1.2的版本，需要更新，在命令行中输入gem install mongrel -v=1.1.5 建立redmine的数据库1、进入“InstantRails/rails_apps/redmine/config下，有文件“database.yml.example”，复制该文件重命名“database.yml”2、配置database.yml中的“production”的参数，使用默认也可以。3、InstantRails界面右键ConfigureDatabase (via PhpMyAdmin)”。进入phpMyAdmin下，新建数据库（用sql命令方式）：注：上述不能登录可用MYSQL客户端软件登录后执行create database redmine character set utf8;4、设置Session Key，进入Redmine目录，在命令行中输入rake generate_session_store（先安装 rdoc-2.4.2.gem）5、创建Redmine数据库，进入Redmine目录，在命令行中输入rake db:migrate RAILS_ENV=production，这将创建表和管理员账号gem install rack -v=1.1.0 只能用这个版本的RACK。rake load_default_data RAILS_ENV=production 是指明当前项目运行环境为production ，中间会提示选择语言，选择 zh（中文）6、输入ruby script/server -e production，启动Web服务器，在浏览器中输入http:/localhost:3000/登陆，默认使用管理员账号login: admin password: admin，下面是登陆后的截图 安装SVN服务器 我这里使用Visual SVN作为SVN的服务，可以参考网络上的文章三、Redmine和SVN集成进入Redmine目录下Config，有文件“configuration.yml.example”，复制该文件重命名“configuration.yml”，修改其中的SVN配置scm_subversion_command: svn # (default: svn)，这里需要设置在环境变量PATH中添加svn所在的目录再重启服务器，配置SCM，选用SVN设置库路径，就可以看到代码了。如何在局域网安装Redmine（原创）作者：周敏龙 本文所用的软件有： Redmine 0.8.2: /projects/redmine/ InstantRails-2.0-win: /projects/instantrails/ 本文介绍了如何在局域网的服务器上安装Redmine，文中一部分是是网上下载的，一部分是自己的原创。由于本人要在公司的内部服务器上安装一个Redmine，然而在网上找到的介绍Redmine的安装的文章都大同小异，实践过程中遇到了不少问题。经过几天的奋战，终于把Redmine完全安装好了，现在把我自己的心得总结一下，以便大家在遇到同样的问题时少走一些弯路。 首先总结一下本文解决了哪些别人没有解决的问题：（1）将Redmine集成到了已有的PHPNow系统中；（2）总结了安装InstantRails后应该修改哪些配置文件；（3）在非上网机上将RedMine安装为Windows服务，使其能开机自动运行。 1 Redmine介绍 是一个基于web的项目管理软件，用Ruby开发的。（可以想象成用php写的n个文件，可以在网页上浏览，就像wordpress。） Redmine：这是基于ROR（Ruby on Rails）框架开发的一套跨平台项目管理系统，是项目管理系统的后起之秀，据说是源于Basecamp的ror版而来，支持多种数据库，除了和DotProject的功能大致相当外，还有不少自己独特的功能，例如提供wiki、新闻台、时间跟踪、feed聚合、导出pdf等待，还可以集成其他版本管理系统和BUG跟踪系统，例如SVN、CVS、TD等等。配置功能强大而且方便，自定义属性和更新通知也很实用，详细的介绍可以看看清华同方的redmine站点。中文版Redmine在线演示：ezWORK、英文版可看Redmine提供的官方演示。 协作对于一个团队来说至关重要，尤其是产品开发的团队，项目化的管理方式已经深入人心，MS Project 所有做过项目管理的人都应该了解，但是每天面对一张静态的甘特图来分配资源、调整进度的做法已经不合时宜了，在 Web 服务盛行的时代，以沟通为核心概念的小型团队项目管理服务 Basecamp 取得了成功，同时还捧红了 Ruby on Rails 框架。 沟通与共享是现代项目管理的核心，这种 Web 形式的项目管理系统通过“项目（Project）”的形式把成员、任务（问题）、文档、讨论以及各种形式的资源组织在一起，大家参与更新任务、文档等内容来推动项目的进度，同时系统利用时间线索（Timeline）和各种动态的报表（Report）形式来自动给成员汇报项目进度。 在技术开发领域，Bug 追踪、Wiki 和 版本控制的集成对于项目管理系统来说必不可少，当然能够实现这些功能的系统也有很多，例如： Trac：基于 Python 的开源程序，应该是最早将 Ticket 与项目结合起来的开发管理系统，支持 Wiki、Timeline、Report 和项目模块分级与里程碑定义，还能够绑定查看SVN内容，简单易用，但是团队开发速度太慢，很多功能确实，无法进行权限分配、多项目管理，配置不够灵活，实在有些遗憾 Jira + Confluence：基于 Java 的 Bug 追踪和企业 Wiki 系统，需要购买，而且很贵，Jira 的 Bug 和事务流管理能力很强大，Confluence 应该是目前最好的企业 Wiki 系统，扩展性强，但是某些操作和体验显得有些跟不上时代 ActiveCollab：基于 PHP 的 Web 项目管理程序，曾经是开源版本的，后来给商业化了，需要购买，Trac 与 Basecamp 的模仿者，安装和使用简单 还有许多 SaaS 方式的在线项目管理服务，例如：Comindwork、LiquidPlanner 、MyQuire、ProjectSpaces、Huddle、PlanHQ、Goplan 等，不过介于中国的出口带宽情况和用户心态问题，将重要的项目数据放在遥远的第三方目前来说还是有些不现实的 啰嗦了很多，下面介绍主角 Redmine，一个 Trac Basecamp 的混合体，吸取了两个系统的有点，基于 Ruby on Rails 框架开发，开放源代码，可以跨平台部署，indigo 觉得它应该是小型开发团队项目管理的首选系统。 功能： 多项目和子项目支持 可配置的用户角色控制 可配置的问题追踪系统 自动日历和甘特图绘制 支持 Blog 形式的新闻发布、Wiki 形式的文档撰写和文件管理 RSS 输出和邮件通知 每个项目可以配置独立的 Wiki 和论坛模块 简单的任务时间跟踪机制 用户、项目、问题支持自定义属性 支持多种版本控制系统的绑定（SVN、CVS、Git、Mercurial 和 Darcs） 支持多 LDAP 用户认证 支持用户自注册和用户激活 多语言支持（已经内置了zh简体中文） 多数据库支持（MySQL、SQLite、PostgreSQL） 外观模版化定制（可以使用 Basecamp 的主题，感觉上就像是自己架设的 Basecamp 服务） 2 Redmine安装与配置 下载InstantRails，解压出来。可以把InstantRails想象成要在本机配置php服务器，里面有mysql，phpmyadmin等等。国内我觉得比较好的有“PHPNOW”）下载的包是绿色包，里面有mysql数据库phpmyadmin等等，直接复制到任意一个文件夹里面即可。注意，路径中不要有空格！ 2.1 Redmine安装 现在redmine用到的数据库和Instantrails里面的MySQL数据库是脱离的，也就是说，接下来的任务，实际上是将redmine的数据与数据库关联，即：导入一些数据库到MySQL里面。仅此而已！（可以想象如同在phpMyAdmin里面导入*.sql的文件，导入数据库。） 方法： 1) “PHPnowCNGR/rails_apps/redmine/config下，有文件“database.yml.example”，重命名一下，改成“database.yml”。我的想法是大概将如同*.doc.bak文件的bak去掉吧。这个是redmine数据库的配置文件，里面有数据库的相关信息。 内容包括： production: adapter: mysql database: redmine host: localhost 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 2) 点击“InstantRails”目录里面的“InstantRails.exe”文件。这就是启动环境（Apache）的主程序了。 3) 进入phpMyAdmin下，新建三个数据库（用sql命令方式）： create database redmine character set utf8; （注：进入phpmyadmin下有两种方式。法1：浏览器输入/mysql/ 法2：InstantRails界面（就是刚才点击InstantRails.exe后的程序界面）的IConfigureDatabase (via PhpMyAdmin)”。如果该栏是灰色的，表示你安装后没重启机器。重启一下即可。这个问题郁闷了我N个小时） 4) 往数据库里面导入数据 点击InstantRails界面（就是刚才点击InstantRails.exe后的程序界面）的IRails ApplicationsOpen Ruby Console Window栏目，然后会跳出dos窗口。在里面输入命令： cd redmine-0.8.2 rake db:migrate RAILS_ENV=production rake load_default_data RAILS_ENV=production 其中rake db:migrate RAILS_ENV=production 是创建数据库；rake load_default_data RAILS_ENV=production 是指明当前项目运行环境为production ，中间会提示选择语言，选择 zh（中文） 。5) 现在配置结束了，点击InstantRails界面（就是刚才点击InstantRails.exe后的程序界面）的IRails ApplicationsManage Rails Applications栏目，如下，点击“Start with Mongrel”（启动redmine这个应用程序）。跳出一个dos窗口，不要关闭。现在就可以浏览你配置好的RedMine了。 6) 浏览器输入：http:/localhost:3000/ 即可。（注意：管理员id和密码都是“admin”。界面还是英文界面，登录后可以在“设置”里面更改成“简体中文”。） zml：如果使用InstantRails启动Redmine,则以下配置文件中的路径需要修改为InstantRails安装的实际路径： E:InstantRailsInstantRails.ini E:InstantRailsuse_ruby.cmd E:InstantRailsapacheconfhttpd.conf E:InstantRailsapachephp.ini E:InstantRailsmysqlmy.ini 2.2 配置邮件通知 Redmin可以为一些操作提供邮件通知如主题改变，新增问题等，这样可以让开发人员及时知道变化。在使用此功能前需要先配置邮件服务器，将C:InstantRailsrails_appsredmine-0.8.0config目录下的email.yml.example更名为email.yml，然后用文本编辑器打开此文件，将内容改为如下： # Outgoing email settings production: delivery_method: :smtp smtp_settings: address: port: 25 domain: 163.com authentication: :login user_name: PM163.com password: 123456 development: delivery_method: :smtp smtp_settings: address: port: 25 domain: 163.com authentication: :login user_name: PM163.com password: 123456 这里我采用的是163的Smtp服务器来发送邮件 然后就可以在Redmine的界面中启用邮件通知，设置一下发件人地址和签名即可。 2.3 集成SubVersion 集成SubVersion就很简单了，在版本库页面选择Subersion，然后填写SVN仓库的url和登录Subversion的用户名，密码即可通过Redmine查看svn仓库中的文件并可比较差异。 2.4 Redmine的WIKI Redmine的Wiki功能比较简单，使用wiki时一定要注意在标记的前后都要留有空格，否则会无效如变粗字体：*Ning* 其中第一个 * 的前面要留有一个空格，而第二个*后面也要留有一个空格，其他标记类似。 在Redmine中可以自定义工作流程，工作流程是指某一个角色针对某一类问题（如功能，缺陷和支持）的状态迁移规则，此时该类问题就被跟踪（此时该类问题也称之为Tracker），状态迁移规则决定了某类问题是否可以从一个状态迁移到另外一个状态 2.5 更改Theme 下载Theme，这里我用黑黑的BaseCamp的Style :） 1.下载地址 /stuff/redmine/themes/basecamp/stylesheets/application.css 2.安装方法 在publicthemes下新建目录basecamp，加入样式目录stylesheets，再把css文件加入其中即可，至于如何选用，下面运行Redmine之后进去玩玩，就能找到了，很easy的:） 2.6 Redmine如何与PHPNow集成 作者按：网上介绍的安装方法一般都是使用InstantRails的，InstantRails中包含了Apache、MySQL。如果已经安装了PHPNow，则同时启动两套Apache和MySQL总是一件不爽的事。实际上，我们只要把InstantRails中的两个目录拷贝到PHPNow中就可以了：Rails-apps、Ruby。 3 Redmine的启动 3.1 命令行启动Redmine 3.1.1 方法1： 使用如下命令行可以启动Redmine： CD E:PHPnowCNGR PATH E:PHPnowCNGRrubybin;E:PHPnowCNGRmysqlbin;%PATH% cd rails_appsredmine-0.8.2 mongrel_rails start -e production -p 3000 注意：上面最后一条命令必须在Redmine所在的目录下执行！ 3.1.2 方法2： 在Redmine目录下执行： CD E:PHPnowCNGR :PATH E:PHPnowCNGRrubybin;E:PHPnowCNGRmysqlbin;%PATH% cd rails_appsredmine-0.8.2 ruby script/server -e production 要求同方法。如果在其他目录下执行会出错！ 3.2 将RedMine安装为Windows服务，开机自动运行 前段时间用的RedMine，Ruby on Rails写的，通过命令行ruby命令启动，不太方便。因为当系统自动更新重启之后，所有用户就成了注销状态，用户态下执行的命令行进程自然也就没了。 RedMine现在在我们组俨然成了最重要的工具，开机不能自动启动可不行。 Ruby提供一个安装Ruby程序为服务的包：mongrel_service。安装其实很简单，只要命令行下运行gem： 步骤1：下载和更新mongrel_service gem install mongrel_service 此过程中会下载一些其他必须的包。 经实验发现如果没有上网，则执行该命令后会产生如下显示： E:PHPnowCNGRcd rails_apps E:PHPnowCNGRrails_appsgem install mongrel_service ERROR: While executing gem . (Gem:RemoteFetcher:FetchError) getaddrinfo: no address associated with hostname. (SocketError) getting size of /Marshal.4.8 作者按：如果是在没有连接互联网的机器上执行该命令，则显示以上信息后就退出了。解决的办法是：先在上网机上执行以上命令，完成后会下载一些文件到 .rubylibrubygems 目录中，其中 .rubylibrubygems1.8gemsmongrel_service-0.3.4-x86-m