Fase 3: configurare l'agente Amazon DCV Session Manager - Gestore di sessioni Amazon DCV

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Fase 3: configurare l'agente Amazon DCV Session Manager

L'agente deve essere installato su tutti gli host di server Amazon DCV del parco macchine. L'agente può essere installato su host Windows, Linux e macOS. Per ulteriori informazioni sui sistemi operativi supportati, vedereRequisiti di Amazon DCV Session Manager.

Prerequisiti

Il server Amazon DCV deve essere installato sull'host prima di installare l'agente.

Linux host
Nota

L'agente Session Manager è disponibile per le distribuzioni e le architetture Linux elencate in Requisiti:

Le seguenti istruzioni riguardano l'installazione dell'agente su host x86 a 64 bit. Per installare l'agente su host ARM a 64 bit sostituirlo x86_64 conaarch64. Per Ubuntu, sostituisci amd64 conarm64.

Per installare l'agente su un host Linux

  1. I pacchetti del sono firmati digitalmente con una firma GPG sicura. Per consentire al gestore di pacchetti di verificare la firma del pacchetto, devi importare la chiave Amazon DCV GPG. Esegui il comando seguente per importare la chiave Amazon DCV GPG.

    • 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. Scarica il pacchetto di installazione.

    • 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. Installare il pacchetto .

    • 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. Inserisci una copia del certificato autofirmato del broker (che hai copiato nel passaggio precedente) nella /etc/dcv-session-manager-agent/ directory dell'agente.

  5. Apri /etc/dcv-session-manager-agent/agent.conf usando il tuo editor di testo preferito e procedi come segue.

    • Perbroker_host, specifica il nome DNS dell'host su cui è installato il broker.

      Importante

      Se il broker è in esecuzione su un' EC2 istanza Amazon, broker_host devi specificare l'indirizzo Ipv4 privato dell'istanza.

    • (Facoltativo) Perbroker_port, specifica la porta tramite la quale comunicare con il broker. Per impostazione predefinita, l'agente e il broker comunicano tramite porta8445. Modificalo solo se devi usare una porta diversa. Se lo modifichi, assicurati che il broker sia configurato per utilizzare la stessa porta.

    • Perca_file, specifica il percorso completo del file di certificato che hai copiato nel passaggio precedente. Ad esempio: 

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

      In alternativa, se desideri disabilitare la verifica TLS, imposta sutls_strict. false

  6. Salva e chiudi il file.

  7. Esegui il comando seguente per avviare l'agente.

    $ sudo systemctl start dcv-session-manager-agent
Windows host
Per installare l'agente su un host Windows

  1. Scarica il programma di installazione dell'agente.

  2. Eseguire il programma di installazione. Nella schermata iniziale, selezionare Next (Successivo).

  3. Nella schermata EULA, leggi attentamente il contratto di licenza e, se sei d'accordo, seleziona Accetto i termini e scegli Avanti.

  4. Per iniziare l'installazione, scegli Installa.

  5. Inserisci una copia del certificato autofirmato del broker (che hai copiato nel passaggio precedente) nella C:\Program Files\NICE\DCVSessionManagerAgent\conf\ cartella dell'agente.

  6. Apri C:\Program Files\NICE\DCVSessionManagerAgent\conf\agent.conf utilizzando il tuo editor di testo preferito, quindi procedi come segue:

    • Perbroker_host, specifica il nome DNS dell'host su cui è installato il broker.

      Importante

      Se il broker è in esecuzione su un' EC2 istanza Amazon, broker_host devi specificare l' IPv4 indirizzo privato dell'istanza.

    • (Facoltativo) Perbroker_port, specifica la porta tramite la quale comunicare con il broker. Per impostazione predefinita, l'agente e il broker comunicano tramite porta8445. Modificalo solo se devi usare una porta diversa. Se lo modifichi, assicurati che il broker sia configurato per utilizzare la stessa porta.

    • Perca_file, specifica il percorso completo del file di certificato che hai copiato nel passaggio precedente. Ad esempio: 

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

      In alternativa, se desideri disabilitare la verifica TLS, imposta sutls_strict. false

  7. Salva e chiudi il file.

  8. Arresta e riavvia il servizio dell'agente per rendere effettive le modifiche. Esegui i seguenti comandi al prompt dei comandi.

    C:\> sc stop DcvSessionManagerAgentService
    C:\> sc start DcvSessionManagerAgentService
macOS host
Per installare l'agente su un host macOS

  1. Scarica il programma di installazione dell'agente o usa la riga di comando:

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

  2. Installare il pacchetto . È possibile utilizzare la riga di comando o tramite il programma di installazione dell'agente:

    • Riga di comando:

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

    • Programma di installazione dell'agente: fai doppio clic sul .pkg file e segui la procedura guidata di installazione.

  3. Inserisci una copia del certificato autofirmato del broker (che hai copiato nel passaggio precedente) nella directory dell'/etc/dcv-session-manager-agent/agente.

  4. Apri /etc/dcv-session-manager-agent/agent.conf usando il tuo editor di testo preferito e procedi come segue.

    • Perbroker_host, specifica il nome DNS dell'host su cui è installato il broker.

      Importante

      Se il broker è in esecuzione su un' EC2 istanza Amazon, broker_host devi specificare l' IPv4 indirizzo privato dell'istanza.

    • (Facoltativo) Perbroker_port, specifica la porta tramite la quale comunicare con il broker. Per impostazione predefinita, l'agente e il broker comunicano tramite porta8445. Modificalo solo se devi usare una porta diversa. Se lo modifichi, assicurati che il broker sia configurato per utilizzare la stessa porta.

    • Perca_file, specifica il percorso completo del file di certificato che hai copiato nel passaggio precedente. Ad esempio: 

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

      In alternativa, se desideri disabilitare la verifica TLS, imposta sutls_strict. false

  5. Salva e chiudi il file.

  6. Avvia il servizio dell'agente.

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