IBM Support

[Db2] 非 Java クライアントが Sysplex ワークロード・バランシングと自動クライアント・リルートを使用する方法

Question & Answer


Question

コマンド行プロセッサー (CLP) や CLI アプリケーション、ODBC アプリケーションなどの非 Java クライアントが、Db2 Connect サーバーを経由せずに Sysplex ワークロード・バランシングと自動クライアント・リルートを使用するためには、どのように構成すればよいでしょうか。

Answer

非 Java クライアントでは、db2dsdriver.cfg 構成ファイルを使用して Sysplex ワークロード・バランシングと自動クライアント・リルートを利用可能です。

以下に構成の例を示します。
 
  1. db2dsdriver.cfg を作成する。
    以下の 1-1. もしくは 1-2. のいずれかの手法で db2dsdriver.cfg を作成します。
    作成した db2dsdriver.cfg は、アプリケーション実行環境側 (クライアント側) に配置しますが、作成したファイルを設置するパスは Db2 のバージョンや導入製品により異なるため、以下の表を参照してください。
    また、DB2DSDRIVER_CFG_PATH 変数を用いることで、db2dsdriver.cfg 構成ファイルのパスと名前を変更することも可能です。
    V9.7
    プラットフォーム UNIX(AIX, HP-UX, Solaris)
    Linux    		 Windows XP Professional
    Windows Server 2003    		 Windows Vista 以降
    Windows Server 2008 以降
    ドライバー・タイプ
    IBM Data Server Client
    IBM Data Server Runtime Client
    IBM Data Server Driver Package    		 INSTHOME/sqllib/cfg C:¥Documents and Settings¥All Users¥Application Data¥IBM¥DB2¥driver_copy_name¥cfg C:¥ProgramData¥IBM¥DB2¥driver_copy_name¥cfg
    IBM Data Server Driver for ODBC and CLI INSTHOME/sqllib/cfg C:¥Documents and Settings¥All Users¥Application Data¥IBM¥DB2¥installation_path¥cfg C:¥ProgramData¥IBM¥DB2¥installation_path¥cfg
    V10.1
    プラットフォーム UNIX(AIX, HP-UX, Solaris)
    Linux    		 Windows XP Professional
    Windows Server 2003    		 Windows Vista 以降
    Windows Server 2008 以降
    ドライバー・タイプ
    IBM Data Server Client
    IBM Data Server Runtime Client
    IBM Data Server Driver Package    		 INSTHOME/sqllib/cfg C:¥Documents and Settings¥All Users¥Application Data¥IBM¥DB2¥driver_copy_name¥cfg C:¥ProgramData¥IBM¥DB2¥driver_copy_name¥cfg
    IBM Data Server Driver for ODBC and CLI INSTHOME/sqllib/cfg C:¥Documents and Settings¥All Users¥Application Data¥IBM¥DB2¥installation_path¥cfg C:¥ProgramData¥IBM¥DB2¥installation_path¥cfg
    V10.5 以降
    プラットフォーム UNIX(AIX, HP-UX, Solaris)
    Linux    		 Windows
    ドライバー・タイプ
    IBM Data Server Client
    IBM Data Server Runtime Client
    IBM Data Server Driver Package    		 INSTHOME/sqllib/cfg C:¥ProgramData¥IBM¥DB2¥driver_copy_name¥cfg
    IBM Data Server Driver for ODBC and CLI INSTHOME/sqllib/cfg C:¥ProgramData¥IBM¥DB2¥installation_path¥cfg
    ※ installation_path は、IBM Data Server Driver for ODBC and CLI 製品が解凍されたディレクトリーです。
    例えば、IBM Data Server Driver for ODBC and CLI 製品を Windows 7 オペレーティング・システムにインストールするときに、製品が C:¥IBMDB2¥CLIDRIVER¥ ディレクトリーにインストールされる場合、db2dsdriver.cfg.sample ファイルは C:¥ProgramData¥IBM¥DB2¥C_IBMDB2_CLIDRIVER¥cfg ディレクトリーに作成されます。

    1-1. db2dsdcfgfill コマンドを使用して作成する。
    db2dsdcfgfill コマンドを使用することで、既定のパスに既存のデータベース・ディレクトリー情報を含んだ db2dsdriver.cfg ファイルが作成されます。
    • 例： 
      $ db2dsdcfgfill -i インスタンス名
    1-2. db2dsdriver.cfg という名前のファイルをエディター等で作成、もしくは db2dsdriver.cfg.sample を変更し、既定のパスの下に配置する。
     
  2. db2dsdriver.cfg ファイルを編集し、enableWLB と enableAcr を true にする。
    • 例： 
      <configuration>
 <dsncollection>
  <dsn alias="db name alias" name="db name"
   host="hostname or IP address" port="port number">
   <parameter name="Authentication" value="Server"/>
  </dsn>
 </dsncollection>
 <databases>
  <database name="" host="hostname or IP address" port="port number">
  <!-- database-specific parameters -->
   <wlb>
    <!-- Enable Sysplex workload balancing to get automatic client reroute functionality -->
    <parameter name="enableWLB" value="true" />
   </wlb>
   <acr>
    <parameter name="enableAcr" value="true" />
    <parameter name="maxAcrRetries" value="5" />
    <parameter name="acrRetryInterval" value="0" />
   </acr>
  </database>
 </databases>
</configuration>
  3. db2cli validate コマンドを使用し、db2dsdriver.cfg の妥当性検査を実施する。
    db2cli validate コマンドを使用することで、該当の DSN に対して無効なパラメーターが設定されていないかなどの妥当性検査を実施することができます。
    • 例： 
      $ db2cli validate -dsn dsn_name
  4. 構成完了後、アプリケーションを再起動する。


関連情報
パスポート・アドバンテージによく寄せられる質問

非 Java クライアント用の Sysplex ワークロード・バランシングと自動クライアント・リルートの構成
非 Java クライアント・アプリケーションでの DB2 for z/OS Sysplex ワークロード・バランシングと自動クライアント・リルートの使用可能化の例

IBM データ・サーバー・ドライバー構成ファイル
IBM データ・サーバー・ドライバー構成ファイルの場所
db2dsdcfgfill - 構成ファイル db2dsdriver.cfg の作成
db2cli - Db2 対話機能 CLI コマンド

お問合せ先
技術的な内容に関して、パスポート・アドバンテージの契約のもと Db2 テクニカル・サポートへお問い合わせください。
Db2 テクニカル・サポート

[{"Type":"MASTER","Line of Business":{"code":"LOB10","label":"Data and AI"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSEPGG","label":"Db2 for Linux, UNIX and Windows"},"ARM Category":[{"code":"a8m500000008PkdAAE","label":"Connectivity"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
21 August 2023

UID

swg21978042

Page Feedback