z/OS Connect Enterprise Editionの構成

z/OS® Connect Enterprise Edition は個別注文の製品であり、CICS® TS の一部として提供される製品ではありません。これは、z/OS Connect for CICS 1.0 の基本サービスを拡張して追加機能を提供し、CICS の古い JSON Web サービスベースのサービスをホストしたり、標準的な z/OS Connect デプロイメント成果物 (SAR ファイルや AAR ファイル) を使用したりすることができます。 JSON サービスをデプロイしたり PIPELINE リソースを構成したりするには、その前に JVMSERVER リソースを構成する必要があります。 この初期構成は 1 回のみ必要です。

始める前に

z/OS Connect Enterprise Edition ランタイムをインストールします。 z/OS Connect Enterprise Edition V3.0 の製品資料の説明に従ってください。z/OS Connect Enterprise Edition を CICS に組み込んで実行する準備をする場合、別個の Liberty サーバー・インスタンスを作成する必要はありません。 zFS でファイル・システム・コンポーネントを使用できることを確認する必要があります。 z/OS Connect Enterprise Edition で提供される API Toolkit のインストールは、このタスクの一部ではありません。

このタスクについて

以前に z/OS Connect for CICS 1.0 をインストールした場合は、適切な構成が既に存在している可能性があり、そうであれば以下のタスクでいくつかのステップを省略できます。 省略できるステップは、手順の中で示しています。

手順

  1. JVMSERVER リソースを作成し、WebSphere® Liberty サーバーをサポートするように構成します。WebSphere Liberty JVMSERVER の作成方法について詳しくは、Liberty JVM サーバーの構成を参照してください。

    以前に z/OS Connect for CICS 1.0 をインストールした場合は、このステップを省略できます。

  2. JVM サーバー・オプションに ZCEE_INSTALL_DIR を追加します。
    オプションと例について詳しくは、JVM サーバー・プロファイルのオプションを参照してください。
  3. 変更の始まりz/OS Connect Enterprise Edition バージョン 3.0.24.0 以降を使用している場合は、<installation_directory>/runtime/lib/native/zos ディレクトリーを JVM サーバー・オプション LIBPATH_SUFFIX に追加します。ここで、<installation_directory>z/OS Connect Enterprise Edition のインストール・ディレクトリーです。
    例えば、次のようになります。
    LIBPATH_SUFFIX=/usr/lpp/IBM/zosconnect/v3r0/runtime/lib/native/zos

    LIBPATH_SUFFIX の設定について詳しくは、JVM サーバー・プロファイルのオプションを参照してください。

    変更の終わり
  4. セキュリティー要件のために WebSphere Liberty を構成します。デフォルトでは、クライアント認証 SSL 証明書を使用する必要があります。この HTTP 基本認証を有効にするには、 server.xml ファイルに次の構成オプションを追加します。
        <!-- Allow fail-over to HTTP Basic Authentication --> 
        <webAppSecurity allowFailOverToBasicAuth="true"/>

    z/OS Connect のユーザーに zosConnectAccess セキュリティー・ロールを付与することも必要です。WebSphere Liberty セキュリティーについて詳しくは、Liberty JVM サーバーのセキュリティーの構成 (Configuring security for a Liberty JVM server)を参照してください。z/OS Connect セキュリティーについては、z/OS Connect のセキュリティーを参照してください。

    以前に z/OS Connect for CICS 1.0 をインストールした場合は、このステップを省略できます。

次のタスク

以下のタスクで説明されているように、z/OS Connect Enterprise Edition のご使用のバージョンに対応したステップを実行してください。