Étape 3 : configurer l'agent Amazon DCV Session Manager

L'agent doit être installé sur tous les hôtes DCV du serveur Amazon de la flotte. L'agent peut être installé sur des serveurs Windows et Linux. Pour plus d'informations sur les systèmes d'exploitation pris en charge, consultezExigences relatives à Amazon DCV Session Manager.

Prérequis

Le DCV serveur Amazon doit être installé sur l'hôte avant d'installer l'agent.

Linux host

Note

L'agent Session Manager est disponible pour les distributions et architectures Linux répertoriées dans Exigences :

Les instructions suivantes concernent l'installation de l'agent sur des hôtes x86 64 bits. Pour installer l'agent sur des ARM hôtes 64 bits, remplacez x86_64 avec aarch64. Pour Ubuntu, remplacez amd64 avec arm64.

Pour installer l'agent sur un hôte Linux

1. Les colis sont signés numériquement avec une GPG signature sécurisée. Pour permettre au gestionnaire du package de vérifier la signature du package, vous devez importer la DCV GPG clé Amazon. Exécutez la commande suivante pour importer la DCV GPG clé Amazon.

   • Amazon Linux 2RHEL, CentOS et 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. Téléchargez le package d'installation.

   • Amazon Linux 2 et 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 et 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 et 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 Entreprise 12

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

   • SUSELinux Entreprise 15

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

3. Installez le package .

   • Amazon Linux 2 et RHEL 7.x

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

   • RHEL8.x et 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 et 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 Entreprise 12

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

   • SUSELinux Entreprise 15

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

4. Placez une copie du certificat autosigné du courtier (que vous avez copié à l'étape précédente) dans le /etc/dcv-session-manager-agent/ répertoire de l'agent.

5. Ouvrez /etc/dcv-session-manager-agent/agent.conf à l'aide de votre éditeur de texte préféré et procédez comme suit.

   • Pourbroker_host, spécifiez le DNS nom de l'hôte sur lequel le broker est installé.

     Important

     Si le broker s'exécute sur une EC2 instance Amazon, broker_host vous devez spécifier l'adresse IPv4 privée de l'instance.

   • (Facultatif) Pourbroker_port, spécifiez le port par lequel communiquer avec le courtier. Par défaut, l'agent et le broker communiquent via le port8445. Ne modifiez cette option que si vous devez utiliser un autre port. Si vous le modifiez, assurez-vous que le broker est configuré pour utiliser le même port.

   • Pourca_file, spécifiez le chemin complet du fichier de certificat que vous avez copié à l'étape précédente. Par exemple :

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

     Sinon, si vous souhaitez désactiver la TLS vérification, définissez le paramètre tls_strict surfalse.

6. Enregistrez et fermez le fichier .

7. Exécutez la commande suivante pour démarrer l'agent.

   $ sudo systemctl start dcv-session-manager-agent

Windows host

Pour installer l'agent sur un hôte Windows

1. Téléchargez le programme d'installation de l'agent.

2. Exécutez le programme d'installation. Sur l'écran d'accueil, choisissez Next.

3. À l'EULAécran, lisez attentivement le contrat de licence et, si vous êtes d'accord, sélectionnez J'accepte les termes, puis Suivant.

4. Pour commencer l'installation, choisissez Installer.

5. Placez une copie du certificat autosigné du courtier (que vous avez copié à l'étape précédente) dans le C:\Program Files\NICE\DCVSessionManagerAgent\conf\ dossier de l'agent.

6. Ouvrez C:\Program Files\NICE\DCVSessionManagerAgent\conf\agent.conf à l'aide de votre éditeur de texte préféré, puis effectuez les opérations suivantes :

   • Pourbroker_host, spécifiez le DNS nom de l'hôte sur lequel le broker est installé.

     Important

     Si le broker s'exécute sur une EC2 instance Amazon, broker_host vous devez spécifier l'IPv4adresse privée de l'instance.

   • (Facultatif) Pourbroker_port, spécifiez le port par lequel communiquer avec le courtier. Par défaut, l'agent et le broker communiquent via le port8445. Ne modifiez cette option que si vous devez utiliser un autre port. Si vous le modifiez, assurez-vous que le broker est configuré pour utiliser le même port.

   • Pourca_file, spécifiez le chemin complet du fichier de certificat que vous avez copié à l'étape précédente. Par exemple :

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

     Sinon, si vous souhaitez désactiver la TLS vérification, définissez le paramètre tls_strict surfalse.

7. Enregistrez et fermez le fichier .

8. Arrêtez et redémarrez le service d'agent pour que les modifications prennent effet. Exécutez les commandes suivantes à l'invite de commandes.

   C:\> sc stop DcvSessionManagerAgentService

   C:\> sc start DcvSessionManagerAgentService