翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon MQ for ActiveMQ ブローカーの設定
<a name="amazon-mq-broker-configuration-parameters"></a>

 設定には、ActiveMQ ブローカーのすべての設定が XML 形式で含まれています (ActiveMQ の `activemq.xml` ファイルに似ています)。設定は、ブローカーを作成する前に作成することができます。作成後、設定を 1 つ、または複数のブローカーに適用できます。

**重要**  
設定を変更しても、その変更はブローカーに直ちに適用*されません*。変更を適用するには、次のメンテナンスウィンドウまで待機するか、[ブローカーを再起動](amazon-mq-rebooting-broker.md)する必要があります。  
設定は `DeleteConfiguration` API を使用してのみ**削除**できます。詳細については、「*Amazon MQ API リファレンス*」の「[設定](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/configurations-configuration-id.html)」を参照してください。

## 属性
<a name="configuration-attributes"></a>

ブローカー設定には複数の属性があります。次に例を示します。
+ 名前 (`MyConfiguration`)
+ ID (`c-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`)
+ Amazon リソースネーム (ARN) (`arn:aws:mq:us-east-2:123456789012:configuration:c-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`)

設定属性の完全なリストについては、*Amazon MQ REST API リファレンス*で以下を参照してください。
+ [REST オペレーション ID: 設定](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configuration.html)
+ [REST オペレーション ID: 設定](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configurations.html)

設定のリビジョン属性の詳細なリストについては、以下を参照してください。
+ [REST オペレーション ID: 設定のリビジョン](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configuration-revision.html)
+ [REST オペレーション ID: 設定のリビジョン](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configuration-revisions.html)

## Spring XML 設定ファイルの使用
<a name="working-with-spring-xml-configuration-files"></a>

[Spring XML](https://docs.spring.io/spring/docs/current/spring-framework-reference/) ファイルを使用して ActiveMQ ブローカーを設定します。事前定義された送信先、送信先ポリシー、認可ポリシー、およびプラグインなど、ActiveMQ ブローカーのさまざまな側面を設定できます。Amazon MQ は、ネットワーク転送およびストレージなど、これらの設定要素の一部を制御します。ブローカーのネットワーク作成など、他の設定オプションは、現在サポートされていません。

サポートされている設定オプションの完全なセットは、Amazon MQ XML スキーマに指定されています。次のリンクを使用して、サポートされているスキーマの zip ファイルをダウンロードします。
+ [samples/amazon-mq-active-mq-5.19.1.xsd.zip](samples/amazon-mq-active-mq-5.19.1.xsd.zip) 
+ [samples/amazon-mq-active-mq-5.18.4.xsd.zip](samples/amazon-mq-active-mq-5.18.4.xsd.zip) 
+ [samples/amazon-mq-active-mq-5.17.6.xsd.zip](samples/amazon-mq-active-mq-5.17.6.xsd.zip) 
+ [samples/amazon-mq-active-mq-5.16.7.xsd.zip](samples/amazon-mq-active-mq-5.16.7.xsd.zip) 
+  [samples/amazon-mq-active-mq-5.15.16.xsd.zip](samples/amazon-mq-active-mq-5.15.16.xsd.zip) 

これらのスキーマは、設定ファイルの検証とサニタイズに使用できます。Amazon MQ では、XML ファイルをアップロードして設定を提供することもできます。XML ファイルをアップロードすると、Amazon MQ は、スキーマに従って無効および禁止されている設定パラメータを自動的にサニタイズし、削除します。

**注記**  
属性には静的な値のみを使用できます。Amazon MQ は、Spring 式、変数、および要素参照が含まれる要素と属性を設定からサニタイズします。

# Amazon MQ for ActiveMQ ブローカー設定の作成
<a name="amazon-mq-creating-applying-configurations"></a>

*設定*には、ActiveMQ ブローカーのすべての設定が XML 形式で含まれています (ActiveMQ の `activemq.xml` ファイルに似ています)。設定は、ブローカーを作成する前に作成することができます。作成後、設定を 1 つ、または複数のブローカーに適用できます。設定は直ちに適用する、または*メンテナンスウィンドウ*中に適用することができます。

以下の例では、 AWS マネジメントコンソールを使用して Amazon MQ ブローカーの設定を作成し、適用する方法を説明します。

**重要**  
設定は `DeleteConfiguration` API を使用してのみ**削除**できます。詳細については、「*Amazon MQ API リファレンス*」の「[設定](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/configurations-configuration-id.html)」を参照してください。

## 新しい設定の作成
<a name="creating-configuration-from-scratch-console"></a>

新しいブローカー設定を作成するには、まず新しい設定を作成します。

1. [Amazon MQ コンソール](https://console.aws.amazon.com/amazon-mq/)にサインインします。

1. 左側のナビゲーションパネルを展開し、[**設定**] を選択します。  
![\[Amazon MQ navigation panel showing Brokers and Configurations options.\]](http://docs.aws.amazon.com/ja_jp/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-create-configuration.png)

1. [**設定**] ページで、[**Create configuration (設定の作成)**] を選択します。

1. **[設定の作成]** ページの **[詳細]** セクションで **[設定名]** (`MyConfiguration` など) を入力し、**[ブローカーエンジン]** のバージョンを選択します。
**注記**  
Amazon MQ for ActiveMQ がサポートする ActiveMQ エンジンバージョンの詳細については、「[Amazon MQ for ActiveMQ エンジンバージョンの管理](activemq-version-management.md)」を参照してください。

1. [**Create configuration**] (設定の作成) をクリックします。

## 新しい設定リビジョンの作成
<a name="creating-new-configuration-revision-console"></a>

ブローカー設定を作成したら、設定リビジョンを使用して設定を編集する必要があります。

1. 設定リストから、[***MyConfiguration***] を選択します。
**注記**  
設定の最初のリビジョンは常に、Amazon MQ が設定を作成するときに作成されます。

   **[*MyConfiguration*]** ページに、新しい設定リビジョンで使用されるブローカーのエンジンタイプとバージョン (**Apache ActiveMQ 5.15.16** など) が表示されます。

1. [**Configuration details**] タブに、設定リビジョン番号、説明、およびブローカー設定が XML 形式で表示されます。
**注記**  
現在の設定を編集すると、設定の新しいリビジョンが作成されます。  
![\[XML configuration snippet for ActiveMQ broker with explanatory comment.\]](http://docs.aws.amazon.com/ja_jp/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-edit-configuration.png)

1. [**Edit configuration**] (設定の編集) をクリックして、XML 設定を変更します。

1. [**Save**] (保存) をクリックします。

   [**Save revision**] (リビジョンの保存) ダイアログボックスが表示されます。

1. (オプション) `A description of the changes in this revision` を入力します。

1. **[保存]** を選択します。

   設定の新しいリビジョンが保存されます。
**重要**  
Amazon MQ コンソールは、スキーマに従って、無効および禁止されている設定パラメータを自動的にサニタイズします。許可されている XML パラメータの詳細および完全なリストについては、「[Amazon MQ for ActiveMQ ブローカーの設定](amazon-mq-broker-configuration-parameters.md)」を参照してください。

## 設定リビジョンをブローカーに適用する
<a name="apply-configuration-revision-creating-console"></a>

設定を変更したら、設定リビジョンをブローカーに適用できます。

1. 左側のナビゲーションパネルを展開し、[**Brokers (ブローカー)**] を選択します。  
![\[Amazon MQ navigation panel showing Brokers and Configurations options.\]](http://docs.aws.amazon.com/ja_jp/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-apply-configuration.png)

1. ブローカーリストからブローカーを選択して (**MyBroker** など)、[**Edit**] (編集) をクリックします。

1. [**Edit *MyBroker***] (MyBroker の編集) ページの [**Configuration**] (設定) セクションで [**Configuration**] (設定) と [**Revision**] (リビジョン) を選択してから、[**Schedule Modifications**] (変更をスケジュールする) をクリックします。

1. [**ブローカー変更のスケジュール**] セクションで、変更を [**次回のスケジュールされたメンテナンスウィンドウ中**] に適用するか、[**即時**] 適用するかを選択します。
**重要**  
再起動中、シングルインスタンスブローカーはオフラインになります。クラスターブローカーの場合、ブローカーの再起動中にダウンするノードは 1 つだけです。

1. [**Apply**] (適用) をクリックします。

   設定リビジョンが指定された時刻にブローカーに適用されます。

# Amazon MQ for ActiveMQ 設定リビジョンの編集
<a name="edit-current-configuration-console"></a>

ブローカーに設定リビジョンを適用した後で、そのリビジョンを編集する必要が生じることがあります。設定リビジョンを編集するには、次の手順に従います。

1. [Amazon MQ コンソール](https://console.aws.amazon.com/amazon-mq/)にサインインします。

1. ブローカーリストからブローカーを選択して (**MyBroker** など)、[**Edit**] (編集) をクリックします。

1. [***MyBroker***] ページで、[**編集**] を選択します。

1. [**Edit *MyBroker***] (MyBroker の編集) ページの [**Configuration**] (設定) セクションで [**Configuration**] (設定) と [**Revision**] (リビジョン) を選択してから、[**Edit**] (変更) をクリックします。
**注記**  
ブローカーの作成時に設定を選択する場合を除き、最初のリビジョンは、常に Amazon MQ がブローカーを作成する時に作成されます。

   [***MyBroker***] ページに、設定が使用するブローカーのエンジンタイプとバージョン (**Apache ActiveMQ 5.15.8** など) が表示されます。

1. [**Configuration details**] タブに、設定リビジョン番号、説明、およびブローカー設定が XML 形式で表示されます。
**注記**  
現在の設定を編集すると、設定の新しいリビジョンが作成されます。  
![\[XML configuration snippet for ActiveMQ broker with explanatory comment.\]](http://docs.aws.amazon.com/ja_jp/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-edit-configuration.png)

1. [**Edit configuration**] (設定の編集) をクリックして、XML 設定を変更します。

1. [**Save**] (保存) をクリックします。

   [**Save revision**] (リビジョンの保存) ダイアログボックスが表示されます。

1. (オプション) `A description of the changes in this revision` を入力します。

1. **[保存]** を選択します。

   設定の新しいリビジョンが保存されます。
**重要**  
Amazon MQ コンソールは、スキーマに従って、無効および禁止されている設定パラメータを自動的にサニタイズします。許可されている XML パラメータの詳細および完全なリストについては、「[Amazon MQ for ActiveMQ ブローカーの設定](amazon-mq-broker-configuration-parameters.md)」を参照してください。

# Amazon MQ の設定で許可されている要素
<a name="permitted-elements"></a>

以下は、Amazon MQ 設定で許可されている要素の詳しいリストです。詳細については、Apache ActiveMQ ドキュメントの [XML 設定](http://activemq.apache.org/xml-configuration.html)を参照してください。


| Element | 
| --- | 
| abortSlowAckConsumerStrategy [(属性)](permitted-attributes.md#abortSlowAckConsumerStrategy.attributes) | 
| abortSlowConsumerStrategy [(属性)](permitted-attributes.md#abortSlowConsumerStrategy.attributes) | 
| authorizationEntry [(属性)](permitted-attributes.md#authorizationEntry.attributes) | 
| authorizationMap [(子コレクション要素)](permitted-collections.md#authorizationMap.collections) | 
| authorizationPlugin [(子コレクション要素)](permitted-collections.md#authorizationPlugin.collections) | 
| broker [(属性](permitted-attributes.md#broker.attributes) \$1 [子コレクション要素)](permitted-collections.md#broker.collections) | 
| cachedMessageGroupMapFactory [(属性)](permitted-attributes.md#cachedMessageGroupMapFactory.attributes) | 
| compositeQueue [(属性](permitted-attributes.md#compositeQueue.attributes) \$1 [子コレクション要素)](permitted-collections.md#compositeQueue.collections) | 
| compositeTopic [(属性](permitted-attributes.md#compositeTopic.attributes) \$1 [子コレクション要素)](permitted-collections.md#compositeTopic.collections) | 
| constantPendingMessageLimitStrategy [(属性)](permitted-attributes.md#constantPendingMessageLimitStrategy.attributes) | 
| discarding [(属性)](permitted-attributes.md#discarding.attributes) | 
| discardingDLQBrokerPlugin [(属性)](permitted-attributes.md#discardingDLQBrokerPlugin.attributes) | 
| fileCursor | 
| fileDurableSubscriberCursor | 
| fileQueueCursor | 
| filteredDestination [(属性)](permitted-attributes.md#filteredDestination.attributes) | 
| fixedCountSubscriptionRecoveryPolicy [(属性)](permitted-attributes.md#fixedCountSubscriptionRecoveryPolicy.attributes) | 
| fixedSizedSubscriptionRecoveryPolicy [(属性)](permitted-attributes.md#fixedSizedSubscriptionRecoveryPolicy.attributes) | 
| forcePersistencyModeBrokerPlugin [(属性)](permitted-attributes.md#forcePersistencyModeBrokerPlugin.attributes) | 
| individualDeadLetterStrategy [(属性)](permitted-attributes.md#individualDeadLetterStrategy.attributes) | 
| lastImageSubscriptionRecoveryPolicy | 
| messageGroupHashBucketFactory [(属性)](permitted-attributes.md#messageGroupHashBucketFactory.attributes) | 
| mirroredQueue [(属性)](permitted-attributes.md#mirroredQueue.attributes) | 
| noSubscriptionRecoveryPolicy | 
| oldestMessageEvictionStrategy [(属性)](permitted-attributes.md#oldestMessageEvictionStrategy.attributes) | 
| oldestMessageWithLowestPriorityEvictionStrategy [(属性)](permitted-attributes.md#oldestMessageWithLowestPriorityEvictionStrategy.attributes) | 
| policyEntry [(属性](permitted-attributes.md#policyEntry.attributes) \$1 [子コレクション要素)](permitted-collections.md#policyEntry.collections) | 
| policyMap [(子コレクション要素)](permitted-collections.md#policyMap.collections) | 
| prefetchRatePendingMessageLimitStrategy [(属性)](permitted-attributes.md#prefetchRatePendingMessageLimitStrategy.attributes) | 
| priorityDispatchPolicy | 
| priorityNetworkDispatchPolicy | 
| queryBasedSubscriptionRecoveryPolicy [(属性)](permitted-attributes.md#queryBasedSubscriptionRecoveryPolicy.attributes) | 
| queue [(属性)](permitted-attributes.md#queue.attributes) | 
| redeliveryPlugin [(属性](permitted-attributes.md#redeliveryPlugin.attributes) \$1 [子コレクション要素)](permitted-collections.md#redeliveryPlugin.collections) | 
| redeliveryPolicy [(属性)](permitted-attributes.md#redeliveryPolicy.attributes) | 
| redeliveryPolicyMap [(子コレクション要素)](permitted-collections.md#redeliveryPolicyMap.collections) | 
| retainedMessageSubscriptionRecoveryPolicy [(子コレクション要素)](permitted-collections.md#retainedMessageSubscriptionRecoveryPolicy.collections) | 
| roundRobinDispatchPolicy | 
| sharedDeadLetterStrategy [(属性](permitted-attributes.md#sharedDeadLetterStrategy.attributes) \$1 [子コレクション要素)](permitted-collections.md#sharedDeadLetterStrategy.collections) | 
| simpleDispatchPolicy | 
| simpleMessageGroupMapFactory | 
| statisticsBrokerPlugin | 
| storeCursor | 
| storeDurableSubscriberCursor [(属性)](permitted-attributes.md#storeDurableSubscriberCursor.attributes) | 
| strictOrderDispatchPolicy | 
| tempDestinationAuthorizationEntry [(属性)](permitted-attributes.md#tempDestinationAuthorizationEntry.attributes) | 
| tempQueue [(属性)](permitted-attributes.md#tempQueue.attributes) | 
| tempTopic [(属性)](permitted-attributes.md#tempTopic.attributes) | 
| timedSubscriptionRecoveryPolicy [(属性)](permitted-attributes.md#timedSubscriptionRecoveryPolicy.attributes) | 
| timeStampingBrokerPlugin [(属性)](permitted-attributes.md#timeStampingBrokerPlugin.attributes) | 
| topic [(属性)](permitted-attributes.md#topic.attributes) | 
| transportConnector [(属性)](permitted-attributes.md#transportConnector.attributes) | 
| uniquePropertyMessageEvictionStrategy [(属性)](permitted-attributes.md#uniquePropertyMessageEvictionStrategy.attributes) | 
| virtualDestinationInterceptor [(子コレクション要素)](permitted-collections.md#virtualDestinationInterceptor.collections) | 
| virtualTopic [(属性)](permitted-attributes.md#virtualTopic.attributes) | 
| vmCursor | 
| vmDurableCursor | 
| vmQueueCursor | 

# Amazon MQ 設定で許可されている要素とその属性
<a name="permitted-attributes"></a>

以下は、Amazon MQ 設定で許可されている要素とその属性の詳しいリストです。詳細については、Apache ActiveMQ ドキュメントの [XML 設定](http://activemq.apache.org/xml-configuration.html)を参照してください。

スクロールバーを使用して、テーブルの残りの部分を確認します。

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/amazon-mq/latest/developer-guide/permitted-attributes.html)

## Amazon MQ 親要素属性
<a name="parent-element-details"></a>

以下は、親要素属性の詳しい説明です。詳細については、Apache ActiveMQ ドキュメントの [XML 設定](http://activemq.apache.org/xml-configuration.html)を参照してください。

**Topics**
+ [ブローカー](#broker-element)

### ブローカー
<a name="broker-element"></a>

`broker` は親コレクションの要素です。

#### 属性
<a name="broker-attributes"></a>

##### networkConnectionStartAsync
<a name="networkConnectionStartAsync"></a>

ネットワークのレイテンシーを短縮し、他のネットワークをタイムリーに起動できるようにするには、`<networkConnectionStartAsync>` タグを使用します。このタグは、ブローカーの起動とは非同期に、エグゼキューターを使用してネットワーク接続を並列に起動するようにブローカーに指示します。

**デフォルト**: `false`

#### サンプル設定
<a name="networkConnectorStartAsync"></a>

```
<broker networkConnectorStartAsync="false"/>
```

# Amazon MQ 設定で許可されている要素、子コレクション要素、およびそれらの子要素
<a name="permitted-collections"></a>

以下は、Amazon MQ 設定で許可されている要素、子コレクション要素、およびそれらの子要素の詳しいリストです。詳細については、Apache ActiveMQ ドキュメントの [XML 設定](http://activemq.apache.org/xml-configuration.html)を参照してください。

スクロールバーを使用して、テーブルの残りの部分を確認します。

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/amazon-mq/latest/developer-guide/permitted-collections.html)

# Amazon MQ 子要素属性
<a name="child-element-details"></a>

以下は、子要素属性の詳しい説明です。詳細については、Apache ActiveMQ ドキュメントの [XML 設定](http://activemq.apache.org/xml-configuration.html)を参照してください。

**Topics**
+ [authorizationEntry](#authorizationEntry)
+ [networkConnector](#networkConnector)
+ [kahaDB](#kahaDB)
+ [systemUsage](#systemUsage)

## authorizationEntry
<a name="authorizationEntry"></a>

`authorizationEntry` は `authorizationEntries` 子コレクション要素の子です。

### 属性
<a name="admin-read-write-attributes"></a>

#### 管理\$1読み取り\$1書き込み
<a name="admin-read-write"></a>

ユーザーのグループに付与されているアクセス許可。詳細については、「[認可マップを常に設定する](using-amazon-mq-securely.md#always-configure-authorization-map)」を参照してください。

`activemq-webconsole` グループが含まれない認可マップを指定する場合、Amazon MQ ブローカーにメッセージを送信する権限、またはブローカーからメッセージを受信する権限がグループにないことから、ActiveMQ ウェブコンソールは使用できません。

**デフォルト**: `null`

### サンプル設定
<a name="admin-read-write-example"></a>

```
<authorizationPlugin>
                                <map>
                                    <authorizationMap>
                                        <authorizationEntries>
                                            <authorizationEntry admin="admins,activemq-webconsole" read="admins,users,activemq-webconsole" write="admins,activemq-webconsole" queue=">"/>
                                            <authorizationEntry admin="admins,activemq-webconsole" read="admins,users,activemq-webconsole" write="admins,activemq-webconsole" topic=">"/>
                                        </authorizationEntries>
                                    </authorizationMap>
                                </map>
                                </authorizationPlugin>
```

**注記**  
 Amazon MQ 上の ActiveMQ の `activemq-webconsole` グループには、すべてのキューとトピックに対する管理者アクセス許可があります。このグループのすべてのユーザーは管理者アクセス権を持ちます。

## networkConnector
<a name="networkConnector"></a>

`networkConnector` は `networkConnectors` 子コレクション要素の子です。

**Topics**
+ [属性](#networkConnector-attributes)
+ [構成例](#networkConnector-example)

### 属性
<a name="networkConnector-attributes"></a>

#### conduitSubscriptions
<a name="conduitSubscriptions"></a>

ブローカーのネットワークのネットワーク接続が、同じ送信先にサブスクライブしている複数のコンシューマーを 1 つのコンシューマーとして扱うかどうかを指定します。たとえば、`conduitSubscriptions` が `true` に設定されていて、2 つのコンシューマーがブローカー B に接続して送信先から消費する場合、ブローカー B は、ブローカー A へのネットワーク接続を介してサブスクリプションを単一の論理サブスクリプションに結合するので、メッセージの単一コピーのみがブローカー A からブローカー B に転送されます。

**注記**  
`conduitSubscriptions` を `true` に設定すると、冗長なネットワークトラフィックを減らすことができます。ただし、この属性を使用すると、コンシューマー間でのメッセージのロードバランシングに影響が出る可能性があり、特定のシナリオ (JMS メッセージセレクタや耐久性のあるトピックなど) では正しくない動作を引き起こす可能性があります。

**デフォルト**: `true`

#### 二重
<a name="duplex"></a>

ブローカーのネットワーク内の接続を使用し、*また*メッセージを生成するかどうかを指定します。ブ たとえば、ブローカー A が非二重モードでブローカー B への接続を作成した場合、メッセージはブローカー A からブローカー B にのみ転送できます。ただし、ブローカー A がブローカー B への二重接続を作成した場合、ブローカー B は `<networkConnector>` を設定しなくてもメッセージをブローカー A に転送できます。

**デフォルト**: `false`

#### 名前
<a name="name"></a>

ブローカーのネットワークのブリッジの名前。

**デフォルト**: `bridge`

#### uri
<a name="uri"></a>

ブローカーのネットワークの 2 つのブローカーのうちの 1 つ (または複数のブローカー) のワイヤレベルプロトコルエンドポイント。

**デフォルト**: `null`

#### username
<a name="username"></a>

ブローカーのネットワークのブローカーに共通のユーザー名。

**デフォルト**: `null`

### 構成例
<a name="networkConnector-example"></a>

**注記**  
`networkConnector` を使用してブローカーのネットワークを定義するときは、ブローカーに共通のユーザーのパスワードを含めないでください。

#### 2 つのブローカーとブローカーのネットワーク
<a name="example-network-of-brokers-two-brokers"></a>

この設定では、2 つのブローカーがブローカーのネットワークで接続されています。ネットワークコネクターの名前は `connector_1_to_2`、ブローカーに共通のユーザー名は `myCommonUser`、接続は `duplex`、そして OpenWire エンドポイント URI は `static:` というプレフィックスは、ブローカー間の 1 対 1 の接続を示します。

```
<networkConnectors>
                                    <networkConnector name="connector_1_to_2" userName="myCommonUser" duplex="true"
                                        uri="static:(ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617)"/>
                                    </networkConnectors>
```

詳細については、「[ステップ 2: ブローカー用のネットワークコネクターを設定する](amazon-mq-creating-configuring-network-of-brokers.md#creating-configuring-network-of-brokers-configure-network-connectors)」を参照してください。

#### 複数のブローカーのあるブローカーのネットワーク
<a name="example-network-of-brokers-multiple-brokers"></a>

この設定では、複数のブローカーがブローカーのネットワークで接続されています。ネットワークコネクターの名前は `connector_1_to_2`、ブローカーに共通のユーザー名は `myCommonUser`、接続は `duplex` です。OpenWire エンドポイント URI のカンマ区切りのリストの前には `masterslave:` というプレフィックスが付き、ブローカー間のフェイルオーバー接続を示します。ブローカーからブローカーへのフェイルオーバーはランダム化されず、再接続の試行は無期限に続きます。

```
<networkConnectors>
                                    <networkConnector name="connector_1_to_2" userName="myCommonUser" duplex="true"
                                        uri="masterslave:(ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617,
                                        ssl://b-9876l5k4-32ji-109h-8gfe-7d65c4b132a1-2.mq.us-west-2.amazonaws.com:61617)"/>
                                    </networkConnectors>
```

**注記**  
ブローカーのネットワークの `masterslave:` プレフィックスを使用することをお勧めします。プレフィックスはより明示的な `static:failover:()?randomize=false&maxReconnectAttempts=0` 構文と完全に一致します。

**注記**  
この XML 設定ではスペースを使用できません。

## kahaDB
<a name="kahaDB"></a>

`kahaDB` は `persistenceAdapter` 子コレクション要素の子です。

### 属性
<a name="kahaDB-attributes"></a>

#### concurrentStoreAndDispatchQueues
<a name="concurrentStoreAndDispatchQueues"></a>

キューの同時保存とディスパッチを使用するかどうかを指定します。詳細については、「[低速コンシューマーのキューに対して同時保存とディスパッチを無効にする](best-practices-activemq.md#disable-concurrent-store-and-dispatch-queues-flag-slow-consumers)」を参照してください。

**デフォルト**: `true`

#### cleanupOnStop
<a name="cleanupOnStop"></a>

**以下でサポート**  
Apache ActiveMQ 15.16.x 以上

無効にされていると、ブローカーが停止されたときにガベージコレクションおよびクリーンアップが実行されず、シャットダウンプロセスの速度が上がります。高速化は、大規模なデータベースやスケジューラデータベースの場合に有用です。

**デフォルト**: `true`

#### journalDiskSyncInterval
<a name="journalDiskSyncInterval"></a>

`journalDiskSyncStrategy=periodic` の場合にディスク同期を実行する間隔 (ミリ秒)。詳細については、[Apache ActiveMQ kahaDB のドキュメント](https://activemq.apache.org/kahadb)を参照してください。

**デフォルト**: `1000`

#### journalDiskSyncStrategy
<a name="journalDiskSyncStrategy"></a>

**以下でサポート**  
Apache ActiveMQ 15.14.x 以上

ディスク同期ポリシーを設定します。詳細については、[Apache ActiveMQ kahaDB のドキュメント](https://activemq.apache.org/kahadb)を参照してください。

**デフォルト**: `always`

**注記**  
[ActiveMQ のドキュメント](https://activemq.apache.org/kahadb)では、データ損失は `journalDiskSyncInterval` の長さに制限されており、デフォルトは 1 秒です。厳密には言えませんが、データ損失はこの間隔よりも長くなる可能性があります。注意してください。

#### preallocationStrategy
<a name="preallocationStrategy"></a>

新しいジャーナルファイルが必要になったときにブローカーがジャーナルファイルの事前割り当てを試みる方法を設定します。詳細については、[Apache ActiveMQ kahaDB のドキュメント](https://activemq.apache.org/kahadb)を参照してください。

**デフォルト**: `sparse_file`

### サンプル設定
<a name="kahaDB-example"></a>

**Example**  

```
<broker xmlns="http://activemq.apache.org/schema/core">
                                <persistenceAdapter>
                                <kahaDB preallocationStrategy="zeros" concurrentStoreAndDispatchQueues="false" journalDiskSyncInterval="10000" journalDiskSyncStrategy="periodic"/>
                            </persistenceAdapter>
                            </broker>
```

## systemUsage
<a name="systemUsage"></a>

`systemUsage` は `systemUsage` 子コレクション要素の子です。プロデューサーの速度を遅くするまでにブローカーが使用する領域の最大量を制御します。詳細については、Apache ActiveMQ のドキュメントの [Producer Flow Control](http://activemq.apache.org/producer-flow-control.html) を参照してください。

### 子要素
<a name="systemUsage-child"></a>

#### memoryUsage
<a name="memoryUsage"></a>

 `memoryUsage` は `systemUsage` 子要素の子です。メモリ使用量を管理します。本番稼働での作業セットの使用を制御できるように、`memoryUsage` を使用してメモリ使用量を追跡します。詳細については、Apache ActiveMQ のドキュメントの [schema](http://activemq.apache.org/schema/core/activemq-core-5.15.12-schema.html) を参照してください。

##### 子要素
<a name="memoryUsage-child"></a>

 `memoryUsage` は `memoryUsage` 子要素の子です。

##### 属性
<a name="memeoryUsage-attribute"></a>

##### percentOfJvmHeap
<a name="percentOfJvmHeap"></a>

0 ～ 70 の整数。

*デフォルト*: `70` 

### 属性
<a name="systemUsage-attributes"></a>

#### sendFailIfNoSpace
<a name="sendFailIfNoSpace"></a>

空き領域がない場合に `send()` メソッドが失敗するかどうかを設定します。デフォルト値は false で、領域が空くまで `send()` メソッドをブロックします。詳細については、Apache Active MQ のドキュメントの [schema](http://activemq.apache.org/schema/core/activemq-core-5.15.12-schema.html) を参照してください。

**デフォルト**: `false`

#### sendFailIfNoSpaceAfterTimeout
<a name="sendFailIfNoSpaceAfterTimeout"></a>

**デフォルト**: `null`

#### サンプル設定
<a name="systemUsage-example"></a>

**Example**  

```
<broker xmlns="http://activemq.apache.org/schema/core">
                                <systemUsage>
                                <systemUsage sendFailIfNoSpace="true" sendFailIfNoSpaceAfterTimeout="2000">
                                    <memoryUsage>
                                        <memoryUsage  percentOfJvmHeap="60" />
                                    </memoryUsage>>
                                </systemUsage>
                                </systemUsage>
                            </broker>
                            </persistenceAdapter>
```