Jazz Team Server および Rational solution for Collaborative Lifecycle Management のプロパティー・ファイルを z/OS 上の DB2 用にカスタマイズ

このセクションでは、z/OS® 上のサーバーが DB2® に接続できるように 、teamserver.properties ファイルを編集および構成する方法を説明します。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
メモ:
  • 最大で 4 個のリポジトリー (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 プロパティーの両方について、第 1 列に # を追加して以下のプロパティーをコメント化します。
# 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 を、作成したユーザー ID (DB2 データベースに対する適切なアクセス権限を持っているユーザー ID) に置き換えます。
      注: 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 サブシステム内の各データベースの固有の接頭部に置き換える必要があります。
    注: 複数の Jazz データベースを同じ DB2 サブシステム内に作成するには、それぞれの Jazz 表に対して異なる表所有者を指定する必要があります。これを行うため 、Jazz Team Server は、Jazz DB2 オブジェクトが DB2 サブシステム内で固有になるように、com.ibm.team.repository.db.schemaPrefix ディレクティブを使用して、 これらのオブジェクトに接頭部を追加します。com.ibm.team.repository.db.schemaPrefix で設定された接頭部が、下線とともに所有者の接頭部に追加されます。例えば、com.ibm.team.repository.db.schemaPrefix=X1 の場合、任意のデータベースで、CREATOR が X1_REPOSITORY に変更されます。 CREATOR および TABLE の名前を使用して、固有の参照になるようにしてください。

DB2 z/OS 上のデータウェアハウスへの参照用に、teamserver.properties ファイルを更新します。

具体的には、以下の行を編集してください。
  1. Derby データウェアハウス構成に関連する以下のプロパティーをコメント化します (3 番目のプロパティーはリストされていない可能性があります)。
    # 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 です。
    注: セットアップ・ウィザードを使用すると、レポート・ユーザーに適切な権限が付与されます。権限を手動で付与する場合は、このユーザーがレポートを表示するためにデータベースに対して選択操作を実行できる必要があります。
    具体的には、リポジトリー・ツール –createWarehouse を実行する場合、あるいはセットアップ・ウィザードを使用してデータウェアハウスを初期化する場合、RPTUSER には、次のようなステートメントを使用して表から選択する権限が付与されます。
        GRANT SELECT ON RIDW.VW_RQST_HISTORY TO $REP_USER;
最後に、@workPath@ のすべてのインスタンスを、(未変更であれば) @workPath@ に対して選択したパスで置き換えます。@workPath@ の置換は、BLZCP* ジョブを実行した際に行われているはずです。 例えば、以下のプロパティーです。
  • 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 のバッファー・プールに設定できます。詳しくは、次の Web サイトにある IBM® Redbook「LOBs with DB2 for z/OS: Stronger and Faster」の『Alternatives in defining LOBs』を参照してください。 http://www.redbooks.ibm.com/redbooks/pdfs/sg247270.pdf

フィードバック