Paso 3: configuración del agente de Amazon DCV Session Manager

El agente debe estar instalado en todos los hosts del servidor Amazon DCV de la flota. El agente puede estar instalado en servidores Windows y Linux. Para obtener más información acerca de los sistemas operativos compatibles, consulte Requisitos de Amazon DCV Session Manager.

Requisitos previos

El servidor Amazon DCV debe estar instalado en todos el host antes de instalar el agente.

Linux host

nota

El agente de Session Manager está disponible para las distribuciones y arquitecturas de Linux enumeradas en Requisitos:

Siga estas instrucciones para instalar el agente en hosts x86 de 64 bits. Para instalar el agente en hosts ARM de 64 bits, x86_64 sustitúyalo poraarch64. Para Ubuntu, amd64 sustitúyalo porarm64.

Para instalar el agente en un host Linux

1. Los paquetes del se firman digitalmente con una firma GPG segura. Para permitir al administrador de paquetes comprobar la firma de paquetes, debe importar la clave GPG de Amazon DCV. Ejecute el siguiente comando para importar la clave de GPG de Amazon DCV.

   • Amazon Linux 2, RHEL, CentOS y 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. Descargue el paquete de instalación.

   • Amazon Linux 2

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

   • Amazon Linux 2023

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

   • RHEL 8.x y Rocky Linux 8.x

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

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

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

   • Ubuntu 20.04

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

   • Ubuntu 22.04

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

   • Ubuntu 24.04

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

   • SUSE Linux Enterprise 12

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

   • SUSE Linux Enterprise 15

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

3. Instale el paquete.

   • Amazon Linux 2

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

   • Amazon Linux 2023

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

   • RHEL 8.x y Rocky Linux 8.x

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

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

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

   • Ubuntu 20.04

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

   • Ubuntu 22.04

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

   • Ubuntu 24.04

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

   • SUSE Linux Enterprise 12

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

   • SUSE Linux Enterprise 15

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

4. Coloque una copia del certificado autofirmado del broker (que copió en el paso anterior) en el directorio /etc/dcv-session-manager-agent/ del agente.

5. Abra /etc/dcv-session-manager-agent/agent.conf con su editor de texto preferido y haga lo siguiente.

   • Para broker_host, especifique el nombre DNS del host en el que está instalado el broker.

     importante

     Si el corredor se ejecuta en una EC2 instancia de Amazon, broker_host debe especificar la dirección IPv4 privada de la instancia.

   • (Opcional) Para broker_port, especifique el puerto a través del cual se va a comunicar con el broker. De forma predeterminada, el agente y el broker se comunican a través del puerto 8445. Cambie esto solo si necesita utilizar otro puerto. Si lo cambia, asegúrese de que el broker está configurado para utilizar el mismo puerto.

   • Para ca_file, especifique la ruta completa del archivo de certificado que copió en el paso anterior. Por ejemplo:

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

     Como alternativa, si desea deshabilitar la verificación de TLS, establezca tls_strict en false.

6. Guarde y cierre el archivo.

7. Para iniciar el agente, ejecute el comando siguiente.

   $ sudo systemctl start dcv-session-manager-agent

Windows host

Para instalar el agente en un host de Windows

1. Descargue el instalador del agente.

2. Ejecute el instalador. En la pantalla de bienvenida, elija Next.

3. En la pantalla del EULA, lea atentamente el contrato de licencia y, si está de acuerdo, seleccione Acepto los términos y condiciones y elija Siguiente.

4. Elija Instalar para comenzar la instalación.

5. Coloque una copia del certificado autofirmado del broker (que copió en el paso anterior) en la carpeta C:\Program Files\NICE\DCVSessionManagerAgent\conf\ del agente.

6. Abra C:\Program Files\NICE\DCVSessionManagerAgent\conf\agent.conf con su editor de texto preferido y, a continuación, haga lo siguiente:

   • Para broker_host, especifique el nombre DNS del host en el que está instalado el broker.

     importante

     Si el corredor se ejecuta en una EC2 instancia de Amazon, broker_host debe especificar la IPv4 dirección privada de la instancia.

   • (Opcional) Para broker_port, especifique el puerto a través del cual se va a comunicar con el broker. De forma predeterminada, el agente y el broker se comunican a través del puerto 8445. Cambie esto solo si necesita utilizar otro puerto. Si lo cambia, asegúrese de que el broker está configurado para utilizar el mismo puerto.

   • Para ca_file, especifique la ruta completa del archivo de certificado que copió en el paso anterior. Por ejemplo:

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

     Como alternativa, si desea deshabilitar la verificación de TLS, establezca tls_strict en false.

7. Guarde y cierre el archivo.

8. Pare y reinicie el servicio del agente para que los cambios surtan efecto. En el símbolo del sistema, ejecute los siguientes comandos.

   C:\> sc stop DcvSessionManagerAgentService

   C:\> sc start DcvSessionManagerAgentService