Request Tracker (RT) 技术文档

1. 安装指南

1.1 系统要求

• Perl：5.10.1 或更高版本。
• 数据库：支持 MySQL 5.7、8（InnoDB）、MariaDB 10.2 或更高（InnoDB）、Postgres 9.5 或更高、Oracle 12c 或更高、SQLite 3.0 或更高（仅用于测试）。
• Web 服务器：支持 Apache 2.x（需 mod_fcgid 或 mod_perl）、nginx 或其他支持 FastCGI 的 Web 服务器。
• Perl 模块：RT 自带工具会自动安装大部分模块，但某些模块可能需要手动安装。

1.2 可选依赖

• 全文索引：支持数据库的全文索引功能。
• 外部 HTML 转换器：安装外部工具以提高性能。
• TLS 证书：推荐为 Web 服务器配置 SSL 证书。

2. 项目安装方式

2.1 解压安装包

将 RT 安装包解压到非安装目录，例如 ~/ 或 /usr/local/src，然后运行以下命令：

tar xzvf rt.tar.gz

2.2 运行配置脚本

运行 configure 脚本以配置安装选项：

./configure --help

根据需要重新运行 ./configure 并添加所需选项。RT 默认安装在 /opt/rt5 目录下。

2.3 检查依赖

运行以下命令检查是否缺少依赖：

make testdeps

如果缺少依赖，可以手动安装或运行以下命令自动修复：

make fixdeps

2.4 安装 RT

如果是首次安装 RT，运行以下命令进行安装：

make install

安装完成后，运行以下命令启动 Web 安装程序：

/opt/rt5/sbin/rt-server

按照提示完成配置。完成后，按 Ctrl-C 停止服务器，并继续配置生产环境。

如果是升级安装，请先备份数据库，然后运行以下命令：

make upgrade

接着运行数据库升级命令：

make upgrade-database

3. 项目的使用说明

3.1 启动 RT

安装完成后，可以通过以下命令启动 RT：

/opt/rt5/sbin/rt-server

RT 将运行在默认端口上，可以通过浏览器访问。

3.2 配置 RT

手动配置 RT 时，需要在 RT 安装目录下编辑 etc/RT_SiteConfig.pm 文件，添加或修改配置项。

3.3 初始化数据库

运行以下命令初始化数据库：

make initialize-database

如果初始化失败，可以运行以下命令删除数据库并重新初始化：

make dropdb

4. 项目API使用文档

4.1 API 概述

RT 提供了丰富的 API，允许用户通过编程方式与系统进行交互。API 支持创建、更新、查询和删除工单等操作。

4.2 API 调用示例

以下是一个简单的 API 调用示例，用于创建新工单：

curl -X POST -H "Content-Type: application/json" -d '{"Subject": "New Ticket", "Queue": "General"}' http://localhost:8080/REST/1.0/ticket/new

4.3 API 配置

API 的配置可以通过 etc/RT_SiteConfig.pm 文件进行调整，例如设置 API 的访问权限、认证方式等。

5. 总结

RT 是一个功能强大的开源工单管理系统，适用于各种规模的企业。通过本技术文档，您可以顺利完成 RT 的安装、配置和使用，并了解如何通过 API 与系统进行交互。