Runtime Manager へのサーバの追加

logo cloud disabled logo hybrid active logo server active logo rtf disabled

Runtime Manager コンソールに Mule サーバを追加するには、最初にサーバを Runtime Manager エージェントに登録する必要があります。​amc_setup​ スクリプトを使用して、Runtime Manager と通信するように Runtime Manager エージェントを設定します。

前提条件

  • Enterprise ライセンスが最新であること。

  • Mule 3.6.0 以降および API ゲートウェイ 2.1 以降が動作していること。

    Mule 3.6.x の場合は、Runtime Manager エージェントをインストールします。

    Mule 3.7.x 以降の Mule 3.x バージョンでは、必要に応じて Runtime Manager エージェントを最新バージョンに更新して、すべてのバグ修正と新機能を利用できます。

  • エージェントをダウンロードする場合は、Enterprise サポートアカウントが必要です。

  • 追加するサーバが Runtime Manager の別のインスタンスにすでに登録されている場合は、先にそのインスタンスへの登録を解除してください。

サーバを追加する

Runtime Manager にサーバを追加する手順は、次のとおりです。

  1. Anypoint Platform の ​[Runtime Manager]​ を選択します。

  2. 左側のメニューで ​[Servers (サーバ)]​ をクリックします。

  3. [Add Server (サーバを追加)]​ ボタンをクリックします。

  4. サーバの名前を入力します。

    サーバ名には最大 60 文字の英数字 (a-z, A-Z、0-9)、ピリオド (.)、ハイフン (-)、アンダースコア (_) を含めることができますが、スペースやその他の特殊文字は含めることができません。 Runtime Manager では、サーバ名で Unicode 文字がサポートされています。

    サーバ名は環境内で一意である必要がありますが、同じ組織が異なる環境に存在している場合は、同じサーバ名を使用できます。

    Runtime Manager により、​amc_setup​ コマンドが生成されます。 このコマンドには、指定したサーバ名 (​server-name​) と環境に Mule を登録するために必要な登録トークン (​token​) が含まれます。 登録トークンには、組織 ID と現在の環境が含まれます。

    [Add Server (サーバを追加)] ウィンドウの amc_setup コマンド
    Figure 1. 矢印は、​[Add Server (サーバを追加)]​ ウィンドウの ​amc_setup​ コマンドを示しています。
  5. [Copy command (コマンドをコピー)]​ をクリックして ​amc_setup​ コマンドをコピーします。

    このボタンは、指定したサーバ名が有効である場合にのみ表示されます。

  6. ターミナルウィンドウで、登録する Mule インスタンスの ​$MULE_HOME/bin​ ディレクトリに変更します。

  7. コマンドラインにコマンドを貼り付けます。

  8. amc_setup​ コマンドラインで他のパラメータを指定します。

    詳細は、​「amc_setup パラメータ」​を参照してください。

  9. すべてのアウトバウンドコールがプロキシを経由する必要がある環境の場合は、​$MULE_HOME/conf/mule-agent.yml​ ファイルまたは ​$MULE_HOME/conf/wrapper.conf​ ファイルでプロキシ設定を指定してください。

  10. IBM JVM を使用している場合は、​IBM JVM​ を参照してください。

amc_setup​ が正常に完了すると、次のメッセージが表示されます。

Mule Agent configured successfully
Connecting to Access Management to extract client_id and client_secret
Credentials extracted correctly, updating wrapper conf file

スクリプトが正常に完了した後、サーバ名が Runtime Manager の ​[Servers (サーバ)]​ タブに ​Created​ の状況で表示されます。

amc_setup​ スクリプトを実行したときにサーバが実行中であった場合は、サーバを再起動して Runtime Manager と再接続してください。

IBM JVM

IBM の Java 仮想マシン (JVM) を使用してサーバを作成する場合、Runtime Manager エージェントによってインストールされたデフォルトのトラストストアとは異なるトラストストアファイルを使用する必要があります。

  1. 次のナレッジ記事からカスタムトラストストアをダウンロードします。

  2. 使用している Mule バージョンに応じて、​$MULE_HOME/conf​ の ​truststore​ ファイルの名前を次のいずれかに変更してください。

    • anypoint-truststore.jks

      Mule 4.1.3 (エージェント 2.1.4) 以降

    • truststore.jks

      Mule 4.1.2 (エージェント 2.1.3)

  3. カスタムトラストストアを ​$MULE_HOME/conf​ フォルダにコピーします。

  4. Mule を再起動します。

別の Runtime Manager インスタンスからサーバを削除する

追加するサーバが Runtime Manager の別のインスタンスにすでに登録されている場合は、先のそのインスタンスからサーバを削除しないと別のインスタンスには登録できません。

Runtime Manager からサーバを削除する手順は、次のとおりです。

  1. Runtime Manager で、​[Server (サーバ)]​ タブからサーバを削除します。

  2. $MULE_HOME/conf​ ディレクトリで ​mule-agent.yaml​ および ​mule-agent.jks​ ファイルを削除します。