Etapa 3: Configurar o atendente do Gerenciador de Sessões do Amazon DCV - Gerenciador de Sessões do Amazon DCV

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á.

Etapa 3: Configurar o atendente do Gerenciador de Sessões do Amazon DCV

O atendente deve estar instalado em todos os hosts do servidor Amazon DCV da frota. O agente pode ser instalado em hosts Windows, Linux e macOS. Para obter mais informações sobre os sistemas operacionais compatíveis, consulte Requisitos do Gerenciador de Sessões do Amazon DCV.

Pré-requisitos

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

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 hosts ARM 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 do são assinados digitalmente com uma assinatura GPG segura. Para permitir que o gerenciador de pacotes verifique a assinatura do pacote, é necessário importar a chave GPG do Amazon DCV. Execute o comando a seguir para importar a chave GPG do Amazon DCV.

    • Amazon Linux 2, RHEL, CentOS e SUSE Linux Enterprise

      $ 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

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

    • Amazon Linux 2023

      $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent-2025.0.888-1.amzn2023.x86_64.rpm

    • RHEL 8.x e Rocky Linux 8.x

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

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

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

    • Ubuntu 20.04

      $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent_2025.0.888-1_amd64.ubuntu2004.deb

    • Ubuntu 22.04

      $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent_2025.0.888-1_amd64.ubuntu2204.deb

    • Ubuntu 24.04

      $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent_2025.0.888-1_amd64.ubuntu2404.deb

    • SUSE Linux Enterprise 12

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

    • SUSE Linux Enterprise 15

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

  3. Instale o pacote .

    • Amazon Linux 2

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

    • Amazon Linux 2023

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

    • RHEL 8.x e Rocky Linux 8.x

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

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

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

    • Ubuntu 20.04

      $  sudo apt install ./nice-dcv-session-manager-agent_2025.0.888-1_amd64.ubuntu2004.deb

    • Ubuntu 22.04

      $  sudo apt install ./nice-dcv-session-manager-agent_2025.0.888-1_amd64.ubuntu2204.deb

    • Ubuntu 24.04

      $  sudo apt install ./nice-dcv-session-manager-agent_2025.0.888-1_amd64.ubuntu2404.deb

    • SUSE Linux Enterprise 12

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

    • SUSE Linux Enterprise 15

      $ sudo zypper install ./nice-dcv-session-manager-agent-2025.0.888-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:

    • Para broker_host, especifique o nome DNS do host no qual o agente 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'

      Opcionalmente, se você quiser desativar a verificação do TLS, defina tls_strict como false.

  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 tela do EULA (Contrato de Licença do Usuário Final), leia com atenção o contrato de licença e, se você 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:

    • Para broker_host, especifique o nome DNS do host no qual o agente 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'

      Opcionalmente, se você quiser desativar a verificação do TLS, defina tls_strict como false.

  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
macOS host
Para instalar o agente em um host macOS

  1. Baixe o instalador do agente ou use a linha de comando:

    $ curl -O https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent-2025.0.888-macos-arm64.pkg

  2. Instale o pacote . Você pode usar a linha de comando ou por meio do instalador do agente:

    • Linha de comando:

      $ sudo installer -pkg ./nice-dcv-session-manager-agent-2025.0.888-macos-arm64.pkg -target /

    • Instalador do agente: clique duas vezes no .pkg arquivo e siga o assistente de instalação.

  3. 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.

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

    • Para broker_host, especifique o nome DNS do host no qual o agente 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 = '/usr/local/etc/dcv-session-manager-agent/broker_cert.pem'

      Opcionalmente, se você quiser desativar a verificação do TLS, defina tls_strict como false.

  5. Salve e feche o arquivo.

  6. Inicie o serviço do agente.

    $ sudo launchctl load /Library/LaunchDaemons/com.amazon.dcv.session-manager.agent.plist