As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Como configurar a persistência do Agente
<a name="configure-broker-persistence"></a>

Os Agentes do Gerenciador de Sessões oferecem suporte à integração com bancos de dados externos. O banco de dados externo permite que o Gerenciador de Sessões mantenha os dados de status e as chaves para que estejam disponíveis posteriormente. Na verdade, os dados do Agente são distribuídos pelo cluster, tornando-o suscetível à perda de dados se um host precisar ser reinicializado ou se um cluster for encerrado. Com esse recurso ativado, você pode adicionar e remover nós do Agente. Além disso, você pode interromper um cluster e reiniciá-lo, sem a necessidade de regenerar chaves ou perder informações sobre qual servidor Amazon DCV Server está aberto ou fechado.

Os seguintes tipos de informações podem ser configurados para persistir:
+ Chaves para configurar sessões para estabelecer conexão com clientes
+ Dados das sessões de bordo
+ Status do servidor Amazon DCV

O Gerenciador de Sessões do Amazon DCV oferece suporte aos bancos de dados DynamoDB, MariaDB e MySQL. Você deve configurar e gerenciar um desses bancos de dados para usar esse recurso. Se suas máquinas com Agentes estiverem hospedadas no Amazon EC2, recomendamos usar o DynamoDB como o banco de dados externo, pois ele não requer nenhuma configuração adicional.

**nota**  
Você pode incorrer em custos adicionais ao executar um banco de dados externo. Para ver informações sobre os preços do DynamoDB, consulte [Preços da capacidade provisionada](https://aws.amazon.com/dynamodb/pricing/provisioned/).

## Configure o Agente para persistir no DynamoDB
<a name="persistence-dynamodb"></a>

Configure os Agentes para começarem a armazenar seus dados no DynamoDB:

1. Abra o `/etc/dcv-session-manager-broker/session-manager-broker.properties` usando o editor de texto de sua preferência e faça as seguintes edições:
   + Defina `enable-persistence = true`
   + Defina `persistence-db = dynamodb`
   + Para `dynamodb-region`, especifique a região da &aws; em que você deseja armazenar as tabelas que contêm os dados do Agente. Para obter uma lista das regiões compatíveis, consulte [Endpoints de serviço do DynamoDB](https://docs.aws.amazon.com/general/latest/gr/ddb.html).
   + Para `dynamodb-table-rcu`, especifique a quantidade de Unidades de capacidade de leitura (RCU) para as quais cada tabela dá suporte. Para obter mais informações sobre a RCU, consulte [Capacidade provisionada do DynamoDB](https://aws.amazon.com/dynamodb/pricing/provisioned).
   + Para `dynamodb-table-wcu`, especifique a quantidade de Unidades de capacidade de leitura (WCU) para as quais cada tabela dá suporte. Para obter mais informações sobre a WCU, consulte [Capacidade provisionada do DynamoDB](https://aws.amazon.com/dynamodb/pricing/provisioned).
   + Para dynamodb-table-name-prefix, especifique o prefixo que é adicionado a cada tabela do DynamoDB (útil para distinguir vários clusters de Agentes usando a mesma conta). São permitidos somente caracteres alfanuméricos, ponto, traço e sublinhado.

1. Pare todos os Agentes no cluster. Para cada Agente, execute o seguinte comando:

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

1. Certifique-se de que todos os Agentes no cluster sejam interrompidos e reinicie todos eles. Inicie cada Agente executando o seguinte comando:

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

O host do Agente deve ter permissão para chamar as APIs do DynamoDB. Em instâncias do Amazon EC2, as credenciais são recuperadas automaticamente usando o serviço de metadados do Amazon EC2. Se precisar especificar credenciais diferentes, você pode defini-las usando uma das técnicas de recuperação de credenciais compatíveis (como propriedades do sistema Java ou variáveis de ambiente). Para obter mais informações, consulte [Fornecimento e recuperação de credenciais da &aws](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/credentials.html#credentials-profiles).

## Configure o Agente para persistir no MariaDB/MySQL
<a name="persistence-mysql"></a>

**nota**  
O arquivo `/etc/dcv-session-manager-broker/session-manager-broker.properties` contém dados confidenciais. Por padrão, seu acesso de gravação é restrito à raiz e seu acesso de leitura é restrito à raiz e ao usuário que executa o Agente. Por padrão, esse é o usuário `dcvsmbroker`. O Agente verifica na inicialização se o arquivo tem as permissões esperadas.

Configure os Agentes para começarem a persistir seus dados no MariaDB/MySQL:

1. Abra o `/etc/dcv-session-manager-broker/session-manager-broker.properties` usando o editor de texto de sua preferência e faça as seguintes edições:
   + Defina `enable-persistence = true`
   + Defina `persistence-db = mysql`
   + Defina `jdbc-connection-url = jdbc:mysql://<db_endpoint>:<db_port>/<db_name>?createDatabaseIfNotExist=true`

     Nessa configuração, <db\$1endpoint> é o endpoint do banco de dados, <db\$1port> é a porta do banco de dados e <db\$1name> é o nome do banco de dados.
   + Para `jdbc-user`, especifique o nome do usuário que tem acesso ao banco de dados.
   + Para `jdbc-password`, especifique o nome do usuário que tem acesso ao banco de dados.

1. Pare todos os Agentes no cluster. Para cada Agente, execute o seguinte comando:

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

1. Certifique-se de que todos os Agentes no cluster sejam interrompidos e reinicie todos eles. Para cada Agente, execute o seguinte comando:

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