在 z/OS 上針對 DB2 自訂 Jazz Team Server 和 Rational Collaborative Lifecycle Management 內容檔解決方案

一節說明如何編輯及配置 teamserver.properties 檔,讓 z/OS® 伺服器能夠連接至 DB2®。Jazz™ Team Server (JTS) 及其他 Rational® 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 
請在直欄 1 中加入 # 來註銷下列 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 而換成列在 DDF 報告中 LOCATION 下的值。
    • jazzDBuser 而換成您所建立並對 DB2 資料庫具備適當存取權的使用者 ID。
      註: 請勿修改 password={password}。
  3. 在下列字行中:
    com.ibm.team.repository.db.jdbc.password=jazzDBpswd
    以您 DB2 z/OS 使用者的密碼取代 jazzDBpswd。
  4. 在下列字行中:
    com.ibm.team.repository.db.db2.dsn.dbname=JAZZDB
    以您為這個元件建立的資料庫名稱來取代 JAZZDB。
  5. 在下列字行中:
    #com.ibm.team.repository.db.schemaPrefix=xx
    您必須移除 #,並用相同 DB2 z/OS 子系統中每個資料庫的唯一字首來取代 xx。
    註: 如果要在相同 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 所建立的某個緩衝池相關聯。LOB 表格空間的預設緩衝池定義在 zparm TBSBPLOB 中。 如果您不想要 8K 分頁大小,您可以將這個值設為 16K 緩衝池。 如需相關資訊,請參閱 IBM® 紅皮書 LOBs with DB2 for z/OS: Stronger and Faster 中的 "Alternatives in defining LOBs",網址為 http://www.redbooks.ibm.com/redbooks/pdfs/sg247270.pdf。

意見