设置向导会引导您设置数据库、配置电子邮件设置、配置用户注册表和注册应用程序。该向导会检测刚刚安装的应用程序并允许您对其进行设置。
关于此任务
完成此向导中的每一步,以配置您刚刚安装的
Jazz Team Server 和应用程序。如果您想要在完成设置之后进行任何更改,那么可以返回到向导,并重新开始。
过程
注: 如果是运行向导来设置分布式应用程序,请按顺序执行下列步骤:
- 在第一个服务器上安装Jazz Team Server 应用程序和试用许可证。启动第一个服务器,但不在该服务器上运行设置向导。
- 在第二个服务器上(或在每个应用程序的服务器上,如企业拓扑示例所述)安装“变更和配置管理”、“质量管理”或“需求管理”应用程序。
启动这些服务器,但不运行设置向导。
- 从下面的第 2 步开始,在第一个服务器上运行设置向导(与 Jazz Team Server 应用程序一起运行)。转到设置向导的注册应用程序页面(请参阅下面的步骤 7)之后,请提供安装在其他服务器上的应用程序的发现 URL。
- 在 Tomcat 上,如果您想让分布式应用程序(仅限于 CCM 和 QM。其他应用程序使用委托认证。)使用 LDAP,请在下面的8步骤中设置用户注册表之后,将 server.xml 和 web.xml 文件以及 teamserver.properties 文件中的 LDAP 属性从包含 Jazz Team Server 的服务器复制到包含其他应用程序的服务器,然后重新启动所有服务器。
- 在 WebSphere® Application Server 上,如果您想让分布式应用程序(仅限于 CCM 和 QM。其他应用程序使用委托认证。)使用 LDAP,请在下面的8步骤中设置用户注册表之后,将 teamserver.properties 文件中的 LDAP 属性从包含 Jazz Team Server 的服务器复制到包含其他应用程序的服务器,然后重新启动所有服务器。
- 使用 Web 浏览器访问以下地址:https://[fully qualified hostname]:9443/jts/setup
注: IBM i 系统上的缺省端口号为 29443。
- 将显示 Jazz Team Server 登录页面。
- 在用户标识和密码字段中都输入 ADMIN (区分大小写)。单击登录。
- 如果您启用了应用程序以在 WebSphere Application Server 上使用轻量级目录访问协议 (LDAP),请不要将 ADMIN(区分大小写)用作用户标识和密码。而是应作为具有 JazzAdmin 特权的 LDAP 注册用户登录。请注意,LDAP 用户或组必须映射至存储库组。要将安全角色映射至用户或存储库组,请参阅本主题中的步骤 9。
- 对于 z/OS® 上采用 RACF® 安全性的
WebSphere Application Server 或者 IBM i 上采用本地操作系统认证的
WebSphere Application Server,请使用系统上已被授予 JazzAdmin
特权的用户标识。在 IBM i 上,缺省用户标识和密码为 JTSADMIN 和 JTSADMPWD。
- 在欢迎使用页面上,有两个选项可用于设置服务器:快速设置和定制设置。有关快速设置的信息,请参阅运行设置向导(快速设置)。对于生产环境,请选择定制设置,然后单击下一步。
- 在配置公用 URI 页面上,提供格式为 https://[fully qualified hostname]:9443/jts 的“公用 URI 根”,选中复选框以确认您已经阅读并且了解此页面上提供的建议。单击测试连接。测试成功之后,单击下一步。
要点: [fully qualified hostname] 是主机名,它带有安装了
Jazz Team Server 的机器的 DNS 域引用。
良好 [fully qualified hostname] 的示例是 clmwb.example.com。
错误 [fully qualified hostname] 的示例是 localhost 和 IP 地址。
- 在配置数据库页面上,提供信息以设置数据库连接。
如果您正在使用 Derby 数据库,那么不应该更改缺省值,并且系统不会提示您创建数据库表。
如果您更改缺省值或对 DB2、Oracle 或 SQL Server 之类的企业数据库设置值,请单击测试连接以确保正确配置了连接。
如果先前未使用 repotools 来创建数据库表,那么您可能会看到一条警告,指出该数据库已存在,但未包含任何表。要创建表,请单击创建表。完成此命令可能需要几分钟时间,请耐心等候。
如果已测试连接并且未看到任何警告或错误,请单击下一步。
- 在启用电子邮件通知页面上,启用或禁用电子邮件通知。如果您选择启用通知,那么将需要提供有关电子邮件服务器的信息,并测试与电子邮件服务器的连接。做出选择并测试连接之后,单击下一步。
- 在注册应用程序页面上,向导会检测与 Jazz Team Server 一起安装的应用程序。发现每个应用程序并将其添加到要注册的应用程序列表可能会花费一些时间。向导还将检测到“生命周期项目管理”应用程序,此应用程序必须在 Jazz Team Server 应用程序所在的服务器上。此向导将不会检测安装在另一服务器上的那些应用程序。必须手动添加这些应用程序,请参阅下面的步骤 c。
- 可选: 如果不想注册应用程序,请单击应用程序名称最右端的
图标。 通常,您应该注册所有应用程序;但是,在下列情况下,您可能不想注册一个或多个应用程序:- 您已下载并部署所有应用程序,但不打算使用所有应用程序。
- 您没有允许访问某个应用程序的许可证。
- 您正在将这个 Jazz Team Server 应用程序配置为独立浮动或令牌许可证服务器。
- 验证已安装的应用程序的“应用程序类型”和“发现 URL”。该向导会为每个应用程序创建缺省预授权功能“用户标识”。
什么是发现 URL?: 发现 URL 是应用程序的服务添加资源 (SCR) URL。通常,SCR URL
是通过向应用程序的公用 URL 添加 /scr 构成的。例如,如果“变更和配置管理”应用程序的公用 URI 为 https://[标准主机名]:9443/ccm,那么对应 SCR
URL 一定为 https://[标准主机名]:9443/ccm/scr。对于本地安装的应用程序,此 URL 和有效“用户标识”将由设置向导填写。
- 可选: 要添加安装在另一个服务器上的应用程序,请单击添加应用程序并提供应用程序名称和发现 URL。 在提供应用程序名称和发现 URL 后,将自动生成并填写功能用户标识。有效用户标识将用于在后台运行任务。有效用户标识不必存在于外部用户注册表中,或作为存储库中的用户而存在;如果用户不存在,那么将自动创建该用户。
- 单击注册应用程序。
注: 该向导会创建好友关系,注册应用程序,并为每个应用程序生成使用者密钥和私钥。
- 注册成功之后,单击下一步以配置已注册的应用程序。
注: 请注意,现在左边的菜单会列示已注册的应用程序以及子步骤。
- 在设置用户注册表页面上,提供以下信息。
- 选择您将使用的用户注册表类型。
注: - 如果您选择 LDAP 用户注册表,那么必须提供信息以配置 Jazz Team Server 与 LDAP 服务器之间的连接。您可能需要向 LDAP 管理员请求获取此信息。
- 对于 z/OS 上采用 RACF 安全性的
WebSphere Application Server 或者 IBM i 上采用本地操作系统认证的
WebSphere Application Server,请选择非 LDAP 外部注册表。
- 提供将具有对
Jazz Team Server 的管理访问权的用户的用户标识、名称、密码和电子邮件地址。
- 根据已安装的应用程序不同,请在
Rational Requirements Composer、Rational Team Concert™ 和
Rational Quality Manager 下面选择要让管理用户拥有的客户访问许可证 (CAL)。可将仅一种类型的基于角色的 CAL 指定给管理员。例如,可以只将“Rational Team Concert - 开发者”CAL 或“Rational Team Concert - 项目干系人”CAL 分配给管理员,但不能同时将这两个 CAL 分配给管理员。相同规则适用于其他应用程序。
如果已安装了试用许可证,那么必须先接受许可证的条款,才能将其指定给管理用户。如果要激活许可证,请单击激活试用版;然后,在“客户访问许可协议”窗口中,单击我接受许可协议中的条款并单击完成。
提示: 有关许可证如何提供对当前发行版中应用程序内的功能的不同级别的访问权的信息,请参阅
客户访问许可证管理概述。
- 做出选择之后,单击下一步。
- 在配置数据仓库页面上,请提供信息以设置与数据仓库的连接。数据仓库是用于报告和分析的数据库。在缺省情况下,应用程序配置为使用应用程序附带包括的 Derby 数据库。如果已在企业数据库服务器(例如 DB2 或 Oracle)上准备数据库,那么必须将 Jazz Team Server 配置为使用该数据库。
要点: 如果您打算使用 Rational Reporting for Development Intelligence (RRDI),请确保您使用缺省 Derby 之外的数据库。RRDI 不支持 Derby。
- 可选: 如果您现在不想配置数据仓库,请单击我现在不想配置数据仓库。 只有在下列情况下,才应绕过数据仓库:
即使未配置数据仓库,应用程序也能够正常运行,但您将无法存储任何报告数据,并且大部分报告将无效。
- 在“配置数据仓库数据库供应商和连接类型”部分中,选择您的数据库供应商以及该数据库供应商的连接类型。缺省值是使用已包括的预先配置的 Derby 数据库(包含 JDBC 连接)。 您可以保留此缺省值,也可以选择不同的数据库供应商和连接类型。
- 如果不使用 Derby 数据库,请在“配置数据仓库数据库连接属性”部分中,输入用于连接数据库的连接属性。 必需值将根据数据库供应商和连接类型的不同而变化。
- 对于 Oracle 或 Microsoft SQL Server,请在数据库表空间文件夹字段中输入数据库服务器上要在其中创建表空间的现有目录的路径。
- 如果您曾使用 Rational Common Reporting 或 Rational Insight,并且想使用现有的数据仓库数据库作为 CLM 产品的数据仓库,请提供用于连接到这个现有数据库的信息。系统将提示您对 Rational Common Reporting 或 Rational 数据库添加表。
- 输入有效用户的登录信息,该用户将运行数据收集作业。 如果是使用 Tomcat 和内置的 Tomcat User Database,那么将在注册表中创建该用户。如果是使用 LDAP 或其他外部注册表,那么必须指定存在于该外部注册表中的用户。
注: 您对此功能用户输入的用户标识不得与您当前用来配置应用程序的管理用户相同。有效用户必须是 JazzAdmins 组的成员。
- 单击测试连接以验证该服务器是否可以使用您提供的连接信息成功地与数据库通信。
- 如果先前未使用 repotools 命令来创建数据库表,那么您可能会看到一条警告,指出该数据库已存在,但未包含任何表。要创建表,请单击创建表。完成此命令可能需要几分钟时间,请耐心等候。 如果您正在使用缺省的 Derby 数据仓库,那么不会看到此警告。
- 单击下一步。
- 对于每个应用程序,请配置数据库和数据仓库(与您在上面执行的步骤类似)。
注: 需求管理所使用的数据库与 Jazz Team Server 相同。因此,“需求管理”的菜单不会提供数据库步骤。
如果您未在步骤 9 中配置 Jazz Team Server 的数据仓库,请在应用程序的配置数据仓库页面上选中我现在不想配置数据仓库。
对于将运行数据收集作业的用户,输入的用户标识不得与您用于配置应用程序的标识相同。
- 在每个应用程序的完成设置页面上,单击完成应用程序设置。在此步骤中,会存储应用程序的客户密钥,并使
Jazz Team Server 上的用户同步。对于“需求管理”应用程序,如果您正在从 Rational Requirements Composer V2 进行升级,或者您正在将“需求管理”应用程序添加至现有 Jazz Team Server 环境,那么也要单击重建索引。如果您正在配置一个全新的环境,那么不必重建索引。看到提示您过程已完成的消息之后,请单击下一步。
注: 如果应用程序位于不同服务器上,并且您看到错误消息“500 错误 - 完成应用程序步骤期间发生意外错误失败”,请使用 NTP 时间服务器来确认所有服务器都具有正确的时间。
- 在“生命周期项目管理”应用程序的完成设置页面上,如果浏览器阻塞了弹出信息以最终完成 LPA,请单击授权以允许进行注册。您可能必须登录到任何已注册的应用程序;请以管理用户身份(用于运行设置向导的用户标识)登录。然后,单击完成应用程序设置。过程完成后,请单击下一步。
- 在摘要页面上,单击完成以访问 Jazz Team Server 管理页面,您可以在此页面中执行管理服务器、用户和许可证之类的管理任务。有关更多信息,请参阅管理 Jazz Team Server。