为 Rational Engineering Lifecycle Manager 和 Lifecycle Query Engine 设置 Oracle 数据库

设置 Oracle 数据库以与 Rational® Engineering Lifecycle Manager Jazz™ Team ServerRational Engineering Lifecycle Manager 和“配置管理”应用程序一起运行。

开始之前

为了创建并设置 Oracle 数据库,假定准备此数据库的用户对此数据库具有数据库管理权限,并假定此数据库、表空间存储器和相应存储配置由具有系统管理权限的用户创建。并且,必须在要用作数据库服务器的计算机上安装下列其中一个受支持的 Oracle 版本。此计算机可以不是运行 Jazz Team Server 的计算机:
注: Oracle 10g 和 11g 所需要的 Java™ 数据库连接 (JDBC) 驱动程序是 ojdbc6.jar 11.2.0.3 或更高版本。并且,请将数据库始终更新到最新的数据库版本。例如,如果数据库服务器版本为 11.2,那么您应该运行 11.2.0.3 或更高版本。
要点: 下列配置参数和表空间选项是示例,可能并不完全适用于您的环境。例如,如果您无法使用 AUTOEXTEND 设置,那么文件必须足够大以允许进行增大。或者,如果无法对 Jazz Team Server 数据库用户使用 UNLIMITED 大小配额,请确保有足够的空间以备数据库快速增大。
要点: 如果您将 Rational Engineering Lifecycle Manager 应用程序安装在同一计算机上或者安装在分布式平台上,那么您可以为每个应用程序创建不同的数据库,也可以对所有应用程序使用同一个数据库。但是,必须为每个应用程序创建一个不同的表空间以及一个与该表空间相关联的数据库用户。

本主题中的示例针对一个 Oracle 数据库,对于每个应用程序,此数据库都有相应的专用数据库用户。

注: 您为 Jazz Team Server 以及所有 Rational Engineering Lifecycle Manager 应用程序创建的数据库的格式必须设置为使用 UTF-8 作为字符集。缺省情况下,Oracle 不创建使用 UTF-8 字符集的数据库。您创建新数据库时,请确保在 Oracle 数据库设置中选择 AL32UTF8

过程

  1. 以系统管理员身份为 Jazz Team Server 和所有应用程序创建使用 UTF8 编码的数据库。
  2. 打开 SQL *Plus 窗口并创建数据库表空间:
    CREATE TABLESPACE <relmjts user tablespace> 
    DATAFILE '<path and name of .dbf file>' 
    SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
    CREATE TEMPORARY TABLESPACE <relmjts user temp tablespace> 
    TEMPFILE '<path and name of the temp .dbf file>' 
    SIZE 20M AUTOEXTEND ON EXTENT MANAGEMENT LOCAL UNIFORM SIZE 1M;
  3. 如果您正在安装所有 Rational Engineering Lifecycle Manager 应用程序,那么必须重复执行上述步骤两次,以便为 Rational Engineering Lifecycle Manager JTS (relmjts)、Rational Engineering Lifecycle Manager (relm) 和“配置管理”应用程序 (vvc) 创建不同的表空间。在 Oracle Enterprise Manager Database Control 中,验证您创建的表空间是否已显示并可访问。
  4. 为每个新的表空间创建一个 Oracle 数据库用户。

    创建表空间之后,必须为每个应用程序创建一个特殊 Oracle 用户以使用 Oracle 数据库。对于使用同一个 Oracle 数据库运行的多个 Jazz 服务器,必须为每个应用程序都创建一个 Oracle 数据库用户。这个 Oracle 数据库用户必须能够在其表空间(不受限或者具有空间配额)中使用创建会话、表、过程和视图的特权创建数据库对象。

    在以下示例中,请替换尖括号中的短语。
    CREATE USER <relmjts db user> IDENTIFIED BY <password> DEFAULT TABLESPACE <relmjts user tablespace> QUOTA UNLIMITED ON <relmjts user tablespace> TEMPORARY TABLESPACE <relmjts user temp tablespace>;
    创建用户之后,请将初始化 Jazz 数据库所必需的许可权授予此用户。以下 SQL 命令可用来授予适当的许可权:
    GRANT CREATE PROCEDURE, CREATE SESSION, CREATE TABLE, CREATE VIEW TO <relmjts db user>;
    注: 与其他数据库相比,在 Oracle 上创建仓库时需要具备更多许可权。您在数据仓库的连接规范中指定数据库用户时,请确保该数据库用户具有 DBA 许可权。有关更多信息,请参阅完成安装。此外,假定已存在名为“USERS”的表空间。这是缺省 Oracle 表空间。如果您的 Oracle 数据库中不存在此表空间,请使用以下命令来创建此表空间。
    CREATE TABLESPACE USERS 
    DATAFILE '<path and name of .dbf file>' 
    SIZE <tablespace size> AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
  5. 创建一个名为 ORACLE_JDBC_DRIVER_FILE 的环境变量,并使其指向 ojdbc6.jar JDBC 驱动程序。该位置可能因 Oracle 产品和操作系统的不同而有所变化。可以从 www.oracle.com下载受支持的 Oracle JDBC 驱动程序 (ojdbc6.jar 11.2.0.3)。
    1. 单击开始 > 控制面板 > 系统
    2. 单击高级选项卡,然后单击环境变量
    3. 系统变量列表中,单击新建
    4. 变量名称中输入 ORACLE_JDBC_DRIVER_FILE,在变量值中输入 C:\Path_to_JDBC_dirver\ojdbc6.jar
    1. 在 Linux 系统上,添加以下环境变量声明:
      ORACLE_JDBC_DRIVER_FILE =.;Path_to_JDBC_dirver/ojdbc6.jar
      注: Rational Engineering Lifecycle Manager 不支持 JRE 5.0。受支持的 JRE 版本为 6.0 和 7.0。ojdbc5.jar 类库要求 JRE 5.0,而 ojdbc6.jar 类库要求 JRE 6.0 或更高版本。您必须使用 ojdbc6.jar

      如果您正在使用 WebSphere® Application Server,那么您还必须添加指向 JDBC 驱动程序 ojdbc6.jar 的定制属性。有关更多信息,请参阅为 Rational Engineering Lifecycle Manager 设置 WebSphere Application Server

  6. 要配置数据库连接并创建数据库表,请完成下列其中一个步骤:
    1. 如果您正在使用 Tomcat,请启动服务器,然后为 Rational Engineering Lifecycle Manager 应用程序运行 Jazz Team Server 设置向导
    2. 如果您正在部署 WebSphere Application Server,请参阅为 Rational Engineering Lifecycle Manager 应用程序运行 Jazz Team Server 设置向导

手动配置 Oracle 数据库

关于此任务

建议您通过运行设置向导来配置数据库连接和创建数据库表。要运行设置向导,请遵循以下主题中的指示信息:为 Rational Engineering Lifecycle Manager 应用程序运行 Jazz Team Server 设置向导

如果您更愿意手动执行此过程,请使用此主题来编辑 teamserver.properties 文件以建立 Oracle 数据库连接,以及运行 -createTables 命令来创建数据库表。

过程

  1. 对于每个应用程序,您都必须打开并修改一个相应的 teamserver.properties 文件。这些文件位于 <JazzInstallDir>/server/conf 目录下的相应目录(relmjtsrelmvvc)中。打开每个 teamserver.properties 文件,并指定数据库和连接详细信息。
    1. 在“Derby 配置”下面,通过在每行前面添加编号符 (#) 来注释掉下列各行:
      # com.ibm.team.repository.db.vendor = DERBY
      # com.ibm.team.repository.db.jdbc.location=conf/relmjts/derby/repositoryDB
    2. 在“Oracle 配置”下面,通过除去每行旁边的编号符 (#) 来取消注释下列各行:
      注: 为每个存储库提供了两行用于说明数据库位置。一行用于本地系统,一行用于远程系统上的数据库服务器。仅取消注释适用于您所在环境的那一行。下列示例适用于远程服务器,在服务器 URL 前面有两个正斜杠:@//oracleserver.example.com:1521/ORCL
      com.ibm.team.repository.db.vendor = ORACLE
      com.ibm.team.repository.db.jdbc.location=thin:relmjtsDBuser/{password}@//oracleserver.example.com:1521/ORCL
      com.ibm.team.repository.db.jdbc.password=relmjtsDBpswd
    3. 编辑 com.ibm.team.repository.db.jdbc.locationcom.ibm.team.datawarehouse.db.jdbc.location 行中的下列值:
      • //oracleserver.example.com:1521:输入数据库服务器的标准主机名。
      • jtsDBuser:输入数据库用户。
      • jazzDBuser:输入数据仓库数据库用户。必须是 DBA。
      • ORCL:输入 Oracle 服务名称。连接至 Oracle 数据库时,请确保服务器上存在 ORCL 服务名称。
      切记: Oracle 位置 URL 可使用若干格式。此处的示例在大多数环境中有效。请参阅 Oracle JDBC 文档以获取更多详细信息。
      注: 请勿更改 com.ibm.team.repository.db.jdbc.locationcom.ibm.team.datawarehouse.db.jdbc.location 属性中的 password={password} 文本。
    4. com.ibm.team.repository.db.jdbc.passwordcom.ibm.team.datawarehouse.db.jdbc.password 属性中指定用户密码。
    5. com.ibm.team.fulltext.indexLocation=conf/relmjts/indices/workitemindex 行的值更改为全文本索引的完整路径位置。例如,输入 com.ibm.team.fulltext.indexLocation=c:/Progra~1/IBM/JazzTeamServer/server/conf/relmjts/indices/workitemindex
    6. com.ibm.team.jfs.index.root.directory=indices 行的值更改为 Jazz Foundation Service 索引根目录的完整路径位置。例如,输入 com.ibm.team.jfs.index.root.directory=c:/Progra~1/IBM/JazzTeamServer/server/conf/relmjts/indices
  2. 创建数据库之后,请运行存储库工具命令以创建数据库表。
    要点: 只有当这是新安装时,才运行 createTables 命令。
    注: 运行 -createWarehouse 命令的用户必须具有 DBA 许可权。.
    注: 当您运行 repotools 命令时,将更新 teamserver.properties 文件,并且具有原始内容的原始文件将保存在同一目录中。您可能还会看到一条警告指出尚未设置公用 URI。此时您可以忽略此警告,因为为 Rational Engineering Lifecycle Manager 应用程序运行 Jazz Team Server 设置向导时将设置公用 URI。
    1. 要为 Jazz Team Server 创建数据库表,请转至 JazzInstallDir/server 目录并运行下列命令:
      repotools-relmjts -createTables
    2. 要为 Rational Engineering Lifecycle Manager 应用程序创建数据库表,请转至 RELMInstallDir/server 目录并运行下列命令:
      repotools-relm -createTables
    3. 要为“配置管理”应用程序创建数据库表,请转至 VVCInstallDir/server 目录并运行下列命令:
      repotools-vvc -createTables

反馈