Etapa 3: configurar o agente do Amazon DCV Session Manager

O agente deve estar instalado em todos os DCV servidores hospedeiros da Amazon na frota. O atendente pode ser instalado em servidores Windows e Linux. Para obter mais informações sobre os sistemas operacionais compatíveis, consulte Requisitos do Amazon DCV Session Manager.

Pré-requisitos

O DCV servidor da Amazon deve ser instalado no host antes de instalar o agente.

Linux host

nota

O atendente do Gerenciador de Sessões está disponível para as distribuições e arquiteturas do Linux listadas em Requisitos:

As instruções a seguir são para instalar o atendente em hosts x86 de 64 bits. Para instalar o agente em ARM hosts de 64 bits, x86_64 substitua poraarch64. Para o Ubuntu, amd64 substitua porarm64.

Para instalar o atendente em um host do Linux

1. Os pacotes são assinados digitalmente com uma GPG assinatura segura. Para permitir que o gerenciador de pacotes verifique a assinatura do pacote, você deve importar a DCV GPG chave da Amazon. Execute o comando a seguir para importar a DCV GPG chave da Amazon.

   • Amazon Linux 2RHEL, CentOS e Linux Enterprise SUSE

     $ sudo rpm --import https://d1uj6qtbmh3dt5.cloudfront.net/NICE-GPG-KEY

   • Ubuntu

     $ wget https://d1uj6qtbmh3dt5.cloudfront.net/NICE-GPG-KEY

     $ gpg --import NICE-GPG-KEY

2. Baixe o pacote de instalação.

   • Amazon Linux 2 e RHEL 7.x

     $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2024.0/SessionManagerAgents/nice-dcv-session-manager-agent-2024.0.781-1.el7.x86_64.rpm

   • RHEL8.x e Rocky Linux 8.x

     $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2024.0/SessionManagerAgents/nice-dcv-session-manager-agent-2024.0.781-1.el8.x86_64.rpm

   • CentOS 9.x, 9.x e RHEL Rocky Linux 9.x

     $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2024.0/SessionManagerAgents/nice-dcv-session-manager-agent-2024.0.781-1.el9.x86_64.rpm

   • Ubuntu 20.04

     $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2024.0/SessionManagerAgents/nice-dcv-session-manager-agent_2024.0.781-1_amd64.ubuntu2004.deb

   • Ubuntu 22.04

     $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2024.0/SessionManagerAgents/nice-dcv-session-manager-agent_2024.0.781-1_amd64.ubuntu2204.deb

   • Ubuntu 24.04

     $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2024.0/SessionManagerAgents/nice-dcv-session-manager-agent_2024.0.781-1_amd64.ubuntu2404.deb

   • SUSELinux Enterprise 12

     $ curl -O https://d1uj6qtbmh3dt5.cloudfront.net/2024.0/SessionManagerAgents/nice-dcv-session-manager-agent-2024.0.781-1.sles12.x86_64.rpm

   • SUSELinux Enterprise 15

     $ curl -O https://d1uj6qtbmh3dt5.cloudfront.net/2024.0/SessionManagerAgents/nice-dcv-session-manager-agent-2024.0.781-1.sles15.x86_64.rpm

3. Instale o pacote .

   • Amazon Linux 2 e RHEL 7.x

     $  sudo yum install -y ./nice-dcv-session-manager-agent-2024.0.781-1.el7.x86_64.rpm

   • RHEL8.x e Rocky Linux 8.x

     $  sudo yum install -y ./nice-dcv-session-manager-agent-2024.0.781-1.el8.x86_64.rpm

   • CentOS 9.x, 9.x e RHEL Rocky Linux 9.x

     $  sudo yum install -y ./nice-dcv-session-manager-agent-2024.0.781-1.el9.x86_64.rpm

   • Ubuntu 20.04

     $  sudo apt install ./nice-dcv-session-manager-agent_2024.0.781-1_amd64.ubuntu2004.deb

   • Ubuntu 22.04

     $  sudo apt install ./nice-dcv-session-manager-agent_2024.0.781-1_amd64.ubuntu2204.deb

   • Ubuntu 24.04

     $  sudo apt install ./nice-dcv-session-manager-agent_2024.0.781-1_amd64.ubuntu2404.deb

   • SUSELinux Enterprise 12

     $ sudo zypper install ./nice-dcv-session-manager-agent-2024.0.781-1.sles12.x86_64.rpm

   • SUSELinux Enterprise 15

     $ sudo zypper install ./nice-dcv-session-manager-agent-2024.0.781-1.sles15.x86_64.rpm

4. Coloque uma cópia do certificado autoassinado do agente (que você copiou na etapa anterior) no diretório /etc/dcv-session-manager-agent/ do atendente.

5. Abra /etc/dcv-session-manager-agent/agent.conf usando o editor de texto que preferir e adicione o seguinte:

   • Parabroker_host, especifique o DNS nome do host no qual o broker está instalado.

     Importante

     Se o broker estiver sendo executado em uma EC2 instância da Amazon, broker_host você deverá especificar o endereço Ipv4 privado da instância.

   • (Opcional) Para broker_port, especifique a porta pela qual se comunicar com o agente. Por padrão, o atendente e o agente se comunicam pela porta 8445. Altere isso somente se precisar usar uma porta diferente. Se você alterá-la, certifique-se de que o agente esteja configurado para usar a mesma porta.

   • Para ca_file, especifique o caminho completo do arquivo de certificado que você copiou na etapa anterior. Por exemplo:

     ca_file = '/etc/dcv-session-manager-agent/broker_cert.pem'

     Como alternativa, se você quiser desativar a TLS verificação, tls_strict defina comofalse.

6. Salve e feche o arquivo.

7. Para iniciar o atendente, execute o comando a seguir.

   $ sudo systemctl start dcv-session-manager-agent

Windows host

Para instalar o atendente em um host do Windows

1. Baixe o instalador do atendente.

2. Execute o instalador. Na tela Welcome, escolha Next.

3. Na EULA tela, leia atentamente o contrato de licença e, se concordar, selecione Aceito os termos e escolha Avançar.

4. Para iniciar a instalação, escolha Instalar.

5. Coloque uma cópia do certificado autoassinado do agente (que você copiou na etapa anterior) na pasta C:\Program Files\NICE\DCVSessionManagerAgent\conf\ do atendente.

6. Abra o C:\Program Files\NICE\DCVSessionManagerAgent\conf\agent.conf usando o editor de texto que preferir e adicione o seguinte:

   • Parabroker_host, especifique o DNS nome do host no qual o broker está instalado.

     Importante

     Se o broker estiver sendo executado em uma EC2 instância da Amazon, broker_host você deverá especificar o IPv4 endereço privado da instância.

   • (Opcional) Para broker_port, especifique a porta pela qual se comunicar com o agente. Por padrão, o atendente e o agente se comunicam pela porta 8445. Altere isso somente se precisar usar uma porta diferente. Se você alterá-la, certifique-se de que o agente esteja configurado para usar a mesma porta.

   • Para ca_file, especifique o caminho completo do arquivo de certificado que você copiou na etapa anterior. Por exemplo:

     ca_file = 'C:\Program Files\NICE\DCVSessionManagerAgent\conf\broker_cert.pem'

     Como alternativa, se você quiser desativar a TLS verificação, tls_strict defina comofalse.

7. Salve e feche o arquivo.

8. Interrompa e reinicie o serviço do atendente para que as alterações entrem em vigor. Execute os comandos a seguir no prompt de comando.

   C:\> sc stop DcvSessionManagerAgentService

   C:\> sc start DcvSessionManagerAgentService