在z/OS 上为 DB2 定制 Jazz Team Server 和 Rational solution for Collaborative Lifecycle Management 属性文件

本节描述如何编辑和配置 teamserver.properties 文件,以便 z/OS® 上的服务器可以连接到 DB2®。Jazz™ Team Server (JTS) 和其他 Rational® solution for Collaborative Lifecycle Management (CLM) 应用程序均具有包含服务器属性的 teamserver.properties 文件。

关于此任务

找到每个应用程序的配置目录:
  • Jazz Team Server (JTS) - @confPath@/jts
  • “变更和配置管理”(CCM) - @confPath@/ccm
  • “质量管理”(QM) - @confPath@/qm
  • “需求管理”(RM) - 使用 Jazz Team Server teamserver.properties 中的数据库连接信息,因此您不必对 RM 应用程序重复此步骤。

在 z/OS 上,@confPath@ 是使用 BLZCP* 样本作业定制服务器时使用的路径值(例如,/etc/jazz40)。在除了 z/OS 之外的系统上,@confPath@ 是配置目录的安装路径,例如,在 Linux 上为 /opt/IBM/JazzTeamServer/server/conf。

缺省情况下,这些目录中的 teamserver.properties 文件已配置为使用 Derby 存储库和数据仓库进行报告。按照本主题中的指示信息,编辑每个 teamserver.properties 文件以使用 DB2 for z/OS。

对DB2 for z/OS 子系统使用 -DIS DDF 命令,以显示一些您需要提供的值。例如,您可以从以下显示内容中检索 location、ipaddr 和 port (tcpport):
-DSN9 DIS DDF                                                   
 DSNL080I  -DSN9 DSNLTDDF DISPLAY DDF REPORT FOLLOWS: 548        
 DSNL081I STATUS=STARTD                                          
 DSNL082I LOCATION           LUNAME            GENERICLU         
 DSNL083I NS32DB             NETA.NS32DB       -NONE             
 DSNL084I TCPPORT=3500  SECPORT=3510  RESPORT=3501  IPNAME=-NONE 
 DSNL085I IPADDR=9.42.81.74                                    
 DSNL086I SQL    DOMAIN=RALNS32.example.com              
 DSNL086I RESYNC DOMAIN=RALNS32.example.com              
 DSNL099I DSNLTDDF DISPLAY DDF REPORT COMPLETE                   
修改每个 teamserver.properties 文件,以匹配您在先前步骤中创建的数据库配置,同时匹配您的 DB2 z/OS 配置。按照您的配置编辑以下属性:
  • ipAddress,
  • ipPort
  • location
  • user
  • password
  • dbname
  • schemaprefix
注意:
  • 最多可有四个存储库:一个存储库用于 JTS,每个已安装的具有数据库的组件(CCM 和 QM)分别使用一个存储库,还有一个存储库用于数据仓库。
  • 这些存储库中的每一个都必须具有唯一的数据库名称和模式前缀(如果它们在单一 DB2 z/OS 子系统中)。
  • 每个属性文件都将指向同一个数据仓库配置。

要将服务器或应用程序配置为使用 DB2 for z/OS,请编辑 Jazz Team Server 或其他已安装的 CLM 应用程序的配置目录中的各个 teamserver.properties 文件。例如,@confPath@/jts/teamserver.properties 和 @confPath@/ccm/teamserver.properties 文件,然后找到下列各行。此示例面向 CCM:

# JDBC Repository DB location, specifying this property disables 
# system-based selection of default location
# NOTE THAT EVERY APPLICATION INSTANCE AND JAZZ TEAM SERVER 
# REQUIRES ITS OWN UNIQUE DATABASE
com.ibm.team.repository.db.vendor = DERBY 
com.ibm.team.repository.db.jdbc.location=conf/ccm/derby/repositoryDB

# JDBC Data Warehouse DB location, specifying this property disables 
# system-based selection of default location
com.ibm.team.datawarehouse.db.vendor=derby_net
com.ibm.team.datawarehouse.db.jdbc.location=//localhost:1527/conf/jts/derby/warehouseDB 
在第一列添加 #,以注释掉 com.ibm.team.repository 和 com.ibm.team.datawarehouse 属性的下列属性:
# JDBC Repository DB location, specifying this property disables 
# system-based selection of default location
# NOTE THAT EVERY APPLICATION INSTANCE AND JAZZ TEAM SERVER REQUIRES ITS OWN UNIQUE DATABASE
#com.ibm.team.repository.db.vendor = DERBY
#com.ibm.team.repository.db.jdbc.location=conf/ccm/derby/repositoryDB

# JDBC Data Warehouse DB location, specifying this property disables 
# system-based selection of default location
#com.ibm.team.datawarehouse.db.vendor=derby_net
#com.ibm.team.datawarehouse.db.jdbc.location=//localhost:1527/conf/jts/derby/warehouseDB
取消注释示例所示的行并进行编辑,以便与您在先前步骤中创建的数据库配置以及 DB2 配置匹配。

根据您的配置,编辑 location、user、password 和 dbname 属性。

具体而言,请在该存储库的各个 teamserver.properties 文件中编辑下列各行:
  1. 确保将下面这一行取消注释:
    com.ibm.team.repository.db.vendor = db2z
  2. 在以下行中:
    com.ibm.team.repository.db.jdbc.location=//ipAddress:ipPort/
    location:user=jazzDBuser;password={password};
    替换:
    • ipAddress,使用 ipaddr。
    • ipPort,使用您的 tcpport。
    • location,使用 LOCATION 下 DDF 报告中列出的值。
    • jazzDBuser,使用您创建的用户标识,该用户标识具有对 DB2 数据库的适当访问权。
      注: 请勿修改 password={password}。
  3. 在以下行中:
    com.ibm.team.repository.db.jdbc.password=jazzDBpswd
    将 jazzDBpswd 替换为 DB2 z/OS 用户的密码。
  4. 在以下行中:
    com.ibm.team.repository.db.db2.dsn.dbname=JAZZDB
    将 JAZZDB 替换为您为此组件创建的数据库的名称。
  5. 在以下行中:
    #com.ibm.team.repository.db.schemaPrefix=xx
    必须除去 # 并将 xx 替换为同一个 DB2 z/OS 子系统中的每个数据库的唯一前缀。
    注: 要在相同的 DB2 子系统中创建数个 Jazz 数据库,您必须区分 Jazz 表的表所有者。要实现此目的,Jazz Team Server 会使用 com.ibm.team.repository.db.schemaPrefix 伪指令将前缀添加到 Jazz DB2 对象,以便它们在 DB2 子系统中唯一。com.ibm.team.repository.db.schemaPrefix 中设置的前缀将随下划线一起添加到所有者前缀。例如,如果 com.ibm.team.repository.db.schemaPrefix=X1,那么在给定的数据库中,CREATOR 将修改为 X1_REPOSITORY。确保使用 CREATOR 和 TABLE 名称进行唯一的引用。

更新 teamserver.properties 文件,以便引用 DB2 z/OS 上的数据仓库。

具体而言,编辑下列各行:
  1. 注释掉与 Derby 数据仓库配置相关的下列属性(第三个属性可能未列出):
    # com.ibm.team.datawarehouse.db.vendor=DERBY
    # com.ibm.team.datawarehouse.db.jdbc.location=conf/jts/derby/warehouseDB
    # com.ibm.team.datawarehouse.db.net.port=1527
  2. 取消注释下列属性并进行与存储库类似的更新。
    #com.ibm.team.datawarehouse.db.vendor = db2z
    #com.ibm.team.datawarehouse.db.jdbc.location=//ipAddress:ipPort/location:user=jazzDBuser;password={password};
    #com.ibm.team.datawarehouse.db.jdbc.password=jazzDBpswd
    # The database user for whom proper permissions will be granted
    #com.ibm.team.datawarehouse.report.user = RPTUSER
    #com.ibm.team.datawarehouse.db.db2.dsn.dbname=RIDW
    #com.ibm.team.datawarehouse.db.schemaPrefix=DWPREF
    您必须添加以下属性,以对数据仓库表指定您选择的前缀:
    com.ibm.team.datawarehouse.db.schemaPrefix=DWPREF 
  3. 在 com.ibm.team.datawarehouse.report.user = RPTUSER 中,输入要对其授予正确许可权的报告用户。缺省值为 RPTUSER。
    注: 如果使用设置向导,那么会将正确的许可权授予报告用户。如果要手动授予许可权,那么此用户必须能够对数据库执行 SELECT 以查看报告。
    具体而言,您运行存储库工具 -createWarehouse 或者使用设置向导来初始化数据仓库时,将使用类似于以下的语句授权 RPTUSER 从表中选择数据:
        GRANT SELECT ON RIDW.VW_RQST_HISTORY TO $REP_USER;
最后,将 @workPath@ 的所有实例替换为您为 @workPath@ 选择的路径(如果尚未修改这些实例)。您应该在运行 BLZCP* 作业时完成 @workPath@ 替换。例如,以下属性:
  • com.ibm.team.fulltext.indexLocation=@workPath@/workitemindex
  • com.ibm.team.repository.tmpdir=@workPath@/contentservice
  • com.ibm.team.scm.tmpdir=@workPath@/contentservice
  • com.ibm.team.scm.vcs.tmpdir=@workPath@/versionedcontentservice

提示: Jazz 数据库在其表中包含 LOB(大对象)列。LOB 列与表创建期间 DB2 创建的缓冲池相关联。zparm TBSBPLOB 中定义了 LOB 表空间的缺省缓冲池。如果您不想要 8K 页面大小,那么可以将该值设置为 16K 缓冲池。有关其他信息,请参阅 IBM® 红皮书《DB2 for z/OS 的 LOB:更强大更快速》中的“定义 LOB 中的备用项”,网址为 http://www.redbooks.ibm.com/redbooks/pdfs/sg247270.pdf。

反馈