Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Configuraciones del agente de Amazon MQ para ActiveMQ
<a name="amazon-mq-broker-configuration-parameters"></a>

 Una configuración contiene todos los ajustes del agente de ActiveMQ en formato XML (similar al archivo `activemq.xml` de ActiveMQ). Puede crear una configuración antes de crear los agente. Luego, puede aplicar la configuración a uno o más agentes. 

**importante**  
Si realiza cambios en una configuración, los cambios *no* se aplican al agente de inmediato. Para aplicar los cambios, debe espere al próximo periodo de mantenimiento o [reiniciar el agente](amazon-mq-rebooting-broker.md).  
Solo puede **eliminar** una configuración mediante la API `DeleteConfiguration`. Para obtener más información, consulte [Configuraciones](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/configurations-configuration-id.html) en la *Referencia de la API de Amazon MQ*.

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

La configuración de un agente tiene varios atributos, por ejemplo:
+ Un nombre (`MyConfiguration`)
+ Un ID (`c-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`)
+ Un Nombre de recurso de Amazon (ARN) (`arn:aws:mq:us-east-2:123456789012:configuration:c-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`)

Para ver una lista completa de los atributos de configuración, consulte lo siguiente en la *Referencia de la API REST de Amazon MQ*:
+ [ID de operación de REST: Configuration](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configuration.html)
+ [ID de operación de REST: Configurations](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configurations.html)

Para ver una lista completa de los atributos de revisión de la configuración, consulte lo siguiente:
+ [ID de operación de REST: Configuration Revision](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configuration-revision.html)
+ [ID de operación de REST: Configuration Revisions](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configuration-revisions.html)

## Uso de archivos de configuración XML Spring
<a name="working-with-spring-xml-configuration-files"></a>

Para configurar los agentes de ActiveMQ se usan archivos [XML Spring](https://docs.spring.io/spring/docs/current/spring-framework-reference/). Pueden configurarse diversos aspectos del agente de ActiveMQ, como los destinos predefinidos, las políticas de destino, las políticas de autorización y los complementos. Amazon MQ controla alguno de estos elementos de configuración, como el almacenamiento y el transporte de red. Otras opciones de configuración, como la creación de redes de agentes, no se admiten actualmente.

El conjunto completo de las opciones de configuración admitidas se especifica en los esquemas XML de Amazon MQ. Para descargar los archivos zip de los esquemas admitidos, utilice los siguientes enlaces.
+ [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) 

Puede usar estos esquemas para validar y sanear los archivos de configuración. Con Amazon MQ también puede cargar archivos XML para proporcionar configuraciones. Cuando se carga un archivo XML, Amazon MQ lo limpia de forma automática y elimina los parámetros de configuración no válidos y prohibidos según el esquema.

**nota**  
Para los atributos, solo se pueden usar valores estáticos. Amazon MQ elimina de la configuración los elementos y los atributos que contienen referencias a elementos, variables y expresiones de Spring.

# Creación de una configuración del agente de Amazon MQ para ActiveMQ
<a name="amazon-mq-creating-applying-configurations"></a>

Una *configuración* contiene todos los ajustes del agente de ActiveMQ en formato XML (similar al archivo `activemq.xml` de ActiveMQ). Puede crear una configuración antes de crear los agente. Luego, puede aplicar la configuración a uno o más agentes. Puede aplicar una configuración inmediatamente o durante un *período de mantenimiento*.

En el ejemplo siguiente, se muestra cómo crear y aplicar la configuración de un agente de Amazon MQ mediante la Consola de administración de AWS.

**importante**  
Solo puede **eliminar** una configuración mediante la API `DeleteConfiguration`. Para obtener más información, consulte [Configuraciones](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/configurations-configuration-id.html) en la *Referencia de la API de Amazon MQ*.

## Crear una nueva configuración
<a name="creating-configuration-from-scratch-console"></a>

Para crear una nueva configuración de un agente, cree primero la nueva configuración.

1. Inicie sesión en la [consola de Amazon MQ](https://console.aws.amazon.com/amazon-mq/).

1. En el lado izquierdo, expanda el panel de navegación y elija **Configurations (Configuraciones)**.  
![\[Amazon MQ navigation panel showing Brokers and Configurations options.\]](http://docs.aws.amazon.com/es_es/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-create-configuration.png)

1. En la página **Configurations (Configuraciones)**, seleccione **Create configuration (Crear configuración)**.

1. En la página **Create configuration** (Crear configuración), en la sección **Details** (Detalles), escriba el nombre de la configuración en **Configuration name** (Nombre de configuración) (por ejemplo, `MyConfiguration`) y seleccione una versión del motor del agente en **Broker engine** (Motor del agente).
**nota**  
Para obtener más información acerca de las versiones de motor de ActiveMQ compatibles con Amazon MQ para ActiveMQ, consulte [Administración de versiones del motor de Amazon MQ para ActiveMQ](activemq-version-management.md).

1. Seleccione **Crear configuración**.

## Crear una revisión de configuración nueva
<a name="creating-new-configuration-revision-console"></a>

Tras crear una configuración de un agente, tendrá que editarla mediante una revisión de la configuración.

1. En la lista de configuraciones, elija ***MyConfiguration***.
**nota**  
La primera revisión de la configuración siempre se genera automáticamente cuando Amazon MQ crea la configuración.

   En la ***MyConfiguration***página, se muestran el tipo y la versión del motor de broker que utiliza la nueva revisión de configuración (por ejemplo, **Apache ActiveMQ** 5.15.16).

1. En la pestaña **Configuration details**, se muestra el número de revisión de la configuración, la descripción y la configuración del agente en formato XML.
**nota**  
Cuando se edita la configuración actual, se crea una nueva revisión de configuración.  
![\[XML configuration snippet for ActiveMQ broker with explanatory comment.\]](http://docs.aws.amazon.com/es_es/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-edit-configuration.png)

1. Elija **Edit configuration** (Editar configuración) y realice cambios en la configuración XML.

1. Seleccione **Save**.

   Se muestra el cuadro de diálogo **Save revision** (Guardar revisión).

1. (Opcional) Escriba `A description of the changes in this revision`.

1. Seleccione **Save**.

   De este modo, guardará la nueva revisión de la configuración.
**importante**  
La consola de Amazon MQ elimina automáticamente los parámetros de configuración no válidos y prohibidos de acuerdo con un esquema. Para obtener más información y una lista completa de los parámetros XML permitidos, consulte [Configuraciones del agente de Amazon MQ para ActiveMQ](amazon-mq-broker-configuration-parameters.md).

## Aplicar una revisión de configuración al agente
<a name="apply-configuration-revision-creating-console"></a>

Tras revisar la configuración, puede aplicarla a su agente.

1. En el lado izquierdo, expanda el panel de navegación y elija **Brokers (Agentes)**.  
![\[Amazon MQ navigation panel showing Brokers and Configurations options.\]](http://docs.aws.amazon.com/es_es/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-apply-configuration.png)

1. **En la lista de corredores, seleccione su corredor (por ejemplo **MyBroker**) y, a continuación, elija Editar.**

1. En la *MyBroker* página de **edición**, en la sección **Configuración**, seleccione una **configuración** y una **revisión** y, a continuación, elija **Programar modificaciones**.

1. En la sección **Schedule broker modifications (Programar modificaciones del agente)**, elija **During the next scheduled maintenance window (Durante el siguiente periodo de mantenimiento programado)** si desea aplicar las modificaciones durante el siguiente periodo de mantenimiento programado o **Immediately (Inmediatamente)** si desea aplicarlas inmediatamente.
**importante**  
Los agentes de instancia única están desconectados mientras se reinician. En el caso de los agentes de clústeres, solo un nodo está inactivo a la vez mientras el agente se reinicia.

1. Seleccione **Aplicar**.

   La revisión de la configuración se aplicará al broker en el momento especificado.

# Edición de una revisión de configuración de Amazon MQ para ActiveMQ
<a name="edit-current-configuration-console"></a>

Puede que desee editar una revisión de configuración después de aplicarla a su agente. Utilice las siguientes instrucciones para editar una revisión de configuración.

1. Inicie sesión en la [consola de Amazon MQ](https://console.aws.amazon.com/amazon-mq/).

1. En la lista de corredores, seleccione su corredor (por ejemplo **MyBroker**) y, a continuación, elija **Editar**.

1. En la ***MyBroker***página, elija **Editar**.

1. En la *MyBroker* página de **edición**, en la sección **Configuración**, seleccione una **configuración** y una **revisión** y, a continuación, elija **Editar**.
**nota**  
A menos que seleccione una configuración cuando crea un agente, la primera revisión de la configuración siempre se crea automáticamente cuando Amazon MQ crea el agente.

   En la ***MyBroker***página, se muestran el tipo y la versión del motor de broker que utiliza la configuración (por ejemplo, **Apache ActiveMQ** 5.15.8).

1. En la pestaña **Configuration details**, se muestra el número de revisión de la configuración, la descripción y la configuración del agente en formato XML.
**nota**  
Cuando se edita la configuración actual, se crea una nueva revisión de configuración.  
![\[XML configuration snippet for ActiveMQ broker with explanatory comment.\]](http://docs.aws.amazon.com/es_es/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-edit-configuration.png)

1. Elija **Edit configuration** (Editar configuración) y realice cambios en la configuración XML.

1. Seleccione **Save**.

   Se muestra el cuadro de diálogo **Save revision** (Guardar revisión).

1. (Opcional) Escriba `A description of the changes in this revision`.

1. Seleccione **Save**.

   De este modo, guardará la nueva revisión de la configuración.
**importante**  
La consola de Amazon MQ elimina automáticamente los parámetros de configuración no válidos y prohibidos de acuerdo con un esquema. Para obtener más información y una lista completa de los parámetros XML permitidos, consulte [Configuraciones del agente de Amazon MQ para ActiveMQ](amazon-mq-broker-configuration-parameters.md).

# Elementos permitidos en las configuraciones de Amazon MQ
<a name="permitted-elements"></a>

A continuación, se muestra una lista detallada de los elementos permitidos en las configuraciones de Amazon MQ. Para obtener más información, consulte el tema sobre la [configuración de XML](http://activemq.apache.org/xml-configuration.html) en la documentación de Apache ActiveMQ.


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

# Elementos y sus atributos permitidos en las configuraciones de Amazon MQ
<a name="permitted-attributes"></a>

A continuación, se muestra una lista detallada de los elementos y sus atributos permitidos en las configuraciones de Amazon MQ. Para obtener más información, consulte el tema sobre la [configuración de XML](http://activemq.apache.org/xml-configuration.html) en la documentación de Apache ActiveMQ.

Utilice las barras de desplazamiento para ver el resto de la tabla.

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

## Atributos de elemento principales de Amazon MQ
<a name="parent-element-details"></a>

A continuación se ofrece una explicación detallada de los atributos de elemento principales. Para obtener más información, consulte el tema sobre la [configuración de XML](http://activemq.apache.org/xml-configuration.html) en la documentación de Apache ActiveMQ.

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

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

`broker` es un elemento de colección principal. 

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

##### networkConnectionStartAsincrónico
<a name="networkConnectionStartAsync"></a>

Para mitigar la latencia de la red y permitir que otras redes se inicien de manera oportuna, utilice la etiqueta `<networkConnectionStartAsync>`. La etiqueta indica al agente que utilice un ejecutor para iniciar las conexiones de red en paralelo, de forma asincrónica a un inicio de agente.

**Valor predeterminado**: `false`

#### Configuración de ejemplo
<a name="networkConnectorStartAsync"></a>

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

# Elementos, elementos de colección secundarios y sus elementos secundarios permitidos en las configuraciones de Amazon MQ
<a name="permitted-collections"></a>

A continuación, se muestra una lista detallada de los elementos, los elementos de colección secundarios y sus elementos secundarios permitidos en las configuraciones de Amazon MQ. Para obtener más información, consulte el tema sobre la [configuración de XML](http://activemq.apache.org/xml-configuration.html) en la documentación de Apache ActiveMQ.

Utilice las barras de desplazamiento para ver el resto de la tabla.

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

# Atributos de elemento secundarios de Amazon MQ
<a name="child-element-details"></a>

A continuación se ofrece una explicación detallada de los atributos de elemento secundarios. Para obtener más información, consulte el tema sobre la [configuración de XML](http://activemq.apache.org/xml-configuration.html) en la documentación de Apache ActiveMQ.

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

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

`authorizationEntry` es un elemento secundario del elemento de colección secundario `authorizationEntries`.

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

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

Los permisos concedidos a un grupo de usuarios. Para obtener más información, consulte [Configurar siempre una asignación de autorizaciones](using-amazon-mq-securely.md#always-configure-authorization-map).

Si especifica un mapa de autorizaciones que no incluya al grupo `activemq-webconsole`, no puede utilizar la consola web de ActiveMQ porque el grupo no está autorizado a enviar mensajes al agente de Amazon MQ ni para recibir mensajes de este.

**Valor predeterminado**: `null`

### Configuración de ejemplo
<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>
```

**nota**  
 El grupo `activemq-webconsole` de ActiveMQ en Amazon MQ tiene permisos de administrador en todas las colas y temas. Todos los usuarios de este grupo tendrán acceso de administrador. 

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

`networkConnector` es un elemento secundario del elemento de colección secundario `networkConnectors`.

**Topics**
+ [Atributos](#networkConnector-attributes)
+ [Ejemplo de configuraciones](#networkConnector-example)

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

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

Especifica si una conexión de red en una red de agentes trata varios consumidores suscritos al mismo destino como un consumidor. Por ejemplo, si `conduitSubscriptions` se ha establecido en `true` y se conectan dos consumidores al agente B y consumen desde un destino, el agente B combina las suscripciones en una sola suscripción lógica a través de la conexión de red al agente A, de modo que solo se reenvía una única copia de un mensaje del agente A al agente B. 

**nota**  
Establecer `conduitSubscriptions` en `true` puede reducir el tráfico de red redundante. Sin embargo, el uso de este atributo puede tener implicaciones para el balanceo de carga de mensajes en los consumidores y podría causar un comportamiento incorrecto en ciertas situaciones (por ejemplo, con selectores de mensajes de JMS o con temas duraderos).

**Valor predeterminado**: `true`

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

Especifica si la conexión en la red de agentes se utiliza para producir *y* consumir mensajes. Por ejemplo, si un agente A crea una conexión al agente B en modo no dúplex, los mensajes pueden reenviarse solo desde el agente A al agente B. Sin embargo, si un agente A crea una conexión dúplex al agente B, entonces el agente B puede reenviar mensajes al agente A sin tener que configurar un `<networkConnector>`.

**Valor predeterminado**: `false`

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

El nombre del puente en la red de agentes.

**Valor predeterminado**: `bridge`

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

El punto de enlace de protocolo de nivel de conexión para uno de los dos agentes (o para varios agentes) en una red de agentes.

**Valor predeterminado**: `null`

#### nombre de usuario
<a name="username"></a>

El nombre de usuario común a los agentes en una red de agentes.

**Valor predeterminado**: `null`

### Ejemplo de configuraciones
<a name="networkConnector-example"></a>

**nota**  
Cuando se utiliza un `networkConnector` para definir una red de agentes, no incluya la contraseña para el usuario común a los agentes.

#### Una red de agentes con dos agentes
<a name="example-network-of-brokers-two-brokers"></a>

En esta configuración, dos agentes están conectados en una red de agentes. El nombre del conector de red es`connector_1_to_2`, el nombre de usuario común a los corredores es`myCommonUser`, la conexión es `duplex` y el URI del OpenWire punto final lleva el prefijo`static:`, lo que indica una one-to-one conexión entre los corredores.

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

Para obtener más información, consulte [Paso 2: Configurar conectores de red para su agente](amazon-mq-creating-configuring-network-of-brokers.md#creating-configuring-network-of-brokers-configure-network-connectors).

#### Una red de agentes con varios agentes
<a name="example-network-of-brokers-multiple-brokers"></a>

En esta configuración, varios agentes están conectados en una red de agentes. El nombre del conector de red es`connector_1_to_2`, el nombre de usuario común a los intermediarios`myCommonUser`, la conexión es y la lista de OpenWire terminales separados por comas lleva el prefijo `duplex``masterslave:`, lo que indica que URIs hay una conexión de conmutación por error entre los corredores. La conmutación por error de agente a agente no es aleatoria y los intentos de reconexión continúan indefinidamente.

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

**nota**  
Le recomendamos que utilice el prefijo `masterslave:` para las redes de agentes. El prefijo es idéntico a la sintaxis `static:failover:()?randomize=false&maxReconnectAttempts=0` más explícita.

**nota**  
Esta configuración de XML no permite espacios.

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

`kahaDB` es un elemento secundario del elemento de colección secundario `persistenceAdapter`.

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

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

Especifica si se debe usar almacenamiento y envío simultáneo para colas. Para obtener más información, consulte [Desactivar el almacenamiento y el envío simultáneos en colas con consumidores lentos](best-practices-activemq.md#disable-concurrent-store-and-dispatch-queues-flag-slow-consumers).

**Valor predeterminado**: `true`

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

**Compatible con**  
Apache ActiveMQ 15.16.x y versiones posteriores

Si se desactiva, la recolección de basura y la limpieza no se llevan a cabo cuando se suspende al agente, lo que acelera el proceso de apagado. El aumento de la velocidad es útil en casos de bases de datos grandes o de programadores.

**Valor predeterminado**: `true`

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

Intervalo (ms) para cuándo realizar una sincronización de disco si `journalDiskSyncStrategy=periodic`. Para obtener más información, consulte la [documentación de Apache ActiveMQ kahaDB](https://activemq.apache.org/kahadb).

**Valor predeterminado**: `1000`

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

**Compatible con**  
Apache ActiveMQ 15.14.x y versiones posteriores

Configura la política de sincronización de disco. Para obtener más información, consulte la [documentación de Apache ActiveMQ kahaDB](https://activemq.apache.org/kahadb).

**Valor predeterminado**: `always`

**nota**  
La [documentación de ActiveMQ](https://activemq.apache.org/kahadb) indica que la pérdida de datos está limitada a la duración de `journalDiskSyncInterval`, que tiene un valor predeterminado de 1 segundo. La pérdida de datos puede ser más larga que el intervalo, pero es difícil ser preciso. Sea precavido. 

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

Configura la forma en que el agente intentará preasignar los archivos de diario cuando se necesite un nuevo archivo de diario. Para obtener más información, consulte la [documentación de Apache ActiveMQ kahaDB](https://activemq.apache.org/kahadb).

**Valor predeterminado**: `sparse_file`

### Configuración de ejemplo
<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` es un elemento secundario del elemento de colección secundario `systemUsage`. Controla la cantidad máxima de espacio que usará el agente antes de ralentizar a los productores. Para obtener más información, consulte [Producer Flow Control (Control del flujo del productor)](http://activemq.apache.org/producer-flow-control.html) en la documentación de Apache ActiveMQ. 

### Elemento secundario
<a name="systemUsage-child"></a>

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

 `memoryUsage` es un elemento secundario del elemento secundario `systemUsage`. Gestiona el uso de la memoria. Use `memoryUsage` para realizar un seguimiento de cuánto se está utilizando un elemento para que pueda controlar el uso del conjunto de trabajo de manera productiva. Para obtener más información, consulte [el esquema](http://activemq.apache.org/schema/core/activemq-core-5.15.12-schema.html) de la documentación de Apache ActiveMQ.

##### Elemento secundario
<a name="memoryUsage-child"></a>

 `memoryUsage` es un elemento secundario del elemento secundario `memoryUsage`. 

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

##### percentOfJvmMontón
<a name="percentOfJvmHeap"></a>

Número entero entre 0 (inclusive) y 70 (inclusive).

*Valor predeterminado*: `70` 

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

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

Establece si un método `send()` debe fallar si no hay espacio libre. El valor predeterminado es false, lo que bloquea el método `send()` hasta que el espacio esté disponible. Para obtener más información, consulte el [esquema](http://activemq.apache.org/schema/core/activemq-core-5.15.12-schema.html) de la documentación de Apache Active MQ.

**Valor predeterminado**: `false`

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

**Valor predeterminado**: `null`

#### Configuración de ejemplo
<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>
```