IIBエージェントの構成

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

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

    • controller-proxy-hostcontroller-proxy-host：エージェントがコントローラに接続するために必要な任意のプロキシのホスト名または IP アドレス。

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

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

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

    • controller-proxy-passwordfilecontroller-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-correlationdisable-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>：このプロパティを設定して、<node-reuse>true</node-reuse>新しい VM に過去の VM のノード名を再利用します。異なる名前のノードが急激に増加するのを防ぎます。ノード名の再利用の有効化 を参照してください。
    • <node-reuse-prefix>prefixName</node-reuse-prefix>：node-reuse が true に設定されている場合、このプロパティを使用します。このプロパティを設定しない場合、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

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

    UserExits:

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