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

Mode de mise au point

Étape 3 : configurer l'agent Amazon DCV Session Manager - Gestionnaire de sessions Amazon DCV

L'agent doit être installé sur tous les hôtes du serveur Amazon DCV du parc. 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 au gestionnaire de sessions Amazon DCV.

Prérequis

Le serveur Amazon DCV 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 hôtes ARM 64 bits, remplacez x86_64 paraarch64. Pour Ubuntu, remplacez amd64 pararm64.

Pour installer l'agent sur un hôte Linux

Les packages du sont signés numériquement avec une signature GPG sécurisée. Pour permettre au gestionnaire de package de vérifier la signature du package, vous devez importer la clé GPG Amazon DCV. Exécutez la commande suivante pour importer la clé Amazon DCV GPG.
- Amazon Linux 2, RHEL, 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
```

Téléchargez le package d'installation.

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.817-1.amzn2023.x86_64.rpm

RHEL 8.x et Rocky Linux 8.x


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

CentOS 9.x, RHEL 9.x et Rocky Linux 9.x


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

Ubuntu 20.04


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

Ubuntu 22.04


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

Ubuntu 24.04


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

SUSE Linux Enterprise 12


$ curl -O https://d1uj6qtbmh3dt5.cloudfront.net/2024.0/SessionManagerAgents/nice-dcv-session-manager-agent-2024.0.817-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.817-1.sles15.x86_64.rpm

Installez le package .

Amazon Linux 2


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

Amazon Linux 2023


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

RHEL 8.x et Rocky Linux 8.x


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

CentOS 9.x, RHEL 9.x et Rocky Linux 9.x


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

Ubuntu 20.04


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

Ubuntu 22.04


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

Ubuntu 24.04


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

SUSE Linux Enterprise 12


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

SUSE Linux Enterprise 15


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

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.
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 nom DNS 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 vérification TLS, définissez le paramètre surtls_strict. false
Enregistrez et fermez le fichier .
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

Téléchargez le programme d'installation de l'agent.
Exécutez le programme d'installation. Sur l'écran d'accueil, choisissez Next.
Sur l'écran EULA, lisez attentivement le contrat de licence et, si vous êtes d'accord, sélectionnez J'accepte les termes, puis Next.
Pour commencer l'installation, choisissez Installer.
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.
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 nom DNS 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' IPv4 adresse 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 vérification TLS, définissez le paramètre surtls_strict. false
Enregistrez et fermez le fichier .
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
```

anchor anchor

Note

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

Pour installer l'agent sur un hôte Linux

Les packages du sont signés numériquement avec une signature GPG sécurisée. Pour permettre au gestionnaire de package de vérifier la signature du package, vous devez importer la clé GPG Amazon DCV. Exécutez la commande suivante pour importer la clé Amazon DCV GPG.
- Amazon Linux 2, RHEL, 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
```

Téléchargez le package d'installation.

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.817-1.amzn2023.x86_64.rpm

RHEL 8.x et Rocky Linux 8.x


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

CentOS 9.x, RHEL 9.x et Rocky Linux 9.x


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

Ubuntu 20.04


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

Ubuntu 22.04


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

Ubuntu 24.04


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

SUSE Linux Enterprise 12


$ curl -O https://d1uj6qtbmh3dt5.cloudfront.net/2024.0/SessionManagerAgents/nice-dcv-session-manager-agent-2024.0.817-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.817-1.sles15.x86_64.rpm

Installez le package .

Amazon Linux 2


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

Amazon Linux 2023


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

RHEL 8.x et Rocky Linux 8.x


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

CentOS 9.x, RHEL 9.x et Rocky Linux 9.x


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

Ubuntu 20.04


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

Ubuntu 22.04


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

Ubuntu 24.04


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

SUSE Linux Enterprise 12


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

SUSE Linux Enterprise 15


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

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.
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 nom DNS 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 vérification TLS, définissez le paramètre surtls_strict. false
Enregistrez et fermez le fichier .
Exécutez la commande suivante pour démarrer l'agent.
```
$ sudo systemctl start dcv-session-manager-agent
```

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.