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.

# Configuración de la persistencia del broker
<a name="configure-broker-persistence"></a>

Los brokers de Session Manager admiten la integración con bases de datos externas. La base de datos externa permite a Session Manager conservar los datos de estado y las claves para que estén disponibles posteriormente. De hecho, los datos del broker se distribuyen por todo el clúster, lo que los hace susceptibles a la pérdida de datos si un host necesita reiniciarse o si se termina un clúster. Con esta característica habilitada, puede añadir y eliminar nodos de broker. Además, puede detener un clúster y reiniciarlo sin necesidad de regenerar claves ni perder información sobre qué servidor Amazon DCV está abierto o cerrado.

Se pueden configurar los siguientes tipos de información para que persistan:
+ Claves para configurar las sesiones a fin de establecer conexión con los clientes
+ Datos de las sesiones activas
+ Estado del servidor Amazon DCV

Amazon DCV Session Manager es compatible con bases de datos DynamoDB, MariaDB y MySQL. Debe configurar y administrar una de estas bases de datos para utilizar esta característica. Si sus máquinas de broker están alojadas en Amazon EC2, le recomendamos que utilice DynamoDB como base de datos externa, ya que no requiere configuración adicional.

**nota**  
Puede incurrir en costos adicionales al ejecutar una base de datos externa. Para obtener información sobre precios de DynamoDB, consulte [Precios de la capacidad aprovisionada](https://aws.amazon.com/dynamodb/pricing/provisioned/).

## Configurar el broker para que persista en DynamoDB
<a name="persistence-dynamodb"></a>

Configure los brokers para que comiencen a almacenar sus datos en DynamoDB:

1. Abra `/etc/dcv-session-manager-broker/session-manager-broker.properties` con su editor de texto preferido y haga lo siguiente:
   + Configurar `enable-persistence = true`
   + Configurar `persistence-db = dynamodb`
   + Para `dynamodb-region` especificar la región de &aws; en la que desea almacenar las tablas que contienen los datos del broker. Para ver una lista de las regiones admitidas, consulte [Puntos de conexión del servicio de DynamoDB](https://docs.aws.amazon.com/general/latest/gr/ddb.html).
   + Para `dynamodb-table-rcu` especifique la cantidad de unidades de capacidad de lectura (RCU) que admite cada tabla. Para obtener más información sobre RCU, consulte [Capacidad aprovisionada de DynamoDB](https://aws.amazon.com/dynamodb/pricing/provisioned).
   + Para `dynamodb-table-wcu` especifique la cantidad de unidades de capacidad de escritura (RCU) que admite cada tabla. Para obtener más información sobre WCU, consulte [Capacidad aprovisionada de DynamoDB](https://aws.amazon.com/dynamodb/pricing/provisioned).
   + Para dynamodb-table-name-prefix, especifique el prefijo que se añade a cada tabla de DynamoDB (resulta útil para distinguir distintos clústeres de brokers que utilizan la misma cuenta de ). Solo se permiten caracteres alfanuméricos, punto, guion y guion bajo.

1. Detenga todos los brokers en el clúster. Para cada broker, ejecute el siguiente comando:

   ```
   sudo systemctl stop dcv-session-manager-broker
   ```

1. Asegúrese de que todos los brokers del clúster estén detenidos y, a continuación, reinícielos todos. Inicie cada broker ejecutando el siguiente comando:

   ```
   sudo systemctl start dcv-session-manager-broker
   ```

El host del broker debe tener permiso para llamar a las API de DynamoDB. En instancias de Amazon EC2, las credenciales se recuperan automáticamente a través del servicio de metadatos de Amazon EC2. Si necesita especificar credenciales diferentes, puede configurarlas mediante una de las técnicas de recuperación de credenciales compatibles (como las propiedades del sistema Java o las variables de entorno). Para obtener más información, consulte [Suministro y recuperación de credenciales de &aws;](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/credentials.html#credentials-profiles).

## Configurar el broker para que persista en MariaDB/MySQL
<a name="persistence-mysql"></a>

**nota**  
El archivo `/etc/dcv-session-manager-broker/session-manager-broker.properties` contiene información confidencial. De forma predeterminada, el acceso de escritura está limitado a la raíz y el acceso de lectura está limitado a la raíz y al usuario que ejecuta el broker. De forma predeterminada, este es el usuario `dcvsmbroker`. El broker comprueba al inicio que el archivo tiene los permisos esperados.

Configure los brokers para que comiencen a conservar sus datos en MariaDB/MySQL:

1. Abra `/etc/dcv-session-manager-broker/session-manager-broker.properties` con su editor de texto preferido y haga lo siguiente:
   + Configurar `enable-persistence = true`
   + Configurar `persistence-db = mysql`
   + Configurar `jdbc-connection-url = jdbc:mysql://<db_endpoint>:<db_port>/<db_name>?createDatabaseIfNotExist=true`

     En esta configuración, <db\$1endpoint> es el punto de conexión de la base de datos, <db\$1port> es el puerto de la base de datos y <db\$1name> es el nombre de la base de datos.
   + Para `jdbc-user`, especifique el nombre del usuario que tiene acceso a la base de datos.
   + Para `jdbc-password` especifique la contraseña del usuario que tiene acceso a la base de datos.

1. Detenga todos los brokers en el clúster. Para cada broker, ejecute el siguiente comando:

   ```
   sudo systemctl stop dcv-session-manager-broker
   ```

1. Asegúrese de que todos los brokers del clúster estén detenidos y, a continuación, reinícielos todos. Para cada broker, ejecute el siguiente comando:

   ```
   sudo systemctl start dcv-session-manager-broker
   ```