---
schema_version: "1"
id: 886e4d20b7146c0c2d27fe7d637ccf450bd19f8f8ea1d58e614b2e40a363c998
title: Runtime Manager エージェントのインストールまたは更新
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/runtime-manager/installing-and-configuring-runtime-manager-agent.md
canonical_url: https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 9820140b8541ac998f126e3c66a7e53c9d5379817c2451afa26dd31db6fbf4b0
description: MuleSoft Documentation Site
latest: true
---
# Runtime Manager エージェントのインストールまたは更新

 [![logo server active](/mulesoft/current/ja-jp/_/img/icons/server-cloud.svg "Anypoint Platform PCE")Private Cloud Edition](deployment-strategies#anypoint-platform-private-cloud-edition)

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>可能な場合は、Equality の会社の値に一致するように、含めない用語を変更しました。顧客の実装に対する影響を回避するために、一部の用語は変更されていません。</p>
</div>
</td>
</tr>
</tbody></table>

Runtime Manager エージェントは Mule Runtime Engine (Mule) を Runtime Manager に登録します。Mule を登録した後は、登録された特定の環境と Anypoint Platform ビジネスグループ内で Runtime Manager によって管理できます。単一の Mule を複数の Runtime Manager ビジネスグループまたは環境には登録できません。

エージェントを接続するコンソールの種別に応じたパラメーターを使用して、​`amc_setup`​ コマンドでエージェントをインストールして設定します。

- [Anypoint Platform Runtime Manager のクラウドベースコンソール](https://docs.mulesoft.com/jp/runtime-manager/%3C#Register Mule with the Cloud-Based Runtime Manager>)
- [Anypoint Platform Private Cloud Edition Runtime Manager コンソール](https://docs.mulesoft.com/jp/runtime-manager/%3C#Register Mule with Anypoint Platform PCE Runtime Manager>)

`amc_setup`​ を実行すると、エージェントは指定された設定オプションで ​`$MULE_HOME/conf/mule-agent.yml`​ を作成します。

最初のインストール後は、以下を行うことができます。

- `amc_setup`​ を再実行してエージェントの設定を変更する、またはエージェントのバージョンを更新する。
- `mule-agent.yml`​ を修正してエージェントの設定を変更する。
    
    JMX 監視の外部サービスへの拡張など、一部の設定オプションは ​`amc_setup`​ では使用できません。これらは手動で ​`mule-agent.yml`​ ファイルに追加する必要があります。​[mule-agent.yml でのエージェント設定の更新](https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-config-yaml)​を参照してください。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content"><code>$MULE_HOME</code>​ は、Mule をインストールした場所を指定する環境変数です。 次の手順では、Mac または Linux 用のパスを使用しています。Windows を使用している場合は、​<code>$MULE_HOME</code>​ パスを ​<code>%MULE_HOME%</code>​ に置き換えてください。</td></tr></tbody></table>

## [](#要件と制限事項)要件と制限事項

- 単一の Mule Runtime Engine を複数の Runtime Manager ビジネスグループまたは環境には登録しないでください。
- Mule を Runtime Manager に複数回登録しないでください。
- 古い Mule Management Console (MMC) と Runtime Manager の両方に Mule Runtime Engine を登録しないでください。
    
    Mule が MMC で管理されている場合は、​`amc_setup`​ を実行する前に MMC から登録を解除してください。
    
    MuleSoft サポートは、MMC から Runtime Manager への移行に役立つ移行スクリプトを提供しています。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">個別の JVM で Runtime Manager エージェントを実行することはできません。</td></tr></tbody></table>

## [](#互換性)互換性

使用している Mule Runtime Manager のバージョンをサポートしている Runtime Manager エージェントのバージョンが必要です。互換性については、​[Runtime Manager エージェントのリリースノート](https://docs.mulesoft.com/jp/release-notes/runtime-manager-agent/runtime-manager-agent-release-notes)​で確認してください。

Mule 3.7.x 以前と API ゲートウェイバージョン 2.x 以前には、外部の分析ツールへのデータのエクスポートをサポートしない旧バージョンの Runtime Manager エージェントが含まれています。これらのバージョンを使用している場合は、エージェントの最新バージョンをダウンロードして更新してください。

### [](#runtime-manager-エージェントの互換性)Runtime Manager エージェントの互換性

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 60%;">
<col style="width: 20%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Mule バージョン</th>
<th class="tableblock halign-left valign-top">Runtime Manager エージェントのバージョン</th>
<th class="tableblock halign-left valign-top">Java バージョン</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">4.3.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2.4.3 以降</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">4.4.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2.4.27 以降</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">4.4.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2.4.28 以降</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8,11</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">4.5.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2.5.6 以降</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8,11</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">4.6.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2.6.0 以降</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8,11,17</p></td>
</tr>
</tbody>
</table>

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">互換性の表に記載されているバージョンより前の Runtime Manager エージェントバージョンでは、互換性がなかったり、不整合が生じたりする可能性があります。</td></tr></tbody></table>

Java の互換性についての詳細は、[Java サポート](https://docs.mulesoft.com/jp/general/java-support)を参照してください。

## [](#前提条件)前提条件

- Enterprise ライセンスが最新であること。
- Mule 3.6.0 以降および API ゲートウェイ 2.1 以降が動作していること。
- エージェントをダウンロードする場合は、Enterprise サポートアカウントが必要です。

## [](#mule-インストールからのエージェントのインストール)Mule インストールからのエージェントのインストール

エージェントは、Mule Runtime Engine のインストールにバンドルされています。

ツールをインストールするには、次の手順を実行します。

1. [Mule をダウンロードしてインストールします](https://docs.mulesoft.com/on-premises/latest/runtime-installation-task)​。
2. 環境に応じたパラメーターを指定して ​`$MULE_HOME/bin/amc_setup`​ を実行します。
    
    [\[amc\_setup Parameters\]](<#amc_setup Parameters>)​を参照してください。

## [](#zip-ファイルからエージェントをインストールします).zip ファイルからエージェントをインストールします。

使用しているソフトウェア配布に含まれているバージョン以外のエージェントが必要な場合は、サポートポータルからダウンロードしてください。

### [](#サポートポータルからのエージェントのダウンロード)サポートポータルからのエージェントのダウンロード

Mule Runtime Engine と Runtime Manager との互換性については、対応する ​[Runtime Manager エージェントのリリースノート](https://docs.mulesoft.com/jp/release-notes/runtime-manager-agent/runtime-manager-agent-release-notes)​で確認してください。

エージェントをダウンロードするには、次の手順を実行します。

1. [MuleSoft ヘルプセンター](https://help.mulesoft.com/s/)​を開きます。
2. **\[Support (サポート)\]**​ タイルをクリックします。
3. 右上にある ​**\[Login (ログイン)\]**​ をクリックし、自分の Anypoint Platform 認証情報を使用してログインします。
    
    <table><tbody><tr><td class="icon"><i class="fa icon-important" title="Important"></i></td><td class="content">エージェントのダウンロードには Enterprise サポートアカウントが必要です。</td></tr></tbody></table>
4. MuleSoft サポートページで ​**\[Downloads (ダウンロード)\]**​ タブをクリックします。
5. **\[Mule Agent (Mule エージェント)\]**​ をクリックします。
6. エージェントを探して選択し、\[Action (アクション)\] 列で ​**\[Download (ダウンロード)\]**​ をクリックします。

### [](#エージェントのインストール)エージェントのインストール

ダウンロードした .zip ファイルからエージェントをインストールするには、次の手順を実行します。

1. Mule または API ゲートウェイランタイムを停止します。
2. ダウンロードした ​`agent-setup-​_VERSION_​.zip`​ ファイルを ​`$MULE_HOME/bin`​ に展開します。
    
    確認メッセージが表示されたら、競合するファイルをすべて上書きします。
3. 環境に応じたパラメーターを指定して ​`$MULE_HOME/bin/amc_setup`​ を実行します。
    
    [\[amc\_setup Parameters\]](<#amc_setup Parameters>)​を参照してください。
4. Mule または API ゲートウェイランタイムを再起動します。

## [](#エージェントを更新する)エージェントを更新する

以前のバージョンの ​`amc_setup`​ でエージェントをインストールしてある場合は、エージェントを更新して、現在のエージェント設定を ​`$MULE_HOME/conf/mule-agent.yml`​ に保持できます。

`mule-agent.yml`​ ファイルを保持する場合は、以下の変更が適用されます。

- バージョン 1.12.0 以降にアップグレードする場合:
    
    [「アップグレードの要件」](https://docs.mulesoft.com/jp/release-notes/runtime-manager-agent/runtime-manager-agent-1.12.x-release-notes#1-12-0)​を参照してください。
- バージョン 2.2.0 以降にアップグレードする場合:
    
    [「アップグレードの要件」](https://docs.mulesoft.com/jp/release-notes/runtime-manager-agent/runtime-manager-agent-2.2.x-release-notes#2-2-0)​を参照してください。

既存の Runtime Manager エージェントを更新する手順は、次のとおりです。

1. Mule または API ゲートウェイランタイムを停止します。
2. ダウンロードした ​`agent-setup-​_VERSION_​.zip`​ ファイルを ​`$MULE_HOME/bin`​ に展開します。
3. 確認メッセージが表示されたら、競合するファイルをすべて上書きします。
4. `$MULE_HOME/bin/amc_setup -U`​ を実行します。
    
    `-U`​ パラメーターを使用して ​`amc_setup`​ を実行する場合は、コマンドラインで他のパラメーターを指定することはできません。
5. Mule または API ゲートウェイランタイムを再起動します。

Runtime Manager エージェントをアップグレードする場合は、Anypoint Monitoring エージェントのアンインストールスクリプトを実行してから、Anypoint Monitoring エージェントを再インストールする必要もあります。 [「Anypoint Monitoring エージェントの更新」](https://docs.mulesoft.com/jp/monitoring/am-installing#update-the-anypoint-monitoring-agent)​を参照してください。

### [](#エージェントを更新するときの処理)エージェントを更新するときの処理

エージェントを更新すると、​`amc_setup`​ スクリプトは以下の処理を行います。

- エージェントの現在のバージョンをバックアップします。
    
    - `$MULE_HOME/server-plugins/mule-agent-plugin`​ を ​`$MULE_HOME/tools/mule-agent-backup.zip`​ にアーカイブします。
    - カスタムモジュール (通常は ​`$MULE_HOME/server-plugins/mule-agent-plugin/lib/modules`​ にあります) を ​`$MULE_HOME/tools/mule-agent-modules-backup.zip`​ にアーカイブします。
- `$MULE_HOME/server-plugins/mule-agent-plugin/lib`​ 内のエージェントライブラリを更新します。
- 現在の ​`$MULE_HOME/conf/mule-agent.yml`​ 設定ファイルを保持します。
- `$MULE_HOME/server-plugins/mule-agent-plugin/lib/modules`​ のモジュールは変更しません。
    
    このディレクトリには、エージェントに追加された (エージェントの配布には含まれていない) カスタムモジュールが入っています。
- デフォルトのエージェントトラストストア名を ​`truststore.jks`​ から ​`anypoint-truststore.jks`​ に変更します (バージョン 1.11.0 または 2.1.4 以降への更新)。

## [](#エージェントをロールバックする)エージェントをロールバックする

エージェントの更新時に問題が発生するなどしてエージェントをロールバックする必要がある場合は、​`mule-agent-backup.zip`​ ファイルから以前のバージョンに復元します。 この ZIP ファイルには、エージェントのライブラリ、設定ファイル、コンパイルされたクラスが含まれます。

エージェントをロールバックする手順は、次のとおりです。

1. Mule または API ゲートウェイランタイムを停止します。
2. `mule-agent-plugin`​ ディレクトリに移動します。
    
    `cd $MULE_HOME/server-plugins/mule-agent-plugin`
3. `mule-agent-plugin`​ ディレクトリにいることを確認します。
    
    `pwd`
4. 既存のエージェントファイルを削除します。
    
    `rm -r *`
5. バックアップ ZIP ファイルを ​`mule-agent-plugin`​ フォルダーにコピーします。
    
    `cp $MULE_HOME/tools/mule-agent-backup.zip .`
6. バックアップ ZIP ファイルから以前のバージョンのエージェントを復元します。
    
    `unzip mule-agent-backup.zip`
7. バックアップ ZIP ファイルを削除します。
    
    `rm mule-agent-backup.zip`
8. Mule または API ゲートウェイランタイムを再起動します。

## [](#エージェントを無効化する)エージェントを無効化する

エージェントを無効化するには、次の手順を実行します。

1. Mule または API ゲートウェイランタイムを停止します。
2. 次のファイルを削除します。
    
    ```console
    $MULE_HOME/conf/mule-agent.jks
    $MULE_HOME/conf/mule-agent.yml
    ```
3. Mule または API ゲートウェイランタイムを再起動します。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">エージェントは無効化されても起動しますが、いかなる操作も実行しません。</td></tr></tbody></table>

## [](#amc_setup-パラメーター)amc\_setup パラメーター

`amc_setup`​ のパラメーターを指定することにより、以下を行うことができます。

- Runtime Manager コンソールへの Mule の登録。
    
    - [\[Register Mule with the Cloud-Based Runtime Manager\]](<#Register Mule with the Cloud-Based Runtime Manager>)​。
    - [\[Register Mule with Anypoint Platform PCE Runtime Manager\]](<#Register Mule with Anypoint Platform PCE Runtime Manager>)​。
        
        Anypoint Platform PCE を使用して Mule を登録するには、追加の ​`amc_setup`​ パラメーターが必要です。​[\[PCE Runtime Manager amc\_setup Parameters\]](<#PCE Runtime Manager amc_setup Parameters>)​を参照してください。
- [プロキシサーバー経由で接続するためのエージェントの設定](https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-proxy-config#configure-the-agent-to-connect-through-a-proxy-server)​。
- [`mule-agent.yml`​ ファイルでのパスワードの暗号化](#encrypt_password)​。
- [ローカル Runtime Manager エージェントの REST API インターフェースを使用した Mule の管理](https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-REST-connections)​。
- [\[Update the Agent\]](<#Update the Agent>)​。

使用できるオプションを見るには、​`./amc_setup --help`​ を実行します。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 30%;">
<col style="width: 30%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">パラメーター</th>
<th class="tableblock halign-left valign-top">値</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>--help</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>コマンドのヘルプをコマンドラインに表示します。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-U</code>​</p>
</div>
<div class="paragraph">
<p><code>--update</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>既存の ​<code>mule-agent.yml</code>​ 設定ファイルを保持したままエージェントを更新します。</p>
</div>
<div class="admonitionblock important">
<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-important" title="Important"></i>
</td>
<td class="content">
<code>-U</code>​ を使用して以前のバージョンのエージェントを更新する場合は、コマンドラインで他のパラメーターを指定することはできません。
</td>
</tr>
</tbody></table>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-E</code>​</p>
</div>
<div class="paragraph">
<p><code>--encrypt</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>既存の ​<code>mule-agent.yml</code>​ ファイルでパスワードを暗号化します。</p>
</div>
<div class="paragraph">
<p>このオプションのみを使用してパスワードを暗号化します。
詳細は、​<a href="#Encrypt Passwords in an Existing mule-agent.yml File">[Encrypt Passwords in an Existing mule-agent.yml File]</a>​を参照してください。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>--decrypt</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>たとえばメインパスワードを変更する前に、既存の ​<code>mule-agent.yml</code>​ ファイルでパスワードを復号化します。</p>
</div>
<div class="paragraph">
<p>このオプションのみを使用してパスワードを復号化します。
詳細は、​<a href="#Update the Main Password">[Update the Main Password]</a>​および​<a href="#Display Passwords in mule-agent.yml in Plain Text">[Display Passwords in mule-agent.yml in Plain Text]</a>​を参照してください。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>--mule-home</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code><em>mule-home-directory</em></code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>$MULE_HOME</code>​ ディレクトリの場所を指定します。</p>
</div>
<div class="paragraph">
<p>インストールスクリプトを ​<code>$MULE_HOME/bin</code>​ 以外の場所から実行した場合は、このオプションを使用します。</p>
</div>
<div class="paragraph">
<p><em>amc_setup</em> スクリプトは、​<code>--mule-home</code>​ で指定されたディレクトリに対して相対的な ​<code>../conf</code>​ から ​<code>mule-agent.yml</code>​ ファイルを読み込みます。たとえば、​<code>--mule-home</code>​ の値が ​<code>/tmp/Mule/bin</code>​ であれば <em>amc_setup</em> は ​<code>mule-agent.yml</code>​ を ​<code>/tmp/Mule/conf</code>​ から読み込みます。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>--skip-gateway-clientid</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>API ゲートウェイの ​<code>client_id</code>​ と ​<code>client_secret</code>​ の設定をスキップします。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-I</code>​</p>
</div>
<div class="paragraph">
<p><code>--insecure</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>暗号化されていない REST 接続を使用するようにエージェントを設定します。</p>
</div>
<div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-REST-connections#insecure-connection-channel" class="xref page">非セキュア接続チャネル</a>​を参照してください。</p>
</div>
<div class="paragraph">
<p>このパラメーターは、​<a href="#PCE Runtime Manager amc_setup Parameters">PCE ​<code>amc_setup</code>​ パラメーター</a>​と一緒に使用しないでください。</p>
</div>
<div class="paragraph">
<p>このオプションは、​<code>$MULE_HOME/conf/mule-agent.yml</code>​ のコンテンツを置き換えます。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-S</code>​</p>
</div>
<div class="paragraph">
<p><code>--secure</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>オンプレミス管理コンソールと TLS 接続を確立するようにエージェントを設定します。</p>
</div>
<div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-REST-connections#secure-connection-channel" class="xref page">セキュア接続チャネル</a>​を参照してください</p>
</div>
<div class="paragraph">
<p>このパラメーターは、​<a href="#PCE Runtime Manager amc_setup Parameters">PCE ​<code>amc_setup</code>​ パラメーター</a>​と一緒に使用しないでください。</p>
</div>
<div class="paragraph">
<p>このオプションは、​<code>$MULE_HOME/conf/mule-agent.yml</code>​ のコンテンツを置き換えます。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-H</code>​</p>
</div>
<div class="paragraph">
<p><code>--hybrid</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code><em>token</em></code>​</p>
</div>
<div class="paragraph">
<p><code><em>server-name</em></code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Anypoint Platform PCE または MuleSoft が管理するクラウドベースの Anypoint Platform のどちらかと接続するようにエージェントを設定します。</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code><em>token</em></code>​ は、base64 でエンコードされた文字列で、Mule を Runtime Manager に登録するビジネスグループと環境を正確に指定します。</p>
</li>
<li>
<p><code><em>server-name</em></code>​ はインスタンス名で、Runtime Manager コンソールでこの Mule を識別します。</p>
<div class="paragraph">
<p>この名前は、ビジネスグループの環境内で一意である必要があります。</p>
</div>
</li>
</ul>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-P</code>​</p>
</div>
<div class="paragraph">
<p><code>--proxy</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code><em>proxy-host</em></code>​</p>
</div>
<div class="paragraph">
<p><code><em>proxy-port</em></code>​</p>
</div>
<div class="paragraph">
<p><code><em>proxy-user</em></code>​</p>
</div>
<div class="paragraph">
<p><code><em>proxy-password</em></code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続に登録するときに使用するプロキシ設定を指定します。</p>
</div>
<div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-proxy-config" class="xref page">「プロキシサーバー経由のエージェントへの接続」</a>​を参照してください。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-R</code>​</p>
</div>
<div class="paragraph">
<p><code>--region</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code><em>region</em></code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>デプロイ先のリージョンを指定します。使用できるリージョンは ​<code>prod</code>​、​<code>eu1</code>​、​<code>us_gov</code>​ です。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>--fips</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>*nix ベースのサーバーで Mule 4 ランタイムの FIPS 140-2 コンプライアンスを有効にします。</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#クラウドベースの-runtime-manager-を使用した-mule-の登録)クラウドベースの Runtime Manager を使用した Mule の登録

[![logo cloud disabled](/mulesoft/current/ja-jp/runtime-manager/_images/logo-cloud-disabled.png "CloudHub")](deployment-strategies#cloudhub-deployments) [![logo hybrid active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-hybrid-active.png "ハイブリッド")](deployment-strategies#hybrid-deployments) [![logo server disabled](/mulesoft/current/ja-jp/runtime-manager/_images/logo-server-disabled.png "Anypoint Platform PCE")](deployment-strategies#anypoint-platform-pce-deployments) [![logo rtf disabled](/mulesoft/current/ja-jp/runtime-manager/_images/logo-rtf-disabled.png "Runtime Fabric")](deployment-strategies#anypoint-runtime-fabric-deployments)

Anypoint Platform Runtime Manager のクラウドベースコンソールを使用して Mule を登録するには、以下が必要です。

- Anypoint Platform の特定のビジネスグループ用の特定の環境を識別する有効な登録トークン
- Runtime Manager コンソールで Mule を識別するインスタンス名

Mule を登録するには、次の手順を実行します。

1. Runtime Manager の左側のメニューで ​**\[Servers (サーバー)\]**​ をクリックします。
2. **\[Add Server (サーバーを追加)\]**​ ボタンをクリックします。
3. サーバーの一意な名前を入力します。
    
    サーバー名には最大 60 文字の英数字 (a-z, A-Z、0-9)、ピリオド (.)、ハイフン (-)、アンダースコア (\_) を含めることができますが、スペースやその他の特殊文字は含めることができません。 Runtime Manager では、サーバー名で Unicode 文字がサポートされています。
    
    サーバー名は環境内で一意である必要がありますが、同じ組織が異なる環境に存在している場合は、同じサーバー名を使用できます。
    
    Runtime Manager により、​`amc_setup`​ コマンドが生成されます。 このコマンドには、指定したサーバー名 (​`_server-name_`​) と環境に Mule を登録するために必要な登録トークン (​`_token_`​) が含まれます。 登録トークンには、組織 ID と現在の環境が含まれます。
    
    ![「Add Server (サーバーを追加)」 ウィンドウの amc\_setup コマンド](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-add-server.png)
    
    Figure 1. 矢印は、​**\[Add Server (サーバーを追加)\]**​ ウィンドウの ​`amc_setup`​ コマンドを示しています。
4. **\[Copy command (コマンドをコピー)\]**​ をクリックしてコマンドをコピーします。
5. ターミナルウィンドウで次の操作を実行します。
    
    1. 登録する Mule インスタンスの ​`$MULE_HOME/bin`​ ディレクトリに変更します。
    2. `mule-agent.yml`​ ファイルでパスワードを暗号化する場合、​`AGENT_VAR_master_password`​ 環境変数をメインパスワードに設定します。
        
        `export AGENT_VAR_master_password=myPassword`
    3. コマンドラインにコマンドを貼り付けます。
    4. `amc_setup`​ コマンドラインで他のパラメーターを指定します。
        
        [\[amc\_setup Parameters\]](<#amc_setup Parameters>)​を参照してください。
        
        `amc_setup`​ コマンドの例を次に示します。
        
        ```console
        ./amc_setup -H myToken myMuleServer --proxy myProxy-host myProxy-port myProxy-user myProxy-password
        ```

`amc_setup`​ コマンドは ​`$MULE_HOME/conf/mule-agent.yml`​ ファイルを生成します。

### [](#mule-agent-yml-ファイルの例)mule-agent.yml ファイルの例

暗号化されたパスワードを含めて、​`-H`​ オプションによって生成された ​`mule-agent.yml`​ ファイルの例を次に示します。

```yaml
transports:
  rest.agent.transport:
    enabled: false
  websocket.transport:
    consoleUri: wss://runtime-manager.anypoint.mulesoft.com:443/mule
    handshake:
      enabled: true
      body:
globalConfiguration:
  security:
    keyStorePassword: "![PBEWITHSHA1ANDDESEDE,WdPmAQMIC8Atr5iK4phjmbZbs9XFLLiH1eDhA7AmnpKUaPDhp40OB4uKZ6JUMW44]"
    keyStoreAlias: agent
    keyStoreAliasPassword: "![PBEWITHSHA1ANDDESEDE,WdPmAQMIC8Atr5iK4phjmbZbs9XFLLiH1eDhA7AmnpKUaPDhp40OB4uKZ6JUMW44]"
  authenticationProxy:
    endpoint: https://data-authenticator.anypoint.mulesoft.com:443
  proxyConfiguration:
    password: '![PBEWITHSHA1ANDDESEDE,VIs82yFDp66lnsL/Rss8q8js/zPDQ8+HJpdNepdZtA9obeDj5u+z4HIocsbLvXow]'
```

## [](#anypoint-platform-pce-runtime-manager-を使用した-mule-の登録)Anypoint Platform PCE Runtime Manager を使用した Mule の登録

[![logo cloud disabled](/mulesoft/current/ja-jp/runtime-manager/_images/logo-cloud-disabled.png "CloudHub")](deployment-strategies#cloudhub-deployments) [![logo hybrid disabled](/mulesoft/current/ja-jp/runtime-manager/_images/logo-hybrid-disabled.png "ハイブリッド")](deployment-strategies#hybrid-deployments) [![logo server active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-server-active.png "Anypoint Platform PCE")](deployment-strategies#anypoint-platform-pce-deployments) [![logo rtf disabled](/mulesoft/current/ja-jp/runtime-manager/_images/logo-rtf-disabled.png "Runtime Fabric")](deployment-strategies#anypoint-runtime-fabric-deployments)

Anypoint Platform Private Cloud Edition (Anypoint Platform PCE) を使用すると、すべての Runtime Manager サービスは、MuleSoft が管理するクラウド環境ではなくオンプレミスで実行されます。

PCE Runtime Manager で Mule を登録するには、次の手順を実行します。

1. Anypoint Platform PCE アカウントにログインします。
2. プラットフォームの DNS エントリが正しくセットアップされていることを確認します。
    
    [DNS or IP (DNS または IP)](https://docs.mulesoft.com/jp/access-management/private-cloud-edition-features#dns-or-ip)​ を参照してください。
3. Mule を登録するビジネスグループと環境を選択します。
4. 選択した環境の左側のメニューで ​**\[Servers (サーバー)\]**​ をクリックします。
5. **\[Add Server (サーバーを追加)\]**​ ボタンをクリックします。
    
    Runtime Manager は、Mule を環境に登録するために使用する ​`_token_`​ および ​`_server-name_`​ と共に ​`amc_setup`​ コマンドを生成します。
    
    登録トークンには、組織の ID と現在の環境が含まれます。
6. **\[Copy (コピー)\]**​ をクリックしてこのコマンドをコピーします。
7. ターミナルウィンドウで、登録する Mule インスタンスの ​`$MULE_HOME/bin`​ ディレクトリに変更します。
8. コマンドラインにコマンドを貼り付けます。
9. インスタンス名 ​`server-name`​ を、Runtime Manager コンソールで Mule の表示ラベルとして使用する一意のインスタンス名に変更します。
10. `amc_setup`​ コマンドラインで他のパラメーターを指定します。
    
    [\[amc\_setup Parameters\]](<#amc_setup Parameters>)​を参照してください。
11. Runtime Manager が Mule インスタンスを管理するのに使用するサービスの URL を指定するパラメーターをコマンドラインに付加します。
    
    [\[PCE Runtime Manager amc\_setup Parameters\]](<#PCE Runtime Manager amc_setup Parameters>)​を参照してください。
    
    `amc_setup`​ コマンドの例を次に示します。
    
    ```console
    ./amc_setup -H myToken myMuleServer -A +http://$DOCKER_IP_ADDRESS:443/hybrid/api/v1+ -W "wss://AnypointPlatformHost:8889/mule" -C https://AnypointPlatformHost/accounts -F https://AnypointPlatformHost/apiplatform
    ```

`amc_setup`​ コマンドは ​`$MULE_HOME/conf/mule-agent.yml`​ ファイルを生成します。

### [](#pce-runtime-manager-の-amc_setup-パラメーター)PCE Runtime Manager の amc\_setup パラメーター

Anypoint Platform PCE Runtime Manager を使用した Mule の登録で必要な追加のパラメーターを下表に示します。これらのパラメーターは、​`./amc_setup -H ​_token_​ ​_server-name_`​ コマンドに追加します。

これらのパラメーターは、REST API 接続を設定する ​`-I`​ パラメーターや ​`S`​ パラメーターとは一緒に使用しないでください。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 30%;">
<col style="width: 30%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">パラメーター</th>
<th class="tableblock halign-left valign-top">値</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-A</code>​</p>
</div>
<div class="paragraph">
<p><code>--amc-host</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code><em>amc-host</em></code>​</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Runtime Manager のローカルインスタンスのサービスの場所を示す URL を指定します (例: <code>https://10.0.0.1:443/hybrid/v1</code>​)。</p>
</div>
<div class="paragraph">
<p>サービスが使用可能かどうかは、​<code><em>AMC_HOST</em>/hybrid/v1</code>​ でテストできます。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-W</code>​</p>
</div>
<div class="paragraph">
<p><code>--mcm-host</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code><em>mcm-host</em></code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>MCM のローカルインスタンスのサービスの場所を示す URL を指定します (例: <code>wss://10.0.0.2:8889/mule</code>​)。</p>
</div>
<div class="paragraph">
<p>サービスが使用可能かどうかは、​<code><em>MCM_HOST</em>/mule</code>​ でテストできます。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-C</code>​</p>
</div>
<div class="paragraph">
<p><code>--cs-host</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code><em>core-services-host</em></code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アクセス管理のローカルインスタンスのサービスの場所を示す URL を指定します (例: <code>https://10.0.0.3:443/accounts</code>​)。</p>
</div>
<div class="paragraph">
<p>サービスが使用可能かどうかは、​<code><em>core-services-host</em>​/accounts</code>​ でテストできます。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-D</code>​</p>
</div>
<div class="paragraph">
<p><code>--contract-caching-service-host</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code><em>contract-caching-service-host</em></code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>コントラクトキャッシュサービスのローカルインスタンスのサービスの場所を示す URL を指定します (例: <code>https://10.0.0.4:8080</code>​)。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-F</code>​</p>
</div>
<div class="paragraph">
<p><code>--api-platform-host</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code><em>api-platform-host</em></code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>API Manager のローカルインスタンスのサービスの場所を示す URL を指定します (例: <code>https://10.0.0.5:443/apiplatform</code>​)。</p>
</div>
<div class="paragraph">
<p>サービスが使用可能かどうかは、​<code><em>API_PLATFORM_HOST</em>/apiplatform</code>​ でテストできます。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-Z</code>​</p>
</div>
<div class="paragraph">
<p><code>--auth-proxy-host</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code><em>auth-proxy-host</em></code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>認証プロキシのサービスの場所を示す URL を指定します (例:​<code>https://10.0.0.3:8080</code>​)。</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#encrypt_password)既存の mule-agent.yml ファイルでのパスワードの暗号化

エージェントを Runtime Manager に登録するときに ​`AGENT_VAR_master_password`​ 環境変数を設定しなかった場合、後から ​`mule-agent.yml`​ ファイルで次のパスワードを暗号化できます。

- `keystorePassword`​: `mule-agent.jks`​ ファイルにアクセスするために使用するキーストアパスワード
- `keystoreAliasPassword`​: `mule-agent.jks`​ ファイルにアクセスするために使用するキーストアの別名パスワード
- `password`​: プロキシサーバーに対する認証に使用するパスワード

### [](#前提条件-2)前提条件

- Runtime Manager エージェントバージョン 2.4.17
    
    以前のバージョンのエージェントを更新するには、​[\[Update the Agent\]](<#Update the Agent>)​を参照してください。

### [](#パスワードを暗号化する)パスワードを暗号化する

`mule-agent.yml`​ ファイルのパスワードを暗号化する手順は、次のとおりです。

1. `AGENT_VAR_master_password`​ 環境変数をメインパスワードに設定します。
    
    `export AGENT_VAR_master_password=myPassword`
2. 暗号化ユーティリティを実行します。
    
    `$MULE_HOME/bin/amc_setup --encrypt`
    
    暗号化ユーティリティでは、​`mule-agent.yml`​ ファイルの ​`keystorePassword`​ 項目、​`keystoreAliasPassword`​ 項目、​`password`​ 項目のパスワードが暗号化されたパスワードに置き換えられます。たとえば、次のようになります。
    
    ```yaml
    globalConfiguration:
      security:
        keyStorePassword: '![PBEWITHSHA1ANDDESEDE,Fe4kl2UBnGRoyh7H2v9lq+QSG7Pe6ZP8k34xmZEHmcAb1jABAwPLk2xWrGtSt1iE]'
        keyStoreAlias: agent
        keyStoreAliasPassword: '![PBEWITHSHA1ANDDESEDE,EtqRDPq7UTxDHzZGpOGazfcveEi832Pqm1mqhlwYRGLZGh9NSNXie6nAZr09b3iT]'
      authenticationProxy:
        endpoint: https://data-authenticator.anypoint.mulesoft.com:443
      proxyConfiguration:
        password: '![PBEWITHSHA1ANDDESEDE,VIs82yFDp66lnsL/Rss8q8js/zPDQ8+HJpdNepdZtA9obeDj5u+z4HIocsbLvXow]'
    ```

暗号化されたパスワードは、先頭が ​`!`​ で角括弧 ​`[ ]`​ で囲まれます。

### [](#パスワードを更新して再暗号化する)パスワードを更新して再暗号化する

`mule-agent.yml`​ ファイルの暗号化されたパスワードを更新する手順は、次のとおりです。

1. `mule-agent.yml`​ を編集します。
2. 暗号化されたパスワードを新しいプレーンテキストのパスワードに置き換えます。
3. `AGENT_VAR_master_password`​ 環境変数を設定します。
    
    `export AGENT_VAR_master_password=myPassword`
4. 暗号化ユーティリティを実行します。
    
    `$MULE_HOME/bin/amc_setup --encrypt`

### [](#プレーンテキストでの-mule-agent-yml-のパスワードの表示)プレーンテキストでの mule-agent.yml のパスワードの表示

`mule-agent.yml`​ のパスワードをプレーンテキストで表示するには、復号化ユーティリティを実行します。

`$MULE_HOME/bin/amc_setup --decrypt`

このコマンドにより、プレーンテキストのパスワードが含まれる ​`mule-agent.yml`​ ファイルのコンテンツが出力されます。

### [](#メインパスワードを更新する)メインパスワードを更新する

メインパスワードを更新する手順は、次のとおりです。

1. 復号化ユーティリティを実行します。
    
    `$MULE_HOME/bin/amc_setup --decrypt`
2. `AGENT_VAR_master_password`​ 環境変数を新しいメインパスワードに設定します。
    
    `export AGENT_VAR_master_password=myNewPassword`
3. 暗号化ユーティリティを実行します。
    
    `$MULE_HOME/bin/amc_setup --encrypt`

## [](#関連情報)関連情報

- [Enterprise ライセンスのインストール](https://docs.mulesoft.com/on-premises/latest/installing-an-enterprise-license)
- [Mule の開始と停止](https://docs.mulesoft.com/on-premises/latest/starting-and-stopping-mule-esb)
- [Runtime - API ゲートウェイ](https://docs.mulesoft.com/jp/mule-gateway/mule-gateway-overview)
- [Runtime Manager エージェントアーキテクチャ](https://docs.mulesoft.com/jp/runtime-manager/runtime-manager-agent-architecture)
- [Runtime Manager でのサーバーの作成 (ハイブリッド)](https://docs.mulesoft.com/jp/runtime-manager/servers-create)
- [Anypoint Private Cloud インストーラー](https://docs.mulesoft.com/private-cloud/latest/install-workflow)