Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Configurazioni del broker Amazon MQ per ActiveMQ
<a name="amazon-mq-broker-configuration-parameters"></a>

 Una configurazione contiene tutte le impostazioni per il broker ActiveMQ nel formato XML (simile al file `activemq.xml` di ActiveMQ). È possibile creare una configurazione prima di creare qualsiasi broker. È quindi possibile applicare la configurazione a uno o più broker. 

**Importante**  
Apportare modifiche a una configurazione *non* applica le modifiche al broker in modo istantaneo. Per applicare le modifiche, attendere la finestra di manutenzione successiva o [riavviare il broker](amazon-mq-rebooting-broker.md).  
È possibile **eliminare** una configurazione solo utilizzando l'`DeleteConfiguration`API. Per ulteriori informazioni, consulta [Configurazioni](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/configurations-configuration-id.html) nell'*Amazon MQ API Reference.*

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

Una configurazione del broker dispone di diversi attributi, ad esempio:
+ un nome (`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`)

Per un elenco completo di attributi della configurazione, consultare le sezioni seguenti in *Riferimento all'API REST di Amazon MQ*:
+ [ID operazione REST: configurazione](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configuration.html)
+ [ID operazione REST: configurazioni](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configurations.html)

Per un elenco completo degli attributi di revisione, consulta le sezioni seguenti:
+ [ID operazione REST: revisione configurazione](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configuration-revision.html)
+ [ID operazione REST: revisioni configurazione](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-configuration-revisions.html)

## Utilizzo dei file di configurazione Spring XML
<a name="working-with-spring-xml-configuration-files"></a>

I broker ActiveMQ sono configurati utilizzando file [Spring XML](https://docs.spring.io/spring/docs/current/spring-framework-reference/). Puoi configurare molti aspetti del broker ActiveMQ, ad esempio destinazioni predefinite, policy di destinazione, policy di autorizzazione e plugin. Amazon MQ controlla alcuni di questi elementi di configurazione, ad esempio trasporti di rete e archiviazione. Altre opzioni di configurazione, ad esempio la creazione di reti di broker, non sono attualmente supportate.

Il set completo di opzioni di configurazione supportate è specificato negli schemi XML Amazon MQ. Scaricare i file zip degli schemi supportati utilizzando i seguenti collegamenti.
+ [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) 

È possibile utilizzare questi schemi per convalidare e sterilizzare i file di configurazione. Amazon MQ consente inoltre di fornire configurazioni caricando file XML. Quando carichi un file XML, Amazon MQ sterilizza e rimuove automaticamente parametri di configurazione non validi e non consentiti in base allo schema.

**Nota**  
Puoi usare solo valori statici per gli attributi. Amazon MQ sterilizza elementi e attributi che contengono espressioni, variabili e riferimenti a elementi Spring dalla configurazione.

# Creazione di una configurazione del broker Amazon MQ per ActiveMQ
<a name="amazon-mq-creating-applying-configurations"></a>

Una *configurazione* contiene tutte le impostazioni per il broker ActiveMQ nel formato XML (simile al file `activemq.xml` di ActiveMQ). È possibile creare una configurazione prima di creare qualsiasi broker. È quindi possibile applicare la configurazione a uno o più broker È possibile applicare una configurazione immediatamente o durante una *finestra di manutenzione*.

L'esempio seguente mostra come è possibile creare e applicare una configurazione del broker Amazon MQ utilizzando la Console di gestione AWS.

**Importante**  
È possibile **eliminare** una configurazione solo utilizzando l'`DeleteConfiguration`API. Per ulteriori informazioni, consulta [Configurazioni](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/configurations-configuration-id.html) nell'*Amazon MQ API Reference.*

## Creazione di una nuova configurazione
<a name="creating-configuration-from-scratch-console"></a>

Per creare una nuova configurazione del broker, crea prima la nuova configurazione.

1. Accedere alla [console Amazon MQ](https://console.aws.amazon.com/amazon-mq/).

1. Nel riquadro a sinistra, espandere il pannello di navigazione e scegliere **Configurations (Configurazioni)**.  
![\[Amazon MQ navigation panel showing Brokers and Configurations options.\]](http://docs.aws.amazon.com/it_it/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-create-configuration.png)

1. Nella pagina **Configurations (Configurazioni)**, scegliere **Create configuration (Crea configurazione)**.

1. Nella pagina **Create configuration (Crea configurazione)**, nella sezione **Details (Dettagli)**, digitare il nome in **Configuration name (Nome configurazione)** (ad esempio, `MyConfiguration`) e selezionare una versione **Broker engine (Motore del broker)**.
**Nota**  
Per ulteriori informazioni sulle versioni del motore ActiveMQ supportate da Amazon MQ per ActiveMQ, consultare [Gestione di Amazon MQ per le versioni del motore ActiveMQ](activemq-version-management.md).

1. Scegli **Crea configurazione**.

## Creazione di una nuova revisione di configurazione
<a name="creating-new-configuration-revision-console"></a>

Dopo aver creato una configurazione del broker, dovrai modificare la configurazione utilizzando una revisione della configurazione.

1. Dall'elenco di configurazione, scegli ***MyConfiguration***.
**Nota**  
La prima revisione di configurazione viene sempre creata automaticamente quando Amazon MQ crea la configurazione.

   ***MyConfiguration***Nella pagina vengono visualizzati il tipo di motore del broker e la versione utilizzati dalla nuova revisione della configurazione (ad esempio, **Apache ActiveMQ 5.15.16**).

1. Nella scheda **Configuration details** (Dettagli configurazione) vengono visualizzati il numero di revisione della configurazione, la descrizione e la configurazione del broker in formato XML.
**Nota**  
La modifica della configurazione corrente crea una nuova revisione della configurazione.  
![\[XML configuration snippet for ActiveMQ broker with explanatory comment.\]](http://docs.aws.amazon.com/it_it/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-edit-configuration.png)

1. Scegliere **Edit configuration** (Modifica configurazione) e apportare modifiche alla configurazione XML.

1. Scegli **Save** (Salva).

   Viene visualizzata la finestra di dialogo **Save revision** (Salva revisione).

1. (Opzionale) Digitare `A description of the changes in this revision`.

1. Scegli **Save** (Salva).

   La nuova revisione della configurazione viene salvata.
**Importante**  
La console Amazon MQ sterilizza automaticamente parametri di configurazione non validi e non consentiti in base a uno schema. Per ulteriori informazioni e un elenco completo dei parametri XML consentiti, consultare [Configurazioni del broker Amazon MQ per ActiveMQ](amazon-mq-broker-configuration-parameters.md).

## Applicazione di una revisione di configurazione al broker
<a name="apply-configuration-revision-creating-console"></a>

Dopo aver modificato la configurazione, puoi applicare la revisione della configurazione al tuo broker.

1. Nel riquadro a sinistra, espandere il pannello di navigazione e scegliere **Brokers (Broker)**.  
![\[Amazon MQ navigation panel showing Brokers and Configurations options.\]](http://docs.aws.amazon.com/it_it/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-apply-configuration.png)

1. **Dall'elenco dei broker, seleziona il tuo broker (ad esempio **MyBroker**), quindi scegli Modifica.**

1. Nella *MyBroker* pagina **Modifica**, nella sezione **Configurazione**, seleziona una **configurazione** e una **revisione**, quindi scegli **Pianifica modifiche**.

1. Nella sezione **Schedule broker modifications** (Pianifica modifiche broker) seleziona se applicare le modifiche **During the next scheduled maintenance window** (Nel corso della finestra di manutenzione pianificata successiva) oppure **Immediately** (Immediatamente).
**Importante**  
I broker a istanza singola sono offline durante il riavvio. Per i broker di cluster, durante il riavvio del broker viene interrotto solo un nodo alla volta.

1. Scegli **Applica**.

   La revisione della configurazione viene applicata al tuo broker nel momento specificato.

# Modifica di una revisione della configurazione di Amazon MQ for ActiveMQ
<a name="edit-current-configuration-console"></a>

Potresti voler modificare una revisione della configurazione dopo averla applicata al tuo broker. Utilizza le seguenti istruzioni per modificare una revisione della configurazione.

1. Accedere alla [console Amazon MQ](https://console.aws.amazon.com/amazon-mq/).

1. Dall'elenco dei broker, seleziona il tuo broker (ad esempio **MyBroker**), quindi scegli **Modifica**.

1. Nella ***MyBroker***pagina, scegli **Modifica**.

1. Nella *MyBroker* pagina **Modifica**, nella sezione **Configurazione**, seleziona una **configurazione** e una **revisione**, quindi scegli **Modifica**.
**Nota**  
A meno che non si selezioni una configurazione durante la creazione di un broker, la prima revisione della configurazione viene sempre creata quando Amazon MQ crea il broker.

   ***MyBroker***Nella pagina vengono visualizzati il tipo e la versione del motore del broker utilizzati dalla configurazione (ad esempio, **Apache ActiveMQ 5.15.8**).

1. Nella scheda **Configuration details** (Dettagli configurazione) vengono visualizzati il numero di revisione della configurazione, la descrizione e la configurazione del broker in formato XML.
**Nota**  
La modifica della configurazione corrente crea una nuova revisione della configurazione.  
![\[XML configuration snippet for ActiveMQ broker with explanatory comment.\]](http://docs.aws.amazon.com/it_it/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-edit-configuration.png)

1. Scegliere **Edit configuration** (Modifica configurazione) e apportare modifiche alla configurazione XML.

1. Scegli **Save** (Salva).

   Viene visualizzata la finestra di dialogo **Save revision** (Salva revisione).

1. (Opzionale) Digitare `A description of the changes in this revision`.

1. Scegli **Save** (Salva).

   La nuova revisione della configurazione viene salvata.
**Importante**  
La console Amazon MQ sterilizza automaticamente parametri di configurazione non validi e non consentiti in base a uno schema. Per ulteriori informazioni e un elenco completo dei parametri XML consentiti, consultare [Configurazioni del broker Amazon MQ per ActiveMQ](amazon-mq-broker-configuration-parameters.md).

# Elementi consentiti nelle configurazioni Amazon MQ
<a name="permitted-elements"></a>

Di seguito è riportato un elenco dettagliato degli elementi consentiti in configurazioni Amazon MQ. Per ulteriori informazioni, consulta [XML Configuration](http://activemq.apache.org/xml-configuration.html) nella documentazione di Apache ActiveMQ.


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

# Elementi e relativi attributi consentiti nelle configurazioni Amazon MQ
<a name="permitted-attributes"></a>

Di seguito è riportato un elenco dettagliato degli elementi e dei relativi attributi consentiti nelle configurazioni Amazon MQ. Per ulteriori informazioni, consulta [XML Configuration](http://activemq.apache.org/xml-configuration.html) nella documentazione di Apache ActiveMQ.

Utilizzare le barre di scorrimento per visualizzare il resto della tabella.

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

## Attributi elemento padre Amazon MQ
<a name="parent-element-details"></a>

Di seguito è riportata una descrizione dettagliata degli attributi dell'elemento padre. Per ulteriori informazioni, consulta [XML Configuration](http://activemq.apache.org/xml-configuration.html) nella documentazione di Apache ActiveMQ.

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

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

`broker` è un elemento di raccolta padre. 

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

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

Per ridurre la latenza di rete e per consentire ad altre reti di avviarsi in modo tempestivo, utilizza il tag `<networkConnectionStartAsync>`. Il tag indica al broker di utilizzare un esecutore per avviare le connessioni di rete in parallelo, asincrone a un avvio di broker.

**Default**: `false`

#### Configurazione di esempio
<a name="networkConnectorStartAsync"></a>

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

# Elementi, elementi della raccolta figlio e relativi elementi figlio consentiti nelle configurazioni Amazon MQ
<a name="permitted-collections"></a>

Di seguito è riportato un elenco dettagliato degli elementi, degli elementi della raccolta figlio e dei relativi elementi figlio consentiti nelle configurazioni Amazon MQ. Per ulteriori informazioni, consulta [XML Configuration](http://activemq.apache.org/xml-configuration.html) nella documentazione di Apache ActiveMQ.

Utilizzare le barre di scorrimento per visualizzare il resto della tabella.

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

# Attributi elemento figlio Amazon MQ
<a name="child-element-details"></a>

Di seguito è riportata una descrizione dettagliata degli attributi elemento figlio. Per ulteriori informazioni, consulta [XML Configuration](http://activemq.apache.org/xml-configuration.html) nella documentazione di Apache ActiveMQ.

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

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

`authorizationEntry` è un figlio dell'elemento raccolta figlio `authorizationEntries`.

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

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

Le autorizzazioni concesse a un gruppo di utenti. Per ulteriori informazioni, consulta [Configurare sempre una mappa di autorizzazione](using-amazon-mq-securely.md#always-configure-authorization-map).

Se si specifica una mappa di autorizzazione che non include il gruppo `activemq-webconsole`, non è possibile utilizzare la console Web ActiveMQ perché il gruppo non è autorizzato a inviare o ricevere messaggi dal broker Amazon MQ.

**Default**: `null`

### Configurazione di esempio
<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**  
 Il `activemq-webconsole` gruppo in ActiveMQ su Amazon MQ dispone delle autorizzazioni di amministratore per tutte le code e gli argomenti. Tutti gli utenti di questo gruppo avranno accesso come amministratore. 

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

`networkConnector` è un figlio dell'elemento raccolta figlio `networkConnectors`.

**Topics**
+ [Attributes](#networkConnector-attributes)
+ [Configurazioni di esempio](#networkConnector-example)

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

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

Specifica se una connessione di rete in una rete di broker considera più consumatori sottoscritti alla stessa destinazione come un singolo consumatore. Ad esempio, se `conduitSubscriptions` è impostato su `true` e due consumatori si connettono al broker B e consumano da una destinazione, il broker B combina le sottoscrizioni in una singola sottoscrizione logica per la connessione di rete al broker A, in modo che solo una singola copia di un messaggio viene inoltrata dal broker A al broker B. 

**Nota**  
Impostare `conduitSubscriptions` su `true` può ridurre il traffico di rete ridondante. Tuttavia, utilizzare questo attributo può avere implicazioni per il bilanciamento del carico di messaggi tra i consumatori e potrebbe causare un comportamento errato in alcune situazioni (ad esempio con selettori di messaggi JMS o con argomenti durevoli).

**Default**: `true`

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

Specifica se la connessione nella rete di broker è utilizzata per generare *e* consumare i messaggi. Ad esempio, se il broker A crea una connessione al broker B in modalità non-duplex, i messaggi possono essere inoltrati solo dal broker A al broker B. Tuttavia, se il broker A crea una connessione duplex verso il broker B, allora il broker B è in grado di inoltrare messaggi al broker A senza dover configurare un `<networkConnector>`.

**Default**: `false`

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

Il nome del bridge nella rete di broker.

**Default**: `bridge`

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

L'endpoint con protocollo a livello di collegamento per uno dei due (o più) broker in una rete di broker.

**Default**: `null`

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

Il nome utente comune ai broker in una rete di broker.

**Default**: `null`

### Configurazioni di esempio
<a name="networkConnector-example"></a>

**Nota**  
Quando utilizzi un `networkConnector` per definire una rete di broker, non includere la password dell'utente comune ai broker.

#### Una rete di broker con due broker
<a name="example-network-of-brokers-two-brokers"></a>

In questa configurazione, due broker sono connessi in una rete di broker. Il nome del connettore di rete è`connector_1_to_2`, il nome utente comune ai broker è`myCommonUser`, la connessione è`duplex`, e l'URI dell' OpenWire endpoint è preceduto da`static:`, indica una one-to-one connessione tra i broker.

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

Per ulteriori informazioni, consulta [Fase 2: configura i connettori di rete per il broker](amazon-mq-creating-configuring-network-of-brokers.md#creating-configuring-network-of-brokers-configure-network-connectors).

#### Una rete di broker con più broker
<a name="example-network-of-brokers-multiple-brokers"></a>

In questa configurazione, broker multipli sono connessi in una rete di broker. Il nome del connettore di rete è`connector_1_to_2`, il nome utente comune ai broker è, la connessione è`myCommonUser`, e l'elenco degli OpenWire endpoint separati da virgole URIs è preceduto da`duplex`, che indica una connessione di failover tra i broker. `masterslave:` Il failover da broker a broker non è randomizzato e i tentativi di riconnessione continuano a tempo indeterminato.

```
<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**  
Ti consigliamo di usare il prefisso `masterslave:` per reti di broker. Il prefisso è identico alla sintassi `static:failover:()?randomize=false&maxReconnectAttempts=0` più esplicita.

**Nota**  
Questa configurazione XML non consente spazi.

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

`kahaDB` è un figlio dell'elemento raccolta figlio `persistenceAdapter`.

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

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

Specifica se utilizzare archiviazione e invio simultanei per le code. Per ulteriori informazioni, consulta [Disabilita archiviazione e invio simultaneo per code con consumatori lenti](best-practices-activemq.md#disable-concurrent-store-and-dispatch-queues-flag-slow-consumers).

**Default**: `true`

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

**Supportato in**  
Apache ActiveMQ 15.16.x e versioni successive

Se disattivato, la garbage collection (GC) e la pulizia non hanno luogo quando il broker viene terminato, il che accelera il processo di arresto. La maggiore velocità è utile nei casi con database di grandi dimensioni o database del pianificatore.

**Default**: `true`

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

Intervallo (ms) per quando eseguire una sincronizzazione del disco se `journalDiskSyncStrategy=periodic`. Per ulteriori informazioni, vedere la [documentazione di Apache ActiveMQ KahaDB](https://activemq.apache.org/kahadb).

**Default**: `1000`

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

**Supportato in**  
Apache ActiveMQ 15.14.x e versioni successive

Configura la policy di sincronizzazione del disco. Per ulteriori informazioni, vedere la [documentazione di Apache ActiveMQ KahaDB](https://activemq.apache.org/kahadb).

**Default**: `always`

**Nota**  
La [documentazione di ActiveMQ](https://activemq.apache.org/kahadb) indica che la perdita di dati è limitata alla durata di `journalDiskSyncInterval`, che ha un valore predefinito di 1s. La perdita di dati può essere più lunga dell'intervallo, ma è difficile essere precisi. Prestare attenzione. 

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

Configura il modo in cui il broker tenterà di preallocare i file journal quando è necessario un nuovo file journal. Per ulteriori informazioni, vedere la [documentazione di Apache ActiveMQ KahaDB](https://activemq.apache.org/kahadb).

**Default**: `sparse_file`

### Configurazione di esempio
<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` è un figlio dell'elemento raccolta figlio `systemUsage`. Controlla la quantità massima di spazio che il broker utilizzerà prima di rallentare i produttori. Per ulteriori informazioni, vedere [Producer Flow Control](http://activemq.apache.org/producer-flow-control.html) nella documentazione di Apache ActiveMQ. 

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

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

 `memoryUsage` è un figlio dell'elemento `systemUsage` figlio. Gestisce l'utilizzo della memoria. Utilizzare `memoryUsage` per tenere traccia di quanto di qualcosa viene utilizzato in modo da poter controllare l'utilizzo del working set in modo produttivo. Per ulteriori informazioni, consulta lo [schema](http://activemq.apache.org/schema/core/activemq-core-5.15.12-schema.html) nella documentazione di Apache ActiveMQ.

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

 `memoryUsage` è un figlio dell'elemento `memoryUsage` figlio. 

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

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

Numero intero compreso tra 0 (incluso) e 70 (incluso).

*Default*: `70` 

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

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

Imposta se un metodo `send()` deve fallire se non c'è spazio libero. Il valore predefinito è false, che blocca il metodo `send()` fino a quando lo spazio non diventa disponibile. Per ulteriori informazioni, vedere lo [schema](http://activemq.apache.org/schema/core/activemq-core-5.15.12-schema.html) nella documentazione di Apache Active MQ.

**Default**: `false`

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

**Default**: `null`

#### Configurazione di esempio
<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>
```