步骤 3：设置 Amazon DCV Session Manager Agent - Amazon DCV Session Manager
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

步骤 3：设置 Amazon DCV Session Manager Agent

Agent 必须安装在一组 Amazon DCV 服务器主机中的所有主机上。Agent 可以安装在 Windows 和 Linux 服务器上。有关支持的操作系统的更多信息，请参阅Amazon DCV Session Manager 要求。

先决条件

安装 Agent 之前，必须在主机上安装 Amazon DCV 服务器。

Linux host
注意

Session Manager Agent 适用于要求中列出的 Linux 发行版和架构：

以下说明适用于在 64 位 x86 主机上安装 Agent。要在 64 位 ARM 主机上安装代理，请x86_64替aarch64换为。对于 Ubuntu，请替换为amd64。arm64

在 Linux 主机上安装 Agent

  1. 程序包使用安全 GPG 签名进行数字签名。要允许程序包管理器验证程序包签名，您必须导入 Amazon DCV GPG 密钥。运行以下命令以导入 Amazon DCV GPG 密钥。

    • Amazon Linux 2、RHEL、CentOS 和 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. 下载安装软件包。

    • 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 和 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 和 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. 安装软件包。

    • 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 和 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 和 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. 将 Broker 的自签名证书副本（您在上一步中复制的副本）放置在 Agent 上的 /etc/dcv-session-manager-agent/ 目录中。

  5. 使用常用的文本编辑器打开 /etc/dcv-session-manager-agent/agent.conf，然后执行以下操作。

    • 对于 broker_host，指定在其中安装 Broker 的主机的 DNS 名称。

      重要

      如果代理在 Amazon EC2 实例上运行，broker_host则必须指定该实例的私有 Ipv4 地址。

    • （可选）对于 broker_port，指定用于与 Broker 通信的端口。默认情况下，Agent 和 Broker 通过 8445 端口进行通信。只有在您需要使用不同的端口时，才需要更改该设置。如果您确实要更改该设置，请确保 Broker 配置为使用相同的端口。

    • 对于 ca_file，指定您在上一步中复制的证书文件的完整路径。例如：

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

      或者，如果您要禁用 TLS 验证，请将 tls_strict 设置为 false。

  6. 保存并关闭该文件。

  7. 运行以下命令以启动 Agent。

    $ sudo systemctl start dcv-session-manager-agent
Windows host
在 Windows 主机上安装 Agent

  1. 下载 Agent 安装程序。

  2. 运行安装程序。在欢迎屏幕上，选择 Next。

  3. 在 EULA 屏幕上，仔细阅读许可协议；如果同意，请选择 I accept the terms 并选择 Next。

  4. 要开始安装，请选择 Install。

  5. 将 Broker 的自签名证书副本（您在上一步中复制的副本）放置在 Agent 上的 C:\Program Files\NICE\DCVSessionManagerAgent\conf\ 文件夹中。

  6. 使用常用的文本编辑器打开 C:\Program Files\NICE\DCVSessionManagerAgent\conf\agent.conf，然后执行以下操作：

    • 对于 broker_host，指定在其中安装 Broker 的主机的 DNS 名称。

      重要

      如果代理在 Amazon EC2 实例上运行，broker_host则必须指定该实例的私有 IPv4 地址。

    • （可选）对于 broker_port，指定用于与 Broker 通信的端口。默认情况下，Agent 和 Broker 通过 8445 端口进行通信。只有在您需要使用不同的端口时，才需要更改该设置。如果您确实要更改该设置，请确保 Broker 配置为使用相同的端口。

    • 对于 ca_file，指定您在上一步中复制的证书文件的完整路径。例如：

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

      或者，如果您要禁用 TLS 验证，请将 tls_strict 设置为 false。

  7. 保存并关闭该文件。

  8. 停止并重新启动 Agent 服务以使更改生效。在命令提示符下运行以下命令。

    C:\> sc stop DcvSessionManagerAgentService
    C:\> sc start DcvSessionManagerAgentService