Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Configurations d'agent Amazon MQ for ActiveMQ
<a name="amazon-mq-broker-configuration-parameters"></a>

 Une configuration contient tous les paramètres de votre agent ActiveMQ au format XML (à l'instar du fichier `activemq.xml` d'ActiveMQ). Vous pouvez créer une configuration avant de créer des agents. Vous pouvez ensuite appliquer la configuration à un ou plusieurs agents. 

**Important**  
Apporter des modifications à une configuration n'applique *pas* immédiatement les modifications à l'agent. Pour appliquer vos modifications, vous devez attendre la fenêtre de maintenance suivante ou [redémarrer l’agent](amazon-mq-rebooting-broker.md).  
Vous ne pouvez **supprimer** une configuration qu'à l'aide de l'`DeleteConfiguration`API. Pour plus d'informations, consultez [Configurations](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/configurations-configuration-id.html) dans le manuel *Amazon MQ API Reference*.

## Attributes
<a name="configuration-attributes"></a>

La configuration d'un agent a plusieurs attributs, par exemple :
+ Un nom (`MyConfiguration`)
+ Un ID (`c-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`)
+ Un Amazon Resource Name (ARN) (`arn:aws:mq:us-east-2:123456789012:configuration:c-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`)

Pour obtenir la liste complète des attributs de configuration, consultez ce qui suit dans la *référence d'API REST Amazon MQ* :
+ [ID d'opération REST : Configuration](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configuration.html)
+ [ID d'opération REST : Configurations](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configurations.html)

Pour obtenir la liste complète des attributs des révisions de configuration, consultez les sections suivantes :
+ [ID d'opération REST : Révision de configuration](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configuration-revision.html)
+ [ID d'opération REST : Révisions de configuration](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configuration-revisions.html)

## Utilisation des fichiers de configuration XML Spring
<a name="working-with-spring-xml-configuration-files"></a>

Les agents ActiveMQ sont configurés à l'aide de fichiers [XML Spring](https://docs.spring.io/spring/docs/current/spring-framework-reference/). Vous pouvez configurer de nombreux aspects de votre agent ActiveMQ, comme les destinations prédéfinies, les politiques de destination, les politiques d'autorisation et les plugins. Amazon MQ contrôle certains de ces éléments de configuration, tels que les transports et le stockage réseau. D'autres options de configuration, telles que la création de réseaux d'agents, ne sont pas prises en charge actuellement.

L'ensemble complet des options de configuration prises en charge est spécifié dans les schémas XML Amazon MQ. Téléchargez les fichiers zip des schémas pris en charge en cliquant sur les liens suivants.
+ [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) 

Vous pouvez utiliser ces schémas pour valider et nettoyer vos fichiers de configuration. Amazon MQ vous permet également de fournir des configurations en chargeant des fichiers XML. Lorsque vous chargez un fichier XML, Amazon MQ supprime et nettoie automatiquement les paramètres de configuration non valides et interdits selon le schéma.

**Note**  
Vous pouvez uniquement utiliser des valeurs statiques pour les attributs. Amazon MQ nettoie les éléments et attributs qui contiennent des variables, des références d'élément et des expressions Spring.

# Création d'une configuration de broker Amazon MQ pour ActiveMQ
<a name="amazon-mq-creating-applying-configurations"></a>

Une *configuration* contient tous les paramètres de votre agent ActiveMQ au format XML (similaire au fichier `activemq.xml` d'ActiveMQ). Vous pouvez créer une configuration avant de créer des agents. Vous pouvez ensuite appliquer la configuration à un ou plusieurs agents. Vous pouvez appliquer une configuration immédiatement ou au cours d'une *fenêtre de maintenance*.

L'exemple suivant montre comment créer et appliquer une configuration d'agent Amazon MQ à l'aide de AWS Management Console.

**Important**  
Vous ne pouvez **supprimer** une configuration qu'à l'aide de l'`DeleteConfiguration`API. Pour plus d'informations, consultez [Configurations](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/configurations-configuration-id.html) dans le manuel *Amazon MQ API Reference*.

## Création d'une nouvelle configuration
<a name="creating-configuration-from-scratch-console"></a>

Pour créer une nouvelle configuration de broker, créez d'abord la nouvelle configuration.

1. Connectez-vous à la [console Amazon MQ](https://console.aws.amazon.com/amazon-mq/).

1. Sur la gauche, développez le volet de navigation et choisissez **Configurations**.  
![\[Amazon MQ navigation panel showing Brokers and Configurations options.\]](http://docs.aws.amazon.com/fr_fr/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-create-configuration.png)

1. Sur la page **Configurations**, choisissez **Create configuration (Créer une configuration)**.

1. Sur la page **Create configuration** (Créer une configuration), dans la section **Details** (Détails), saisissez le **Configuration name** (Nom de configuration) (par exemple, `MyConfiguration`) et sélectionnez une version de **Broker engine** (Moteur d'agent).
**Note**  
Pour en savoir plus sur les versions de moteur ActiveMQ prises en charge par Amazon MQ for ActiveMQ, consultez [Gestion des versions du moteur Amazon MQ for ActiveMQ](activemq-version-management.md).

1. Choisissez **Créer une configuration**.

## Créer une révision de configuration
<a name="creating-new-configuration-revision-console"></a>

Après avoir créé une configuration de broker, vous devez la modifier à l'aide d'une révision de configuration.

1. Dans la liste des configurations, choisissez ***MyConfiguration***.
**Note**  
La première révision de configuration est toujours créée lorsqu'Amazon MQ crée la configuration.

   Sur la ***MyConfiguration***page, le type et la version du moteur de courtage utilisés par votre nouvelle révision de configuration (par exemple, **Apache ActiveMQ** 5.15.16) sont affichés.

1. Dans l'onglet **Configuration details**, le numéro de révision de configuration, la description et la configuration d'agent au format XML sont affichés.
**Note**  
La modification de la configuration actuelle crée une nouvelle révision de configuration.  
![\[XML configuration snippet for ActiveMQ broker with explanatory comment.\]](http://docs.aws.amazon.com/fr_fr/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-edit-configuration.png)

1. Choisissez **Edit configuration (Modifier la configuration)** et apportez des modifications à la configuration XML.

1. Choisissez **Enregistrer**.

   La boîte de dialogue **Save revision (Enregistrer la révision)** s'affiche.

1. (Facultatif) Type `A description of the changes in this revision`.

1. Choisissez **Save (Enregistrer)**.

   La nouvelle révision de configuration est enregistrée.
**Important**  
La console Amazon MQ nettoie automatiquement les paramètres de configuration non valides et interdits selon un schéma. Pour plus d'informations et une liste complète des paramètres XML autorisés, consultez [Configurations d'agent Amazon MQ for ActiveMQ](amazon-mq-broker-configuration-parameters.md).

## Appliquer une révision de configuration à votre agent
<a name="apply-configuration-revision-creating-console"></a>

Après avoir révisé la configuration, vous pouvez appliquer la révision de configuration à votre courtier.

1. Sur la gauche, développez le volet de navigation et choisissez **Brokers (Agents)**.  
![\[Amazon MQ navigation panel showing Brokers and Configurations options.\]](http://docs.aws.amazon.com/fr_fr/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-apply-configuration.png)

1. Dans la liste des courtiers, sélectionnez votre courtier (par exemple **MyBroker**), puis choisissez **Modifier**.

1. Sur la *MyBroker* page **Modifier**, dans la section **Configuration**, sélectionnez une **configuration** et une **révision**, puis choisissez **Planifier les modifications**.

1. Dans la section **Schedule broker modifications (Planifier les modifications de l'agent)**, choisissez si les modifications doivent être appliquées **During the next scheduled maintenance window (Au cours de la prochaine fenêtre de maintenance)** ou **Immediately (immédiatement)**.
**Important**  
Les courtiers à instance unique sont hors ligne lors du redémarrage. Pour les courtiers en clusters, un seul nœud est en panne à la fois lorsque le courtier redémarre.

1. Cliquez sur **Appliquer**.

   Votre révision de configuration est appliquée à votre agent à l'heure spécifiée.

# Modifier une révision de configuration Amazon MQ pour ActiveMQ
<a name="edit-current-configuration-console"></a>

Vous souhaiterez peut-être modifier une révision de configuration après l'avoir appliquée à votre courtier. Suivez les instructions ci-dessous pour modifier une révision de configuration.

1. Connectez-vous à la [console Amazon MQ](https://console.aws.amazon.com/amazon-mq/).

1. Dans la liste des courtiers, sélectionnez votre courtier (par exemple **MyBroker**), puis choisissez **Modifier**.

1. Sur la ***MyBroker***page, choisissez **Modifier**.

1. Sur la *MyBroker* page **Modifier**, dans la section **Configuration**, sélectionnez une **configuration** et une **révision**, puis choisissez **Modifier**.
**Note**  
Sauf si vous sélectionnez une configuration lorsque vous créez un agent, la première révision de configuration est toujours créée lorsqu'Amazon MQ crée l'agent.

   Sur la ***MyBroker***page, le type et la version du moteur de courtage utilisés par la configuration (par exemple, **Apache ActiveMQ** 5.15.8) sont affichés.

1. Dans l'onglet **Configuration details**, le numéro de révision de configuration, la description et la configuration d'agent au format XML sont affichés.
**Note**  
La modification de la configuration actuelle crée une nouvelle révision de configuration.  
![\[XML configuration snippet for ActiveMQ broker with explanatory comment.\]](http://docs.aws.amazon.com/fr_fr/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-edit-configuration.png)

1. Choisissez **Edit configuration (Modifier la configuration)** et apportez des modifications à la configuration XML.

1. Choisissez **Enregistrer**.

   La boîte de dialogue **Save revision (Enregistrer la révision)** s'affiche.

1. (Facultatif) Type `A description of the changes in this revision`.

1. Choisissez **Save (Enregistrer)**.

   La nouvelle révision de configuration est enregistrée.
**Important**  
La console Amazon MQ nettoie automatiquement les paramètres de configuration non valides et interdits selon un schéma. Pour plus d'informations et une liste complète des paramètres XML autorisés, consultez [Configurations d'agent Amazon MQ for ActiveMQ](amazon-mq-broker-configuration-parameters.md).

# Éléments autorisés dans les configurations Amazon MQ
<a name="permitted-elements"></a>

Voici une liste détaillée des éléments autorisés dans les configurations Amazon MQ. Pour plus d'informations, consultez la page [Configuration XML](http://activemq.apache.org/xml-configuration.html) dans la documentation ActiveMQ Apache.


| Element | 
| --- | 
| abortSlowAckConsumerStrategy [(attributs)](permitted-attributes.md#abortSlowAckConsumerStrategy.attributes) | 
| abortSlowConsumerStrategy [(attributs)](permitted-attributes.md#abortSlowConsumerStrategy.attributes) | 
| authorizationEntry [(attributs)](permitted-attributes.md#authorizationEntry.attributes) | 
| authorizationMap [(Éléments de collection enfant)](permitted-collections.md#authorizationMap.collections) | 
| authorizationPlugin [(Éléments de collection enfant)](permitted-collections.md#authorizationPlugin.collections) | 
| broker [(attributs](permitted-attributes.md#broker.attributes) \$1 [Éléments de collection enfant)](permitted-collections.md#broker.collections) | 
| cachedMessageGroupMapFactory [(attributs)](permitted-attributes.md#cachedMessageGroupMapFactory.attributes) | 
| compositeQueue [(attributs](permitted-attributes.md#compositeQueue.attributes) \$1 [Éléments de collection enfant)](permitted-collections.md#compositeQueue.collections) | 
| compositeTopic [(attributs](permitted-attributes.md#compositeTopic.attributes) \$1 [Éléments de collection enfant)](permitted-collections.md#compositeTopic.collections) | 
| constantPendingMessageLimitStrategy [(attributs)](permitted-attributes.md#constantPendingMessageLimitStrategy.attributes) | 
| discarding [(attributs)](permitted-attributes.md#discarding.attributes) | 
| discardingDLQBrokerPlugin [(attributs)](permitted-attributes.md#discardingDLQBrokerPlugin.attributes) | 
| fileCursor | 
| fileDurableSubscriberCursor | 
| fileQueueCursor | 
| filteredDestination [(attributs)](permitted-attributes.md#filteredDestination.attributes) | 
| fixedCountSubscriptionRecoveryPolicy [(attributs)](permitted-attributes.md#fixedCountSubscriptionRecoveryPolicy.attributes) | 
| fixedSizedSubscriptionRecoveryPolicy [(attributs)](permitted-attributes.md#fixedSizedSubscriptionRecoveryPolicy.attributes) | 
| forcePersistencyModeBrokerPlugin [(attributs)](permitted-attributes.md#forcePersistencyModeBrokerPlugin.attributes) | 
| individualDeadLetterStrategy [(attributs)](permitted-attributes.md#individualDeadLetterStrategy.attributes) | 
| lastImageSubscriptionRecoveryPolicy | 
| messageGroupHashBucketFactory [(attributs)](permitted-attributes.md#messageGroupHashBucketFactory.attributes) | 
| mirroredQueue [(attributs)](permitted-attributes.md#mirroredQueue.attributes) | 
| noSubscriptionRecoveryPolicy | 
| oldestMessageEvictionStrategy [(attributs)](permitted-attributes.md#oldestMessageEvictionStrategy.attributes) | 
| oldestMessageWithLowestPriorityEvictionStrategy [(attributs)](permitted-attributes.md#oldestMessageWithLowestPriorityEvictionStrategy.attributes) | 
| policyEntry [(attributs](permitted-attributes.md#policyEntry.attributes) \$1 [Éléments de collection enfant)](permitted-collections.md#policyEntry.collections) | 
| policyMap [(Éléments de collection enfant)](permitted-collections.md#policyMap.collections) | 
| prefetchRatePendingMessageLimitStrategy [(attributs)](permitted-attributes.md#prefetchRatePendingMessageLimitStrategy.attributes) | 
| priorityDispatchPolicy | 
| priorityNetworkDispatchPolicy | 
| queryBasedSubscriptionRecoveryPolicy [(attributs)](permitted-attributes.md#queryBasedSubscriptionRecoveryPolicy.attributes) | 
| queue [(attributs)](permitted-attributes.md#queue.attributes) | 
| redeliveryPlugin [(attributs](permitted-attributes.md#redeliveryPlugin.attributes) \$1 [Éléments de collection enfant)](permitted-collections.md#redeliveryPlugin.collections) | 
| redeliveryPolicy [(attributs)](permitted-attributes.md#redeliveryPolicy.attributes) | 
| redeliveryPolicyMap [(Éléments de collection enfant)](permitted-collections.md#redeliveryPolicyMap.collections) | 
| retainedMessageSubscriptionRecoveryPolicy [(Éléments de collection enfant)](permitted-collections.md#retainedMessageSubscriptionRecoveryPolicy.collections) | 
| roundRobinDispatchPolicy | 
| sharedDeadLetterStrategy [(attributs](permitted-attributes.md#sharedDeadLetterStrategy.attributes) \$1 [Éléments de collection enfant)](permitted-collections.md#sharedDeadLetterStrategy.collections) | 
| simpleDispatchPolicy | 
| simpleMessageGroupMapFactory | 
| statisticsBrokerPlugin | 
| storeCursor | 
| storeDurableSubscriberCursor [(attributs)](permitted-attributes.md#storeDurableSubscriberCursor.attributes) | 
| strictOrderDispatchPolicy | 
| tempDestinationAuthorizationEntry [(attributs)](permitted-attributes.md#tempDestinationAuthorizationEntry.attributes) | 
| tempQueue [(attributs)](permitted-attributes.md#tempQueue.attributes) | 
| tempTopic [(attributs)](permitted-attributes.md#tempTopic.attributes) | 
| timedSubscriptionRecoveryPolicy [(attributs)](permitted-attributes.md#timedSubscriptionRecoveryPolicy.attributes) | 
| timeStampingBrokerPlugin [(attributs)](permitted-attributes.md#timeStampingBrokerPlugin.attributes) | 
| topic [(attributs)](permitted-attributes.md#topic.attributes) | 
| transportConnector [(attributs)](permitted-attributes.md#transportConnector.attributes) | 
| uniquePropertyMessageEvictionStrategy [(attributs)](permitted-attributes.md#uniquePropertyMessageEvictionStrategy.attributes) | 
| virtualDestinationInterceptor [(Éléments de collection enfant)](permitted-collections.md#virtualDestinationInterceptor.collections) | 
| virtualTopic [(attributs)](permitted-attributes.md#virtualTopic.attributes) | 
| vmCursor | 
| vmDurableCursor | 
| vmQueueCursor | 

# Éléments et leurs attributs autorisés dans les configurations Amazon MQ
<a name="permitted-attributes"></a>

Voici une liste détaillée des éléments et de leurs attributs autorisés dans les configurations Amazon MQ. Pour plus d'informations, consultez la page [Configuration XML](http://activemq.apache.org/xml-configuration.html) dans la documentation ActiveMQ Apache.

Utilisez les barres de défilement pour voir le reste du tableau.

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

## Attributs d'élément parent Amazon MQ
<a name="parent-element-details"></a>

Voici une explication détaillée des attributs d'élément parent. Pour plus d'informations, consultez la page [Configuration XML](http://activemq.apache.org/xml-configuration.html) dans la documentation ActiveMQ Apache.

**Topics**
+ [agent](#broker-element)

### agent
<a name="broker-element"></a>

`broker` est un élément de collecte parent. 

#### Attributes
<a name="broker-attributes"></a>

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

Pour atténuer la latence du réseau et autoriser d'autres réseaux à démarrer en temps opportun, utilisez la balise `<networkConnectionStartAsync>`. La balise demande à l'agent d'utiliser un exécuteur pour démarrer des connexions réseau en parallèle et asynchrones au commencement d'un agent.

**Par défaut** : `false`

#### Exemple de configuration
<a name="networkConnectorStartAsync"></a>

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

# Éléments, éléments de collection enfant et leurs éléments enfants autorisés dans les configurations Amazon MQ
<a name="permitted-collections"></a>

Voici une liste détaillée des éléments, des éléments de collection enfant et de leurs éléments enfant autorisés dans les configurations Amazon MQ. Pour plus d'informations, consultez la page [Configuration XML](http://activemq.apache.org/xml-configuration.html) dans la documentation ActiveMQ Apache.

Utilisez les barres de défilement pour voir le reste du tableau.

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

# Attributs d'élément enfant Amazon MQ
<a name="child-element-details"></a>

Voici une explication détaillée des attributs d'élément enfant. Pour plus d'informations, consultez la page [Configuration XML](http://activemq.apache.org/xml-configuration.html) dans la documentation ActiveMQ Apache.

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

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

`authorizationEntry` est un enfant de la collection d'élément enfant `authorizationEntries`.

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

#### admin\$1read\$1write
<a name="admin-read-write"></a>

Les autorisations accordées à un groupe d'utilisateurs. Pour de plus amples informations, veuillez consulter [Toujours configurer un plan d'autorisation](using-amazon-mq-securely.md#always-configure-authorization-map).

Si vous spécifiez un plan d'autorisation qui n'inclut pas le groupe `activemq-webconsole`, vous ne pouvez pas utiliser la console web ActiveMQ car le groupe n'est pas autorisé à envoyer des messages à l'agent Amazon MQ ou à recevoir des messages de ce dernier.

**Par défaut** : `null`

### Exemple de configuration
<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>
```

**Note**  
 Le `activemq-webconsole` groupe dans ActiveMQ sur Amazon MQ possède des autorisations d'administrateur sur toutes les files d'attente et sur tous les sujets. Tous les utilisateurs de ce groupe auront un accès administrateur. 

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

`networkConnector` est un enfant de la collection d'élément enfant `networkConnectors`.

**Topics**
+ [Attributes](#networkConnector-attributes)
+ [Exemples de configuration](#networkConnector-example)

### Attributes
<a name="networkConnector-attributes"></a>

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

Indique si une connexion réseau dans un réseau d'agents traite plusieurs consommateurs abonnés à la même destination comme un seul consommateur. Par exemple, si `conduitSubscriptions` est défini comme `true` et que deux consommateurs se connectent à l'agent B et consomment à partir d'une destination, l'agent B combine les abonnements en un seul abonnement logique sur la connexion réseau de l'agent A, afin qu'une seule copie d'un message soit transférée de l'agent A à l'agent B. 

**Note**  
Définir `conduitSubscriptions` comme `true` peut réduire le trafic réseau redondant. Cependant, utiliser cet attribut peut avoir des conséquences pour l'équilibrage de charge des messages entre des consommateurs et cela peut entraîner un comportement incorrect dans certains scénarios (par exemple, avec des sélecteurs de messages JMS ou avec des rubriques durables).

**Par défaut** : `true`

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

Indique si la connexion dans le réseau d'agents est utilisée pour produire *et* consommer des messages. Par exemple, si l'agent A crée une connexion avec l'agent B en mode non duplex, les messages peuvent être uniquement transférés de l'agent A vers l'agent B. Toutefois, si l'agent A crée une connexion en duplex vers l'agent B, l'agent B peut alors transférer des messages vers l'agent A sans avoir à configurer de `<networkConnector>`.

**Par défaut** : `false`

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

Le nom du pont dans le réseau d'agents.

**Par défaut** : `bridge`

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

Le point de terminaison de protocole de niveau filaire pour l'un des deux agents (ou pour plusieurs agents) dans un réseau d'agents.

**Par défaut** : `null`

#### nom d’utilisateur
<a name="username"></a>

Le nom d'utilisateur commun aux agents dans un réseau d'agents.

**Par défaut** : `null`

### Exemples de configuration
<a name="networkConnector-example"></a>

**Note**  
Lorsque vous utilisez un `networkConnector` pour définir un réseau d'agents, n'incluez pas le mot de passe pour l'utilisateur commun à vos agents.

#### Un réseau d'agents avec deux agents
<a name="example-network-of-brokers-two-brokers"></a>

Dans cette configuration, les deux agents sont connectés dans un réseau d'agents. Le nom du connecteur réseau est`connector_1_to_2`, le nom d'utilisateur commun aux courtiers est`myCommonUser`, la connexion est`duplex`, et l'URI du OpenWire point de terminaison est préfixé par`static:`, indiquant une one-to-one connexion entre les courtiers.

```
<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>
```

Pour de plus amples informations, veuillez consulter [Étape 2 : Configurer le réseau de connecteurs pour votre agent](amazon-mq-creating-configuring-network-of-brokers.md#creating-configuring-network-of-brokers-configure-network-connectors).

#### Un réseau d'agents avec plusieurs agents
<a name="example-network-of-brokers-multiple-brokers"></a>

Dans cette configuration, plusieurs agents sont connectés dans un réseau d'agents. Le nom du connecteur réseau est`connector_1_to_2`, le nom d'utilisateur commun aux courtiers est`myCommonUser`, la connexion est`duplex`, et la liste des points de OpenWire terminaison séparés par des virgules URIs est préfixée par`masterslave:`, indiquant une connexion de basculement entre les courtiers. Le basculement d'un agent à un autre n'est pas aléatoire et les tentatives de reconnexion continuent indéfiniment.

```
<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>
```

**Note**  
Nous vous recommandons d'utiliser le préfixe `masterslave:` pour le réseau d'agents. Le préfixe est identique à la syntaxe `static:failover:()?randomize=false&maxReconnectAttempts=0` plus explicite.

**Note**  
Cette configuration XML n'autorise pas les espaces.

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

`kahaDB` est un enfant de la collection d'élément enfant `persistenceAdapter`.

### Attributes
<a name="kahaDB-attributes"></a>

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

Indique s'il convient d'utiliser la répartition et le stockage simultanés pour les files d'attente. Pour de plus amples informations, veuillez consulter [Désactiver Concurrent Store and Dispatch (Répartition et stockage simultanés) pour les files d'attente à consommateurs lents](best-practices-activemq.md#disable-concurrent-store-and-dispatch-queues-flag-slow-consumers).

**Par défaut** : `true`

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

**Pris en charge dans**  
Apache ActiveMQ 15.16.x et versions ultérieures

Si elle est désactivée, le récupérateur de mémoire et le nettoyage n'ont pas lieu lorsque l'agent est arrêté, ce qui accélère le processus d'arrêt. La vitesse accrue est utile dans les cas avec des bases de données volumineuses ou des bases de données de planificateur.

**Par défaut** : `true`

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

Intervalle (ms) indiquant quand effectuer une synchronisation de disque si `journalDiskSyncStrategy=periodic`. Pour de plus amples informations, veuillez consulter la [documentation Apache ActiveMQ KahadB](https://activemq.apache.org/kahadb).

**Par défaut** : `1000`

#### journalDiskSyncStratégie
<a name="journalDiskSyncStrategy"></a>

**Pris en charge dans**  
Apache ActiveMQ 15.14.x et versions ultérieures

Configure la politique de synchronisation du disque. Pour de plus amples informations, veuillez consulter la [documentation Apache ActiveMQ KahadB](https://activemq.apache.org/kahadb).

**Par défaut** : `always`

**Note**  
La [documentation ActiveMQ](https://activemq.apache.org/kahadb) indique que la perte de données est limitée à la durée de `journalDiskSyncInterval`, qui a une valeur par défaut de 1 s. La perte de données peut être plus longue que l'intervalle, mais il est difficile d'être précis. Soyez prudent. 

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

Configure la façon dont l'agent va essayer de préallouer les fichiers journaux lorsqu'un nouveau fichier journal est nécessaire. Pour de plus amples informations, veuillez consulter la [documentation Apache ActiveMQ KahadB](https://activemq.apache.org/kahadb).

**Par défaut** : `sparse_file`

### Exemple de configuration
<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` est un enfant de la collection d'élément enfant `systemUsage`. Il contrôle la quantité maximale d'espace que l'agent utilisera avant de ralentir les producteurs. Pour de plus amples informations, veuillez consulter [Producer Flow Control](http://activemq.apache.org/producer-flow-control.html) dans la documentation Apache ActiveMQ. 

### Élément enfant
<a name="systemUsage-child"></a>

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

 `memoryUsage` est un enfant de l'élément enfant `systemUsage`. Il gère l'utilisation de la mémoire. Utilisez `memoryUsage` pour conserver une trace de la quantité d'utilisation d'un élément afin que vous puissiez contrôler efficacement l'utilisation de l'ensemble de travail. Pour de plus amples informations, veuillez consulter [le schéma](http://activemq.apache.org/schema/core/activemq-core-5.15.12-schema.html) dans la documentation ActiveMQ Apache.

##### Élément enfant
<a name="memoryUsage-child"></a>

 `memoryUsage` est un enfant de l'élément enfant `memoryUsage`. 

##### Attribut
<a name="memeoryUsage-attribute"></a>

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

Entier compris entre 0 (inclus) et 70 (inclus).

*Par défaut* : `70` 

### Attributes
<a name="systemUsage-attributes"></a>

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

Définit si une méthode `send()` doit échouer s'il n'y a pas d'espace libre. La valeur par défaut est false, ce qui bloque la méthode `send()` jusqu'à ce qu'il y ait de l'espace disponible. Pour de plus amples informations, veuillez consulter le [schéma](http://activemq.apache.org/schema/core/activemq-core-5.15.12-schema.html) dans la documentation Apache Active MQ.

**Par défaut** : `false`

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

**Par défaut** : `null`

#### Exemple de configuration
<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>
```