IIBエージェントの構成

このページでは、AIX、Linux、および Windows で IIB エージェントを統合する方法について説明します。IIB エージェントのインストール手順は、AIX、Linux、および Windows で同じです。IIB、ACE 11、ACE 12、ACE 13 のインストール手順も提供されます。

  1. エージェントとコントローラ間の通信設定を指定します。
    controller-info.xml ファイルで、次のプロパティを設定します。
    • account-name:コントローラログインのアカウント名。
    • account-access-key:アクセスキー。このキーは、コントローラを使用した検証に使用されます。
    • application-name:IIB サーバーが属するアプリケーションの名前。
    • controller-host:コントローラのホスト名。
    • controller-port:コントローラのポート番号。SaaS コントローラのポートは 443 です。
    • controller-proxy-host:エージェントがコントローラに接続するために必要な任意のプロキシのホスト名または IP アドレス。

    • controller-proxy-port:エージェントがコントローラに接続するために必要な任意のプロキシのポート番号。

    • controller-proxy-username:プロキシでの認証に使用されるユーザー名。

    • controller-proxy-password:プロキシユーザーを認証するためのパスワード。

    • controller-proxy-passwordfile:プロキシユーザーの認証に使用されるパスワードを含むファイルのフルパス名。

    • controller-ssl-enabled:SSL ログイン。有効にするには 1、無効にするには 0 を設定します。コントローラ SSL を無効にする場合は、restrict-tls プロパティを false に設定する必要があります。
    • restrict-tls:すべてのコントローラ接続に最適な TLS バージョンを使用するには、true を設定します。デフォルトでは、true に設定されています。
    • controller-cert-file:SSL の PEM フォーマットの X509 証明書へのフルパス。証明書ファイルの取得方法の詳細については、「C/C++ SDK の SSL の有効化」を参照してください。
    • log-dir:IIB エージェントログファイルを含むディレクトリへのパス。デフォルトパスは /tmp/appd です。この設定の前に書き込まれたログは、このパスに記録されます。
    • log-level:ログのレベル。このプロパティを trace|debug|info|warning|error に設定します。Error は優先順位が最も高くなり、trace の優先順位が最も低くなります。
    • tier-name:ブローカーを表す階層の名前。
    • user-exit:ユーザーの終了名。これは、mqsichangebroker コマンドの規定に従い英数字のフォーマットにする必要があります。
    • <log-settings> </log-settings>:エージェントのログ設定。詳細は、エージェントのログファイルサイズの設定 を参照してください。
    • disable-correlation:特定のバックエンドの相関を有効または無効にします。有効にするには 1、無効にするには 0 を設定します。disable-http-correlation:有効にするには 1、無効にするには 0 を設定します。disable-jms-correlation:有効にするには 1、無効にするには 0 を設定します。disable-mq-correlation:有効にするには 1、無効にするには 0 を設定します。
    • flow-level-visibility-enabled:フローレベルの可視性オプション。有効にするには 1、無効にするには 0 を設定します。デフォルト値は 0 です。IIB エージェントフローレベルの可視性 を参照してください。
    • <node-reuse>true</node-reuse>:このプロパティを設定して、新しい VM に過去の VM のノード名を再利用します。異なる名前のノードが急激に増加するのを防ぎます。ノード名の再利用の有効化 を参照してください。
    • <node-reuse-prefix>prefixName</node-reuse-prefix>node-reusetrue に設定されている場合に、このプロパティを使用します。このプロパティを設定しない場合、IIB エージェントは、IBM の内部ノード名標準に従ってノード名を生成します。ノード名の再利用の有効化 を参照してください。
  2. ブローカーを停止するには、次のコマンドを実行します。
    mqsistop <broker_name>
    ユーザイグジットを構成するには、ブローカーを停止する必要があります。
  3. IIB エージェントのユーザイグジットをインストールします。
    すべてのフローについて、IIB エージェントのユーザイグジットがデフォルトで有効になっていることを確認します。該当するバージョンに基づいて、次の手順を実行します。
    オプション説明
    IIB 10次のコマンドを実行します。mqsichangebroker <broker_name> -x <install-directory> -e <user_exit_name>
    ACE 11、 ACE 12、 ACE 13

    node.conf.yaml ファイルで次の手順を実行します。ファイルは次のパスにあります。<path-to-installation-directory>/<broker-name>/node.conf.yaml

    UserExits:

    • activeUserExitList:'<User Exit Name>' #ユーザーの終了名を指定します。
    • userExitPath'<path>' #パスを指定します。
    注: エージェントがブローカーにインストールされている場合は、ブローカーとともに起動および停止されます。
  4. 次のコマンドを実行して、ブローカーを開始します。
    mqsistart <broker_name>
メッセージフローのサブセットを監視できます。次のコマンドを実行して、重要度が低くなっているフローをモニター対象から除外できます。
mqsichangeflowuserexits <broker_name> -e <integrationServerName> -f <MessageFlow> -k <application_name> -i <user_exit_name>