Redmine使用手册

安装Redmine系统要求RubyonRails2.0.2数据库（参考下面的兼容数据库列表）可选的：SVN客户端（版本不低于1.3），用于版本库浏览功能（必须配置到您的PATH设置中）RMagick（用于将甘特图输出至PNG图形文件）支持的数据库：MySQL4或更高版本（推荐）PostgreSQL8（8.3版本未经充分测试）SQLite3（请先阅读:)安装¶1.下载并解压，或者检出Redmine。2.创建一个空数据库，例如名称为redmineMySQL数据库：createdatabaseredminecharactersetutf8;3.复制config/database.yml.example到config/database.yml，并在此文件中配置production环境下的数据库连接参数。以MySQL数据库为例：production:adapter:mysqldatabase:redminehost:localhostusername:bduserpassword:bdpasswd4.在程序的根目录下运行以下命令来创建数据库结构：rakedb:migrateRAILS_ENV=production此命令将创建数据表和管理员帐号。5.运行以下命令，向数据库中导入默认的配置数据：rakeredmine:load_default_dataRAILS_ENV=production这一步操作是可选的，但强烈推荐您执行它，您也可以从头开始一步步填写自己的配置参数。此命令将导入默认角色、跟踪标签、状态、工作流程和枚举值。6.运行WEBrick服务器来测试安装：rubyscript/server-eproduction当WEBrick启动后，使用浏览器访问您将看到系统的欢迎界面。7.使用默认的用户名和密码登录：用户名:admin密码:admin8.您可以到管理&配置界面修改系统的配置参数。SMTP服务器配置¶在config/environment.rb文件中，您可以设置您的SMTP服务器的参数：config.action_mailer.smtp_settings:SMTP服务器配置config.action_mailer.perform_deliveries:设置为false以禁用邮件发送功能修改此文件后需要重新启动服务器。备份¶Redmine的备份应该包括：*数据（保存在redmine数据库中）*附件（保存在Redmine安装目录的files目录中）以下是一个可以进行每天备份的简单脚本程序（假设您使用mysql数据库）：#Database/usr/bin/mysqldump-uusername-ppasswordredmine_database|gzip/path/to/backup/db/redmine_`date+%y_%m_%d`.gz#Attachmentsrsync-a/path/to/redmine/files/path/to/backup/files升级¶从SVN检出系统的升级¶1.在Redmine根目录运行以下命令：svnupdate2.升级数据库（请务必先备份数据库）：rakedb:migrateRAILS_ENV=production3.清空缓存和已有的会话：raketmp:cache:clearraketmp:sessions:clear4.重新启动程序，打开“管理-角色和权限”页面来为新功能分配权限（如果需要的话）。下载的发行版本的升级¶1.将新下载的程序解压到其它目录。2.复制数据库配置文件config/database.yml到新建的config目录。3.在config/environment.rb重新输入SMTP服务器配置参数，而不要直接用旧文件覆盖新文件。4.转到新的Redmine目录，升级数据库（请务必先备份数据库）：rakedb:migrateRAILS_ENV=production5.复制RAILS_ROOT/files目录到新的安装目录。6.重新启动程序，打开“管理-角色和权限”页面来为新功能分配权限（如果需要的话）。从其它系统导入¶Trac¶Trac导入工具导入的内容：用户组件里程碑功能需求(ticket)功能需求的注释和变更（状态和解决方案）Trac特有的属性（例如解决方案）将被作为Redmine的自定义属性功能需求文件和自定义属性Wiki页面及其修改的历史记录注意：用户密码全部被设置为trac如果您的Redmine数据库还没有功能需求，则原来功能需求的编号将保留所有的自定义属性都将在Redmine中被转换为text类型您需要sqlite-rubygem(geminstallsqlite-ruby)来访问Trac的数据库。开始前，您需要一个空的Redmine数据库，并已经导入了默认的配置数据（必需）。参考安装Redmine以下脚本在0.10Tracsqlite数据库环境下测试通过，0.11数据库应该也可以使用。1.运行以下命令，其中test是您的Redmine运行环境参数：rakeredmine:migrate_from_tracRAILS_ENV=test2.脚本会询问您Trac的配置信息：Tracdirectory[]:/var/trac/myprojectTracdatabaseadapter(sqlite,sqlite3,mysql,postgresql)[sqlite]:Databaseencoding[UTF-8]:Targetprojectidentifier[]:myprojectTracdirectory是指您的Trac环境的根目录。Redmine将在此目录中查找db/trac.db（如果您选择了sqlite/sqlite3数库的话）和attachments目录。如果Trac使用了mysql或者postgresql数据库的话，脚本将询问您连接参数（主机名称、数据库名称、用户名和密码）。Targetprojectidentifier是指将接收导入数据的Redmine项目的标识符，如果该项目不存在将会被自动创建。4.脚本导入数据过程如下：DeletingdataMigratingcomponents..............................Migratingmilestones..............Migratingcustomfields.......Migratingtickets.................................Migratingwiki...........Components:29/30Milestones:14/14Tickets:1275/1275Ticketfiles:106/106Customvalues:4409/4409Wikiedits:102/102脚本将显示所有导入对象的总数。此时您将可以在Redmine看到一个Myproject项目，此项目中保存着刚刚导入的Trac数据。Mantis¶Mantis导入工具导入的内容：用户项目项目版本、类别和新闻项目成员错误错误附注、文件、关系和监视器自定义属性用户密码都将被设置为mantis。只有错误文件保存在Mantis数据中（这是Mantis的默认配置）时才能被导入。以下脚本在多种1.0.xMantis数据库中测试通过，也应该可以在其它最近的版本下使用。Beforestarting,youneedafreshRedminedatabase,withdefaultdataloaded(required).See安装Redmine1.运行以下命令，其中test是您的Redmine运行环境参数：rakeredmine:migrate_from_mantisRAILS_ENV=test2.脚本会询问您Mantis的数据库配置信息：PleaseentersettingsforyourMantisdatabaseadapter[mysql]:host[localhost]:database[bugtracker]:mantisusername[root]:password[]:encoding[UTF-8]:输入您的Mantis数据库的适配器、主机名称、数据库名称、用户名、密码和编码方式，或者使用默认值。适配器可以是mysq（默认）或者postgresql。3.脚本导入数据过程如下：Migratingusers...............Migratingprojects.............Migratingbugs........................................Migratingnews...Migratingcustomfields..Users:15/15Projects:13/13Memberships:10/10Versions:33/33Categories:4/4Bugs:180/180Bugnotes:336/336Bugfiles:46/46Bugrelations:11/11Bugmonitors:8/8News:3/3Customfields:2/2脚本将显示所有导入对象的总数。系统配置¶应用程序标题¶标题显示在页面的头部。欢迎文字¶显示在系统主页上的文字。可以包含HTML标记。主题¶您可以选择一个自定义的主题。Redmine内置了一个Alternate主题，此主题主要是会根据问题的优先级在问题列表中显示不同颜色。界面截图：主题保存在public/themes/目录中。更多资料请查看主题。默认语言¶当系统无法判断用户浏览器的语言时将使用默认语言。在向多个用户发送邮件时也将使用默认语言。默认值是：英语日期格式¶使您可以选择如何显示日期：根据用户的语言：将按照用户的语言选择显示给用户的日期格式其它格式：日期将始终按照选定的格式显示默认值是：根据用户的语言附件大小限制¶上传附件的限制（单位：KB）。默认值是：2048（即2MB）主机名称¶安装应用程序的主机名称。主机名称将作为连接显示在发送给用户的邮件中。协议¶协议用于在通知邮件中生成连接。默认值是：http文本格式¶在问题、新闻、文档等的描述信息中使用的文本格式化方法。压缩Wiki历史文档¶使您可以压缩wiki的历史文档（以节省数据库空间）。默认值是：无RSSFeed内容条数限制¶在RSSFeed中最多的记录条数。默认值是：15认证¶要求认证¶如果此选项选中，匿名用户将无法看到任何页面。用户必须登录才能访问。默认值是：未选中自动登录¶此选项允许用户使用自动登录功能。默认值是：禁用允许自注册¶此选项使您可以启用或禁用新用户的自注册：禁用：用户不能注册通过邮件认证激活帐号：新注册的用户会收到一封激活邮件来激活其帐号（用户必须提供有效的邮箱地址）。手动激活帐号(默认值)：新注册的用户必须经过管理员的认证。用户注册完成后，管理员将收到一封邮件通知其有用户等待激活。自动激活帐号：用户注册完成后即可登录。忘记密码¶如果此选项选中，忘记密码功能可用。默认值是：选中问题跟踪¶允许不同项目之间的问题关联¶如果选中，可以在不同项目的问题之间建立关联。默认值是：未选中在项目页面上默认显示子项目的问题¶如果选中，上级项目的问题列表、日历和甘特图上会同时显示子项目的问题。默认值是：选中问题输出条目的限制¶将问题输出到CSV或这PDF格式的时候可以包含的最大问题数量。默认值是：500问题列表中显示的默认列¶此设置使您可以选择在问题列表中默认显示的列。只有设置为“用于所有项目”的自定义属性会在此出现。邮件通知¶邮件发件人地址¶发送给用户的邮件中显示的发件人地址。使用密件抄送(bcc)¶如果选中，通知邮件将使用密件抄送来发送。默认值是：选中邮件签名¶您可以在此输入系统发送邮件时使用的签名。