使用 IBM Installation Manager 来安装 IBM Rational Team Concert Standard Edition 或 Enterprise Edition


此版本构建于 23 十一月 2009。

您可以通过在线方式在以下网址找到此安装过程的最新版本和一些有帮助的计划信息:http://publib.boulder.ibm.com/infocenter/rtc/v2r0m0/index.jsp

目录

安装 Rational Team Concert Standard Edition 和 Enterprise Edition
升级到 Rational Team Concert 2.0.0.2
Standard Edition 和 Enterprise Edition 安装概述
准备安装 Standard Edition 或 Enterprise Edition
关于 Linux 的特别指示信息
使用 IBM Installation Manager 来安装 Standard Edition 或 Enterprise Edition
设置数据库
设置 DB2 数据库
有关 DB2 的特别指示信息
设置 Oracle 数据库
设置 SQL Server 数据库
启动服务器
启动 Apache Tomcat 服务器
在 Windows 上启动服务器
在 Linux 上启动服务器
设置 WebSphere Application Server
运行安装向导
完成安装
使用 IBM Installation Manager 来安装客户机
从 IBM Installation Manager 安装 构建系统工具箱
使用 IBM Installation Manager 来安装 Rational Team Concert ClearCase Connector
使用 IBM Installation Manager 来安装 Rational Team Concert ClearQuest 连接器
将 Rational Team Concert 与安全性增强型 Linux 并列安装

安装 Rational Team Concert Standard Edition 和 Enterprise Edition

升级到 Rational Team Concert 2.0.0.2

通常,您可以通过执行 zip 文件安装或 IBM® Installation Manager 安装来升级 Rational Team Concert™ 客户机和服务器。

注:
如果使用 IBM Installation Manager 在计算机上安装 Rational Team Concert 2.0.0.2,而此计算机上当前未安装 Rational Team Concert,那么 Installation Manager 将提示您选择要安装的语言。但是,如果您是从更低版本更新至 2.0.0.2,那么 IBM Installation Manager 会假定您将使用当前语言,因此不会提示您选择语言。要选择其他语言,在更新至 2.0.0.2 之后,请从 IBM Installation Manager 的主屏幕中选择修改,然后选择产品。下一屏幕显示了支持的语言。请选择需要的语言。

在更新至 2.0.0.2 之后,如果在未选择修改以添加或除去语言的情况下启动 Jazz™ Team Server,那么必须复位服务器,如下所示:

  1. 在 Web 浏览器中,浏览到
    https://<服务器主机>:<Jazz-端口>/jazz/admin?internal#action=com.ibm.team.repository.admin.serverReset
  2. 单击请求复位服务器
  3. 关闭服务器。

然后,您可以从 IBM Installation Manager 中选择修改以添加或除去语言。

Rational Team Concert 客户机与服务器的兼容性

下表列示 Rational Team Concert 客户机版本与 Jazz Team Server 版本的兼容性。

表 1. 客户机与服务器兼容性
Rational Team Concert 客户机版本 兼容的 Jazz Team Server 版本
1.0.x for Eclipse 0.6.x
2.0.x for Eclipse 1.0.x
2.0.0.0 for Microsoft Visual Studio 1.0.0.0
2.0.x for Microsoft Visual Studio 1.0.x

升级用于 Eclipse IDE 的 Rational Team Concert 客户机

如果您有用于 Eclipse IDE 的 1.0、1.0.1 或 1.0.1.1 客户机,那么您需要获取 2.0.x 客户机才能连接至新的 V2.0.x 服务器。您可以使用 zip 文件来安装此客户机,也可以对先前通过 IBM Installation Manager 安装的客户机进行更新。

安装用于 Microsoft® Visual Studio IDE 的 Rational Team Concert 客户机

如果您已有用于 Microsoft Visual Studio IDE 的 V1.0.1.1 客户机,那么需要获取 2.0.x 客户机才能连接至新的 V2.0.x 服务器。

切记:
未提供可安装用于 Microsoft Visual Studio 的客户机的 .zip 文件。要安装 V2.0.x 或升级至 V2.0.x,必须使用 IBM Installation Manager。

将服务器从试用发行版或早期访问发行版升级到永久发行版

如果正在运行 Rational Team Concert 的早期访问发行版,请先升级至 2.0.0.2 试用版。

从 2.0.0.2 试用版开始,您可以通过购买并安装适用于所使用版本的服务器激活套件使服务器成为永久服务器(http://www.ibm.com/software/awdtools/rtc/)。激活套件由一个包含永久服务器密钥的 JAR 文件组成。您可以使用服务器的管理 Web 界面的"管理许可证密钥"页面来安装此套件。

从 1.0, 1.0.1、1.0.1.1 或 2.0 升级服务器

可以从前发行版直接升级至 Rational Team Concert 的 2.0.0.2 发行版。对于 1.x 至 2.x 的更新,需要进行数据库迁移。有关执行数据库迁移的信息,请在升级 Jazz Team Server 后参阅 。在升级 Jazz Team Server 后迁移 Jazz 存储库

注:
在开始升级 WebSphere® Application Server 之前,请通过访问 https://{服务器名称}:9443/jazz/admin#action=com.ibm.team.repository.admin.serverReset 并单击请求复位服务器来复位服务器。

如果前发行版是使用 zip 文件安装的,那么与先前安装没有交集。您可以使用 zip 文件将 2.0.0.2 发行版安装在新位置,也可以使用 IBM Installation Manager 来安装 2.0.0.2 的实例。

如果前发行版是使用 IBM Installation Manager 安装的,那么可以将 2.0.0.2 作为独立实例进行安装或者将先前实例更新至 2.0.0.2。如果安装 2.0.0.2 发行版的服务器的独立实例,请在安装向导的安装软件包页面上选择创建新的软件包组

注:
对于为 Jazz Team Server 部署的 WebSphere Application Server,如果要将其升级,请除去先前的 jazz.war 文件并部署 2.0.0.2 jazz.war 文件。

要完成升级,请参阅 从先前安装的服务器复制所需的配置文件安装 2.0.0.2 激活密钥

将服务器从一个 Rational Team Concert 版本升级至另一个版本

可以在 Rational Team Concert 版本之间进行升级。典型升级包括从 Express-C Edition 升级到 Express™ Edition 或者从 Express Edition 升级到 Standard Edition。通过执行同一过程,还可以按反方向进行降级。

由于所有 Rational Team Concert 2.0.0.2 版都支持 Derby 数据库,因此,如果您正在从 Express-C Edition 升级到 Express Edition 或 Standard Edition,那么不需要从 Derby 迁移到 DB2® 或 Oracle。我们建议您先迁移服务器版本,确保系统使用现有数据库平稳运行,然后在需要时执行数据库迁移工作。注意,Derby 数据库只支持 10 个用户。有关执行数据库迁移的信息,请参阅 在升级 Jazz Team Server 后迁移 Jazz 存储库

如果您已安装 Rational Team Concert 2.0.0.2 版并且要升级到另一版本,请下载新版本并将其与现有版本并列安装,然后复制所需的配置文件以运行新版本。下一节描述您所需的配置文件。

如果先前版本是使用 zip 文件安装的,那么与先前安装没有交集。您可以使用 zip 文件将新版本安装到新位置,也可以使用 IBM Installation Manager 来安装新版本。我们建议您使用 IBM Installation Manager 来安装生产服务器,以便将来能够应用更新。

如果您先前使用 IBM Installation Manager 来安装服务器,并且要使用 IBM Installation Manager 来安装新版本,那么在使用 Installation Manager 执行新安装期间,请不要覆盖先前版本。在安装向导的安装软件包页面上,请选择创建新的软件包组

这将在另一位置安装新版本,并且将使用新的软件包组名来创建程序快捷方式。

如果您未执行此任务,那么安装过程将由于文件冲突而失败。在这种情况下,您将看到标题为安装失败的错误对话框,并且详细信息将显示以下文本:

安装失败。
  "安装"阶段发生错误:
    未能将 zip 标准 1.0.1.I20081018-1820 解压缩。文件
    D:\JazzTeamServer\server\license-update-site\site.xml 已存在。

这不是致命错误;您可以重新启动安装并正确地创建新的软件包组。

WebSphere Application Server 配置更新

要在 Rational Team Concert 2.0.0.2 中正确地配置 WebSphere Application Server,必须执行下列步骤。

  1. 确保已安装 WAS 和 WASDK 的最新修订包。如果正在 WAS 7.0 中执行部署,那么至少安装 WebSphere Application Server 7.0.0.3 至关重要。
  2. 除去旧的定制 JVM 属性:
    1. com.ibm.team.repository.provision.profile
    2. com.ibm.team.server.configURL
    3. log4j.configuration
  3. 添加新的定制 JVM 属性 JAZZ_HOME 并将值设置为:
    file:///<JazzInstallDir>/server/conf
  4. 确保已选中 WAS 安全设置"访问未受保护的 URI 时使用可用的认证数据"。如果您正在使用 WAS 集成解决方案控制台,那么可以通过以下过程来完成此任务:
    1. 转到"安全性"->"安全管理、应用程序和基础结构"->"Web 安全性 - 常规设置"。
    2. 选中"访问未受保护的 URI 时使用可用的认证数据"复选框。

从先前安装的服务器复制所需的配置文件

请将下列文件从源服务器复制到目标服务器。首先,将所升级服务器中的原始文件重命名,以便创建备份。如果您先前曾使用 IBM Installation Manager 从 1.0, 1.0.1、1.0.1.1 或 2.0 更新到 2.0.0.2,那么已在安装位置的服务器子目录中创建名称类似于 backup-config-时间戳记 的备份目录,此目录包含 1.0.x 或 2.0 配置文件。

如果您正在升级至 Standard Edition 或 Enterprise Edition,并且已购买 Developer Client Activation Kit for Express,那么请购买并安装 Developer Client Activation Kit for Standard Edition 或 Enterprise Edition,以便可以使用那些客户机许可证。分配给您的开发者许可证仍有效,但开发者许可证在正确的激活套件安装完毕后将被取消激活。

安装 2.0.0.2 激活密钥

2.0.0.2 发行版使用 2.0.0.2 激活密钥。如果将服务器从 1.0.x.x 升级至 2.0.x,那么完成升级后,将恢复试用许可证,您必须从 IBM Rational 许可证密钥中心获取 2.0 或 2.0.0.2 激活密钥。

有关 IBM Rational 许可证密钥中心的更多信息,请参阅 IBM Rational 许可证发放支持站点以及相关的 jazz.net 技术提示

以下是每个套件的适用密钥的名称:

设置项目时间线

在 Rational Team Concert 1.x 中,项目可以包含多条时间线(以前称为"开发线"),并且所有这些时间线都被视为等同。

在 Rational Team Concert 2.0 中,项目仍可以包含多条时间线,但可以将其中一条时间线标记为"项目时间线"。将数据库迁移至 2.0 之后,项目的主时间线未知,因此不会对项目设置项目时间线。升级至 2.0 之后,您可以手动更新项目以设置项目时间线。

配置源代码控制管理快照

数据仓库的源代码控制管理(SCM)快照用于收集流的数据,其中包括关于流大小以及流中的活动(变更集和文件/文件夹变更)的信息。在 V1.0 中,此快照将自动收集关于所有流的信息。由于此操作的成本很高,所以在 V2.0 中,对 SCM 快照添加了可配置性选项,以便允许用户决定应该对哪些流收集数据。此变更的直接效果是,除非您进行配置,否则不会收集任何数据。

要配置 SCM 快照,请执行下列操作:

  1. 要收集流的数据,您必须对其具有写许可权。
  2. 转到 Web UI 中的报告页面。
  3. 在左导航面板中,选择管理 SCM 快照。此时将显示流的列表。
  4. 选中一个或多个流的复选框,然后选择保存变更

在所有后续快照中,将对选择的流收集数据。

对 BIRT 报告所作的不兼容变更

如果您已使用 BIRT 报告设计器来创建自己的报告模板,那么尝试在 V2.0 中使用这些报告时,您可能会遇到一个或多个问题。您应该了解以下问题:

导入数据仓库中的工作项数据

在 Rational Team Concert 2.0 中,对数据仓库中的工作项表进行了多项模式变更。所以,从 1.0 迁移至 2.0 时,导入器将忽略任何仓库工作项数据。因此,第一次启动 2.0 服务器时,工作项报告可能无法正常工作。变通方法是,等待工作项快照第一次运行,或者在启动服务器后以手动方式运行该快照。在完成迁移后的第一次运行时,工作项快照将重新构造数据仓库中的全部历史工作项信息。这还意味着,在完成迁移后第一次运行快照时,耗时有可能远远超出一般的夜间运行。

发现新报告

在 Rational Team Concert 2.0 中,添加了多个新报告。虽然这些报告将在随产品一起交付的新过程模板中出现,但在迁移期间,它们不会被自动添加到现有的项目区域。我们添加了一项新操作,此操作将帮助您在完成迁移后发现这些新报告模板并将其部署到现有的项目区域。要部署新的报告模板,请执行下列操作:

  1. 在胖客户机中,打开团队工件视图。
  2. 展开项目区域,然后展开报告
  3. 右键单击报告模板并选择部署新模板

此对话框将帮助您发现可用但尚未部署到项目区域的任何报告模板。您可以选择其中的一个或多个报告模板,将创建这些报告模板。在创建之后,您可以通过可用的菜单操作根据那些模板来创建新报告。

定制

从 1.x 升级到 2.0 时,您对工作项类型、属性、工作流程、角色和事件处理程序所作的变更都将保留下来。请注意,如果您已对预定义的过程模板(例如 Scrum)进行定制,那么在"过程模板"视图中重新部署预定义的模板时,将覆盖您所作的定制。如果需要重新部署预定义的模板,那么应该先变更已定制的预定义模板的名称和标识,以使其不会被覆盖。

Standard Edition 和 Enterprise Edition 安装概述

安装包中包含您完成安装所需要的所有资源。

缺省配置中包含:

注:
联机帮助提供了一个可选的,以帮助您选择配置和记录决定。

准备安装 Standard Edition 或 Enterprise Edition

在安装此服务器之前,请验证是否满足特别注意事项。

关于 Linux 的特别指示信息

当 Jazz Team Server 安装在 Linux 上时,请查看下列特别指示信息。

使用 IBM Installation Manager 来安装 Standard Edition 或 Enterprise Edition

在获得安装文件之后,开始安装。

关于此任务

Jazz Team Server、Rational Team Concert 客户机、构建系统工具箱、 ClearCase® Connector、ClearQuest® 连接器和其他孵化器文件都可从 http://jazz.net 下载。要购买 Rational Team Concert,请访问 http://www.ibm.com/software/awdtools/rtc/,您可以从中下载可安装映像或者订购 DVD。

  1. 下载下列其中一个安装包。选择您要在其上进行安装的平台。

    通过使用 IBM Installation Manager,可以采用两种方法来安装 Rational Team Concert Standard Edition 或 Enterprise Edition。

  2. 启动启动板程序。

    如果 Installation Manager 未运行,请将它启动。

    注:
    您必须具有管理员特权才能运行启动板程序。
  3. 当启动板程序启动时,您将看到要安装的各项的列表。按照所列示的顺序安装您要使用的每个包。
    1. 安装 Jazz Team Server。

      当使用 IBM Installation Manager 时,在安装过程中请记下"位置"页面上的"安装目录"。此目录称为 JazzInstallDir

      注:
      如果您打算使用现有应用程序服务器而不使用所包含的 Apache Tomcat 服务器,那么请取消选中 Apache Tomcat 包复选框。取消选中之后,将仅安装必需的文件以与现有应用程序服务器配合使用。Installation Manager 将提示您选择这些文件的安装位置。
    2. 可选:安装 DB2 工作组服务器。
      注:
      虽然 Derby 数据库包含在缺省配置中,无需再进行安装,但是此数据库不能支持 10 个以上的用户。如果要支持 10 个以上的用户,并且他们对现有的 DB2 或 Oracle 数据库没有访问权,那么请安装捆绑的 DB2 工作组服务器版。

      如果您安装 DB2 工作组服务器,请记录用户标识、密码和端口号。稍后将需要此信息。在安装期间接受缺省值可以简化 Jazz Team Server 配置。

    3. 安装 Rational Team Concert 客户机。
    4. 可选:安装 构建系统工具箱。
    5. 可选:安装 ClearCase Connector。
    6. 可选:安装 ClearQuest 连接器。

设置数据库

安装数据库之后,需要完成配置工作。

捷径:
如果您要使用产品中所包含的 Derby 数据库,那么不需要额外进行设置。请继续启动服务器

下面是关于设置数据库时应执行的步骤的概述:

  1. 创建数据库。
  2. 配置属性文件。
  3. 创建数据库表。

如果您正在使用任何受支持的 DB2 版本,请转到设置 DB2 数据库

如果您正在使用 Oracle,请转到设置 Oracle 数据库

如果您正在使用 SQL Server,请转到设置 SQL Server 数据库

设置 DB2 数据库

设置受支持的 DB2 或捆绑的 DB2 工作组服务器数据库,使其与 Jazz Team Server 协同工作。

开始之前

本过程假定已满足下列先决条件。请查阅 DB2 文档或者咨询 DB2 数据库管理员(DBA)以获取帮助。

关于此任务

要设置 DB2 数据库,请执行下列操作:

  1. 在 DB2 命令窗口中创建数据库。 示例命令将创建一个称为 JAZZ 的新数据库。这些命令在 DB2 命令窗口中运行。可以从"DB2 命令行工具"菜单下的"应用程序启动"菜单来打开此命令窗口。
    注:
    为了确保正确处理 Unicode 内容,数据库字符集必须采用 UTF-8 编码。由于 AUDITABLE_LINKS 表在 Windows 上的缺省页大小(4K)中放不下,所以请将页大小设置为 8K。
    提示:
    如果数据库未运行,那么 db2start 命令将启动 DB2。
  2. JazzInstallDir/server/conf/jazz 目录中找到 teamserver.properties 文件并将其重命名为 teamserver.derby.properties
  3. JazzInstallDir/server/conf/jazz 目录中找到 teamserver.db2.properties 文件并将其重命名为 teamserver.properties
  4. teamserver.properties 文件中指定数据库和连接详细信息。

    缺省连接规范将连接至在端口 50000 上的 localhost 中运行的 DB2 数据库。该数据库称为 JAZZ,用户名和密码都是 db2admin。如果设置数据库时使用了缺省值,那么可能已正确配置了 teamserver.properties 文件。否则,请变更此信息使它与您的配置相匹配。

    1. 在文本编辑器中打开 teamserver.properties 文件。
    2. 找到下列行:
      com.ibm.team.repository.db.vendor = DB2
      com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
      com.ibm.team.repository.db.jdbc.password=db2admin
    3. 编辑 DB2 服务器和数据库的 com.ibm.team.repository.db.jdbc.location 的值。
      提示:
      在 DB2 命令窗口中,运行 db2 get dbm cfg 命令,然后查找包含 SVCENAME 的那一行,它指示 DB2 端口名或端口号。如果此命令显示了一个编号,那么将它用作端口号(替代以上示例中的 50000)。如果此命令返回了一个不是数字的名称,那么请确定已为此名称指定的端口号并使用此端口号。在 Linux 上,/etc/services 文件中包含端口名与端口号之间的映射;而在 Windows 上,C:\windows\system32\drivers\etc\services 文件中包含此映射。有关更多信息,请咨询数据库管理员或者查阅数据库文档。
    4. 编辑您的 DB2 用户名的 com.ibm.team.repository.db.jdbc.location 的值。
      注:
      DB2 用户必须具有创建表和表空间以及修改数据库配置的许可权。DB2 用户由操作系统创建。
    5. com.ibm.team.repository.db.jdbc.password 属性中指定用户密码。
      注:
      请不要变更 com.ibm.team.repository.db.jdbc.location 属性中的 password={password} 文本。
    6. 必要时,将 com.ibm.team.repository.db.db2.content.tablespace.location 属性变更为 Jazz Team Server 上可以在其中创建主要表空间路径。
      注:
      如果此值仍保持为缺省值 content_tablespace,那么将在数据库存储位置下创建表空间。在 Windows 上,如果指定了新路径,那么必须使用双反斜杠来指定此路径,例如:com.ibm.team.repository.db.db2.content.tablespace.location=c:\\db2\\jazz\\content_tablespace。

有关 DB2 的特别指示信息

使用 DB2 数据库时,请复查以下信息。

注:
本主题中所列示的命令只是一些示例。请查阅产品文档以了解详细信息。
注:
在 DB2 中创建数据库时,页大小必须为 8 KB。

查阅 DB2 文档以验证您的系统是否满足需求以及配置是否正确。

要利用状态选项访存优化(这种优化可以提高大型数据库的性能),DB2 用户必须设置 DB2_OPTPROFILE。运行下列命令来设置 DB2_OPTPROFILE。

db2set DB2_OPTPROFILE=YES
db2stop
db2start
注:
在运行这些命令之后,将停止并重新启动数据库。安装过程中的后续步骤将要求您停止并启动数据库。如果您刚开始安装,那么可以稍后重新启动数据库。

确保上述所有步骤都成功。要了解是否设置了 DB2_OPTPROFILE,请运行以下命令:

db2set DB2_OPTPROFILE

设置 Oracle 数据库

设置 Oracle 数据库,使其与 Jazz Team Server 协同工作。

开始之前

本过程假定已满足下列先决条件。请查阅 Oracle 文档或者咨询 Oracle 数据库管理员(DBA)以获取帮助。

在 Oracle 上运行 Jazz Team Server 时,创建一个 Oracle 表空间来提高性能。您必须创建一个与该表空间相链接的用户。

切记:
这些步骤都不是由数据库构建器和存储库工具执行的。

关于此任务

要设置 Oracle 数据库,请执行下列操作:

  1. 创建表空间。 表空间位置必须适合于机器和磁盘驱动器。此步骤必须由具有 DBA 特权的用户执行。
    注:
    表空间可以具有下列任何属性:
    • oracle_tbs 之外的名称
    • 另一个目录中的位置
    • 大于 1GB 的大小。对于大型安装,需要分配更多空间。
    以下示例显示了一个已在 Windows 机器上执行的 creat 语句:
    CREATE BIGFILE TABLESPACE oracle_tbs DATAFILE 'D:\oracle_tbs\oracle_tbs.dbf' SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
    要点:
    目录路径(在此示例中为 D:\oracle_tbs)必须存在。不必创建一个单独的特殊表空间。可以使用 Oracle 缺省 USERS 表空间,但是如果 Oracle 使用在它管理的磁盘上预先分配的空间,那么性能将更高。
  2. 创建 Oracle 用户。

    创建表空间之后,必须为 Jazz 创建一个特殊的 Oracle 用户以使用 Oracle 数据库。

    在此示例中,用户具有名称 jazzDBuser 和密码(在 Oracle 术语中是 IDENTIFIED BYjazzDBpswd,并且存在于步骤 1 中所创建的表空间中。
    CREATE USER jazzDBuser IDENTIFIED BY jazzDBpswd DEFAULT TABLESPACE oracle_tbs;
    创建用户之后,应该将初始化 Jazz 数据库所需的许可权授予该用户。可以使用下列 SQL 命令来授予适当的许可权:
    GRANT CREATE SESSION TO jazzDBuser;
    GRANT CREATE TABLE, ALTER ANY TABLE, DROP ANY TABLE, CREATE ANY INDEX, ALTER ANY INDEX, DROP ANY INDEX TO jazzDBuser;
    GRANT INSERT ANY TABLE, UPDATE ANY TABLE, DELETE ANY TABLE TO jazzDBuser;
    GRANT CREATE PROCEDURE TO jazzDBuser;
    GRANT CREATE VIEW TO jazzDBuser;
  3. JazzInstallDir/server/conf/jazz 目录中找到 teamserver.properties 文件并将其重命名为 teamserver.OtherDBProvider.properties
  4. JazzInstallDir/server/conf/jazz 目录中找到 teamserver.oracle.properties 文件并将其重命名为 teamserver.properties
    提示:
    通过将原始的 teamserver.properties 文件重命名,您以后就能够将该文件恢复为先前工作版本。缺省情况下,DB 提供程序是 derby
  5. 配置服务器
    1. 如果您已使用另一个用户名、密码或数据库名称、已将 Oracle 服务器与 Jazz Team Server 安装到不同机器或者正在使用除缺省端口以外的端口,请编辑服务器配置文件。打开 JazzInstallDir/server/conf/jazz 目录中的 teamserver.properties 文件并变更下列信息,以使其与您的设置匹配。

      com.ibm.team.repository.db.vendor = ORACLE

      com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL

      请将 jazzDBuser 变更成为了使用 Oracle 数据库而为 Jazz 创建的用户。如果正在使用本地主机,请通过除去行首的 # 取消对此行的注释,并注释掉下一个位置行。本地主机连接字符串不应该包含前导 //。请将 1521 变更为 Oracle 服务器 TCIP 端口。并且,请将 ORCL 变更为 Oracle 数据库名称。

      com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@//oracleserver.example.com:1521/ORCL

      切记:
      Oracle 位置 URL 可以采用多种格式。此处的示例在大多数情况下有效。有关详细信息,请查阅 Oracle JDBC 文档。

      如果正在使用非本地主机连接,请通过除去行首的 # 取消对此行的注释,并注释掉上一个位置行。非本地主机连接字符串必须包含前导 //。

      com.ibm.team.repository.db.jdbc.password=jazzDBpswd

      请将 jazzDBpswd 变更成为了使用 Oracle 数据库而为 Jazz 创建的用户的密码。

      要点:
      请不要变更 com.ibm.team.repository.db.jdbc.location 属性中的 {password} 文本。必须在属性 com.ibm.team.repository.db.jdbc.password 中指定用户密码。

      如果您正在使用 Oracle Express,请使用 1521 作为 TCIP 端口,并使用 XE 作为 Oracle 数据库名称:

      com.ibm.team.repository.db.vendor = ORACLE
      com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/XE
      com.ibm.team.repository.db.jdbc.password=jazzDBpswd
    2. 在服务器脚本所在的目录(JazzInstallDir/server)中,创建一个名为 oracle 的目录。
    3. 找到名为 ojdbc14.jar 的 Oracle JDBC 驱动程序 JAR 文件。其位置会随 Oracle 产品和操作系统不同而改变。将此文件复制到名为 oracle 的目录中。
      注:
      如果您正在使用 WebSphere Application Server,请配置名为"ORACLE_JDBC"的属性;然后,将其设置为 Oracle JDBC 驱动程序所在的绝对目录路径(而不是 URL),例如,如果 ojdbc14.jarJazzInstallDir/server/oracle 中。在 WebSphere Application Server 安装指示信息中描述了此任务。请记下此文件路径,以供稍后在这些指示信息中使用。
  6. 打开 SQL plus 窗口并输入以下命令:
    GRANT DBA TO jazzDBuser;

设置 SQL Server 数据库

设置 SQL Server 数据库,使其与 Jazz Team Server 协同工作。

本过程假定已满足下列先决条件:

切记:
JazzInstallDir/server/teamserver.properties 文件中,为 SQL Server 数据库定义的缺省登录名是 jazzDBuser,缺省密码是 jazzDBpswd。在下列用于创建数据库的步骤中,将使用这些值。您可以将这些值替换为您所使用数据库的用户名和密码。

设置数据库

本节描述如何使用命令行工具 sqlcmd 来设置 SQL Server 数据库,此工具由 SQL Server 安装版本附带提供。您还可以使用可视工具,例如 SQL Server Studio Management,此工具 与 SQL Server Studio Management Express 一样,也适用于 Express 版。有关更多信息,请参阅 SQL Server 文档或者与 SQL Server 数据库管理员(DBA)联系。

要使用命令工具 sqlcmd 来设置 SQL Server 数据库,请执行下列操作:

  1. 创建 Jazz Team Server 数据库。在命令行工具中,输入以下命令:
    CREATE DATABASE jazz
    GO 
  2. 创建用户和密码,然后变更 Jazz Team Server 数据库的所有权。在命令行工具中,输入以下命令:
    CREATE LOGIN jazzDBuser
    WITH PASSWORD = 'jazzDBpswd';
    USE jazz;
    exec sp_changedbowner 'jazzDBuser'
    GO 
  3. 变更 Jazz Team Server 数据库的整理顺序。在命令行工具中,输入以下命令:
    ALTER DATABASE jazz COLLATE SQL_Latin1_General_CP437_CS_AS
    GO

配置服务器

切记:
缺省情况下,JazzInstallDir/server 目录中的 teamserver.properties 文件未设置为连接到 SQL Server 数据库。同一目录中的 teamserver.sqlserver.properties 文件包含所有缺省设置以及 SQL Server 所特有的设置。

要配置服务器,请执行下列操作:

  1. 将下列文件重命名:
    提示:
    通过将原始的 teamserver.properties 文件重命名,您以后就能够将该文件恢复为先前工作版本。缺省情况下,DB 提供程序是 derby
  2. 如果您已使用另一个用户名、密码或数据库名称、已将 SQL Server 与 Jazz Team Server 安装到不同机器或者正在使用除缺省端口以外的端口,请编辑服务器配置文件。打开 JazzInstallDir/server/conf/jazz 目录中的 teamserver.properties 文件并变更下列信息,以使其与您的设置匹配。
    com.ibm.team.repository.db.vendor = SQLSERVER
    com.ibm.team.repository.db.jdbc.location=//SQL SERVER MACHINE IP:SQL SERVER TCIP PORT;databaseName=JAZZ DATABASE NAME;user=JAZZ USERNAME;password={password}
    com.ibm.team.repository.db.jdbc.password=JAZZ LOGIN PASSWORD
    要点:
    请不要变更 com.ibm.team.repository.db.jdbc.location 属性中的 password={password} 文本。必须在属性 com.ibm.team.repository.db.jdbc.password 中指定用户密码。
要点:
(仅限于 Windows)请确保服务器安全性处于混合方式。您可以通过检查服务器安全性进行此验证。它应该设置为"SQL Server 和 Windows 认证方式"。

要指定 JDBC 的 jar 文件位置,请执行下列操作:

  1. 在服务器脚本所在的目录(JazzInstallDir/server)中,创建一个名为 sqlserver 的目录。
  2. 找到名为 sqljdbc.jar 的 SQL Server JDBC 驱动程序 JAR 文件。此文件的所在位置随驱动程序安装位置的不同而有所变化,如先决条件一节所述。将该文件复制到新创建的 sqlserver 目录中。
  3. 通过完成下列任务,指定 JDBC 的 JDBC JAR 文件位置:

故障诊断

如果 repotools 命令未成功,那么请检查日志文件 JazzInstallDir/server 目录中的日志文件 repotools_createTables.log

并且,请验证下列各项:

注:
Jazz Team Server 的数据库代码设计成具有通用性和标准性,能够在多种数据库平台上运行;但是,不同企业数据库供应商的系统在语法、优化策略和锁定语义方面有所差别。我们已使用各种自动化测试功能以及模拟正常工作负载和压力测试在 SQL Server 上测试此服务器。对正常工作负载的模拟表明性能可接受。在某些情况下,执行自动化并行测试时观察到数据库死锁现象;但是,这些现象在不同的服务器硬件上并不会一贯地再现。

服务器的设计支持为大量并发请求提供服务。在某些异常情况下,在存储库数据库中会发生死锁,原因是与那些请求相关联的事务以并发方式更新类似的或等同的对象。这些情况很罕见,但并非不正常。系统能够抵御这种情况,数据完整性将得以维护;不会丢失数据。有时,执行构建引擎之类的任务将记录死锁情况。通常,死锁情况将被检测到,并且该任务将被重试。死锁可能会导致构建失败。在非常罕见的情况下,要解决死锁,必须中止用户操作(例如处理工作项或源代码)。在这种情况下,该用户操作将失败,并且将向用户显示带有与死锁相关的详细信息的错误。然后,该用户可以重试该操作。

遇到的所有死锁都将记录在服务器上,以便提供有关发生死锁时的情况的信息。日志条目的文本类似于:com.ibm.team.repository.common.RetryableDatabaseException:序列化失败

如果您的系统遇到死锁,那么请查看错误日志,地址为:https://servername:9443/jazz/service/com.ibm.team.repository.common.internal.IFeedService?category=SystemLog

如果您频繁地遇到死锁异常,那么请与产品支持人员联系或者访问 jazz.net 上的论坛以获取最新信息、更新或迁移技术。

启动服务器

本主题描述了用于运行服务器启动脚本的不同选项。

关于此任务

如果您打算使用所包含的 Apache Tomcat 应用程序服务器,那么请准备启动 Jazz Team Server。

如果您打算使用 WebSphere Application Server,那么请按照 设置 WebSphere Application Server

启动 Apache Tomcat 服务器

您现在准备启动 Apache Tomcat 服务器。

Apache Tomcat 已安装在 JazzInstallDir/server/tomcat 目录中。Web 应用程序(jazz.war)已安装在 Apache Tomcat 目录 webapps 中。在命令窗口中,将当前目录设置为 JazzInstallDir/server。服务器启动和关闭脚本就位于此目录中。

在 Windows 上启动服务器

运行启动文件以在 Windows 上启动服务器。

关于此任务

  1. 要启动服务器,请从 JazzInstallDir/server 目录中运行以下命令:
    server.startup.bat
    注:
    将打开一个单独的 Apache Tomcat 控制台窗口。请不要关闭此窗口,否则服务器将停止工作。此外,还会显示多条参考消息,其中包括一条有关 Apache Tomcat 本机库的消息。这些参考消息并不会影响 Jazz Team Server 功能。
  2. 要停止服务器,请从 JazzInstallDir/server 目录中运行以下命令:
    server.shutdown.bat

下一步做什么

注:
以上示例将直接从 JazzInstallDir/server 目录中运行启动和停止脚本。如果您已经使用 IBM Installation Manager 来安装 Jazz Team Server,那么还可以从 Jazz Team Server Windows 启动菜单来运行这些命令。

在启动服务器之后,请继续运行安装向导

在 Linux 上启动服务器

运行启动文件以在 Linux 上启动服务器。

关于此任务

  1. 要启动服务器,请以 root 用户身份从 JazzInstallDir/server 目录中运行以下命令:
    ./server.startup
    如果您的用户标识具有管理员访问权,那么请运行以下命令:
    sudo ./server.startup

    单独的 Apache Tomcat 控制台窗口不可视。可以通过查看 JazzInstallDir/server/logs/jazz.log 中的日志文件来检查服务器的启动进度。

  2. 要停止服务器,请以 root 用户身份从 JazzInstallDir/server 目录中运行以下命令:
    ./server.shutdown
    如果您的用户标识具有管理员访问权,那么请运行以下命令:
    sudo ./server.shutdown

下一步做什么

注:
此示例将直接从 JazzInstallDir/server 目录中运行启动和停止脚本。如果您已经通过使用 IBM Installation Manager 来安装 Jazz Team Server,那么还可以从 Jazz Team Server 应用程序启动菜单来运行这些命令。

在启动服务器之后,请继续运行安装向导

设置 WebSphere Application Server

本主题描述了如何设置 Jazz Team Server 以使它与 WebSphere Application Server 一起工作。此设置步骤假定您要在安装 Websphere Application Server 的机器上安装 Jazz Team Server。

开始之前

在开始执行这些步骤之前,应当已经完成了下列任务:

提示:
当使用 IBM Installation Manager 时,可以将 Jazz Team Server 文件安装到 Web 应用程序目录中。在安装过程中,您不应安装所包含的 Apache Tomcat 应用程序服务器;这会使得 Installation Manager 要求使用 Web 应用程序目录并且仅安装 WebSphere 需要的文件。在 Windows 上,缺省目录为 C:\Program Files\IBM\JazzTeamServer;在 Linux 上,缺省目录为 /opt/IBM/JazzTeamServer。在此过程中,安装目录称为 JazzInstallDir。如果您使用 IBM Installation Manager 将文件安装到 WebSphere Application Server Web 应用程序目录中,那么您不需要如上所述手动移动文件。

关于此任务

注:
本文档并不会阐述 WebSphere 认证或 SSL 的配置,这是一个复杂的主题。WebSphere 信息中心中提供了有关 WebSphere 的各种认证和加密选项的详细信息。有关更多信息,请访问 WebSphere 信息中心并搜索保护应用程序和它们的环境。Jazz Web UI 要求配置认证以便执行授权并将应用程序个性化。

  1. 复查并更新 teamserver.properties 文件中的数据库位置。
    com.ibm.team.repository.db.vendor = DB2
    com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
    com.ibm.team.repository.db.jdbc.password=db2admin
    注:
    这是样本 DB2 配置。您应该根据数据库供应商(Oracle/MS-SQL)对 teamserver.properties 进行更新。
  2. 验证或更新 WebSphere Application Server 级别。

    Jazz Team Server 需要已应用 IBM Java SDK 1.5 SR5 或更高版本累积修订的 WebSphere Application Server V6.1 或者至少已安装 7.0.0.3 的 WebSphere Application Server V7.0。可从 http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492 获得 IBM Java SDK 1.5 SR6 SDK 更新。借助 WebSphere 6.1 和 GA IBM Java SDK,在执行一定数量的操作之后,Jazz 将开始报告"代理错误"。

    您必须获取正确运行 IBM Rational Team Concert 2.0 所必需的 IBM Java SDK 1.5 SR9 或 IBM Java SDK 1.6 SR4 的修订的相应 WebSphere Application Server i-fix。否则,服务器中的某些服务可能无法正确启动。这些 i-fix 在其相应的 WebSphere Application Server APAR 之下。对于 IBM Java SDK 1.5/WebSphere Application Server 6.1 而言,APAR 是 PK85942,您可以从 ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/ 下载文件。在安装 JRE i-fix 之前,请至少安装 WebSphere Application Server 6.1 修订包 19。对于 IBM Java SDK 1.6/WebSphere Application Server 7.0 而言,APAR 是 PK 86771,您可以从 ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/ 下载文件。

  3. 更新 JVM 参数。

    运行 Jazz Team Server 的 Java 虚拟机上需要一些特定设置。

    首先,它需要知道在何处查找某些配置文件。这是通过设置系统属性 JAZZ_HOME 实现的。此属性使用 URL 而不是简单路径,因此应该将值指定为 file://-style URL。

    Jazz JVM 需要的第二个属性是使用 -Xmx 设置为它提供多个缺省最大内存分配。应该根据服务器支持的团队大小以及正在运行 Jazz Team Server 的服务器的内存容量来设置此值。典型的中等规模团队可以使用值 -Xmx1536M,从而为 Jazz Team Server 进程提供 1536 MB 的堆内存。

    如果正在连接至 Oracle 或 SQL Server 数据库,那么需要添加名为"ORACLE_JDBC"或"SQLSERVER_JDBC"的属性。请将此属性设置为适当 JDBC 驱动程序的绝对文件路径(而不是 URL)。

    还需要设置其他系统属性以控制服务器的某些行为,下面包含了这些属性。下面是有关在 WebSphere 管理控制台中设置这些 JVM 属性的细节,请将 JazzInstallDir 替换为您的 Jazz Team Server 安装目录:

    1. 单击服务器 -> 应用程序服务器
    2. 单击 server1
    3. 单击 Java 和流程管理 -> 流程定义
    4. 单击 Java 虚拟机
    5. 添加 100 作为初始堆的值。
    6. 添加 1000 作为最大堆大小的值。
    7. 单击应用
    8. 单击记录和跟踪。单击变更日志详细信息级别。Jazz Team Server 使用 BIRT 报告引擎。要阻止 BIRT 参考条目被写入 WebSphere 日志文件,请对 org.eclipse.birt.* 包将记录级别设置为严重。单击应用
    9. 单击定制属性
    10. 添加下列属性: 单击新建,输入名称,然后单击"确定"。
      • 名称:java.awt.headless,:true
      • 名称:org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin,:true
      • 名称:JAZZ_HOME,:file:///JazzInstallDir/server/conf
    11. 在"保存到主配置"部分中,单击保存
    要点:
    (仅限于 Solaris)还必须添加以下 Java 命令行自变量:
    -XX:MaxPermSize=256m
    有关更多信息,请参阅 IBM WebSphere Application Server V6.1 on the Solaris 10 Operating System 红皮书的第 2 章"Configuring a Solaris environment for WebSphere Application Server"。
  4. 重新启动 Websphere 以安装 Jazz 应用程序。

    在下列命令行示例中,WASInstallDir 表示 WebSphere Application Server 在服务器中的安装位置。

    1. 打开 WebSphere Application Server 的管理控制台。
    2. 单击应用程序 -> 安装新的应用程序
    3. 新应用程序所在的路径下单击"本地文件系统"。
    4. 完整路径下输入:
      JazzInstallDir/server/jazz.war
    5. 上下文根设置为 /jazz。
    6. 单击下一步并继续完成其余的安装新的应用程序步骤。
    7. 单击完成
    8. 单击保存以直接保存到主配置中。
    9. 单击应用程序 -> 企业应用程序
    10. 选中 jazz_war 旁边的框,然后单击启动

      应出现一个绿色箭头,指示已成功启动应用程序。

下一步做什么

在启动服务器之后,请继续 运行安装向导

有关此主题的更多信息,请访问下列链接:

http://jazz.net/library/techtip/95

https://jazz.net/wiki/bin/view/Main/WASSetupFAQ

运行安装向导

运行安装向导时将验证服务器是否在正常运行并指导您完成用于配置服务器的步骤。

关于此任务

要验证 Jazz Team Server 是否正在连接至数据库,请查看服务器日志或者控制台输出。首次访问时会回送连接和数据库信息。目录 JazzInstallDir/server/logs 用于服务器日志文件。

本过程假定使用主机名 localhost 和缺省端口 9443 就可以访问您的服务器。必要时,将 localhost 替换为您的服务器主机名,并且替换端口 9443。

启动安装向导以配置您的服务器。使用 URL https://localhost:9443/jazz/setup
缺省用户名和密码区分大小写:

如果您已经配置了 LDAP 目录 Web 容器,那么请作为在 LDAP 目录中已定义的 JazzAdmin 用户进行登录。

选择安装路径。安装向导有两个主路径。



完成初始设置之后,可以在 Jazz Team Server 管理 Web 用户界面中通过使用 URL https://localhost:9443/jazz/admin 来配置其他选项。

下一步做什么

如果未装入服务器安装向导,那么请检查下列各项:

完成安装

安装服务器之后,在继续执行后续步骤之前必须考虑某些配置选项。

关于此任务

在安装之后,还需要执行一些额外的操作。

使用 IBM Installation Manager 来安装客户机

客户机是由 IBM Installation Manager 作为一个可下载文件来分发的。

关于此任务

注:
如果要将客户机安装到现有的 Eclipse 工作台中,请使用 IBM Installation Manager。IBM Installation Manager 安装提示您要扩展的工作台并且要认真管理工作台将来的更新、回滚和修改。
注:
如果启用了安全性增强的 Linux(SELinux),那么您必须禁用它或者变更 Java 运行时环境(JRE)的安全上下文,以允许对文本重新定位,以便安装和运行 Rational Team Concert。有关更多信息,请参阅 将 Rational Team Concert 与安全性增强型 Linux 并列安装

  1. 下载下列其中一个安装包。

    可以使用三种方法来安装 Rational Team Concert 客户机。

  2. 启动启动板程序。

    如果 Installation Manager 未运行,请完成下列步骤以将它启动。

    注:
    您必须具有管理员特权才能运行启动板程序。
    注:
    用于启动启动版程序的 Linux 命令仅限于用于 Eclipse IDE 的 Rational Team Concert。
    要启动启动板程序文件,请执行下列操作:
  3. 您可以安装以下客户机: 显示 Installation Manager 向导。 此向导指导您安装客户机。
  4. 通过单击安装过程所创建的 Rational Team Concert 快捷方式来启动客户机。
  5. 连接至服务器。 连接至服务器最简单的方法是使用"团队邀请"。如果您未获得邀请,那么可以手动建立连接。
    1. 单击文件 -> 接受团队邀请。此向导将指导您完成过程。
      注:
      如果您未获得邀请,那么需要请求服务器管理员提供 URI 或 URL。(其示例格式为:https://example.com:9443/jazz)。单击接受团队邀请窗口右下角出现的连接至现有项目区域超链接。
    2. 遵循向导中提供的指示信息来建立连接。

示例

故障诊断:下面是建议您采用的一些问题管理技术。

下一步做什么

在成功安装了客户机之后,应当参阅下列主题以帮助您开始了解 Rational Team Concert。

从 IBM Installation Manager 安装 构建系统工具箱

可以使用 IBM Installation Manager 将 构建系统工具箱 安装在构建机器上。

关于此任务

  1. 启动启动板程序。

    如果 Installation Manager 未运行,请将它启动。

    注:
    您必须具有管理员特权才能运行启动板程序。
  2. 当启动板程序出现时,单击 构建系统工具箱 以启动安装过程。
  3. 完成安装之后,可以配置构建。可以在关于 Jazz 团队构建中找到有关 构建系统工具箱 的更多信息。

使用 IBM Installation Manager 来安装 Rational® Team Concert ClearCase Connector

可以使用 IBM Installation Manager 将 ClearCase Connector安装在构建机器上。

关于此任务

  1. 启动启动板程序。

    如果 Installation Manager 未运行,请将它启动。

    注:
    您必须具有管理员特权才能运行启动板程序。
  2. 当启动板程序出现时,单击 ClearCase Connector以启动安装过程。
  3. 完成安装之后,请配置 ClearCase Connector。请参阅部署 ClearCase Connector

使用 IBM Installation Manager 来安装 Rational Team Concert ClearQuest 连接器

可以使用 IBM Installation Manager 将 ClearQuest 连接器安装在构建机器上。

关于此任务

  1. 启动启动板程序。

    如果 Installation Manager 未运行,请将它启动。

    注:
    您必须具有管理员特权才能运行启动板程序。
  2. 当启动板程序出现时,单击 ClearQuest 连接器以启动安装过程。
  3. 完成安装之后,请配置 ClearQuest 连接器。请参阅部署 ClearQuest 连接器

将 Rational Team Concert 与安全性增强型 Linux 并列安装

如果已启用安全性增强型 Linux(SELinux),那么您必须禁用它或者变更用于安装和运行 Rational Team Concert 的 Java 运行时环境(JRE)的安全上下文,以允许对文本重新定位。

关于此任务

如果您已经设置了一台机器,且此机器仅用于评估 Rational Team Concert,而 SELinux 功能部件对您来说并不重要,那么可以继续完成后续步骤的最简单方法是禁用 SELinux。

注: