本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 步骤 3：设置 Amazon DCV Session Manager Agent Agent 必须安装在一组 Amazon DCV 服务器主机中的所有主机上。该代理可以安装在 Windows、Linux 和 macOS 主机上。有关支持的操作系统的更多信息，请参阅[Amazon DCV Session Manager 要求](requirements.md)。 **先决条件** 安装 Agent 之前，必须在主机上安装 Amazon DCV 服务器。 ------ #### [ Linux host ] **注意** Session Manager Agent 适用于[要求](requirements.md)中列出的 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 ``` 1. 下载安装软件包。 + 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 和 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 和 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 ``` 1. 安装软件包。 + 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 和 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 和 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 ``` 1. 将 Broker 的自签名证书副本（您在上一步中复制的副本）放置在 Agent 上的 ` /etc/dcv-session-manager-agent/` 目录中。 1. 使用常用的文本编辑器打开 `/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`。 1. 保存并关闭该文件。 1. 运行以下命令以启动 Agent。 ``` $ sudo systemctl start dcv-session-manager-agent ``` ------ #### [ Windows host ] **在 Windows 主机上安装 Agent** 1. 下载 [Agent 安装程序](https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent-x64-Release-2025.0-888.msi)。 1. 运行安装程序。在欢迎屏幕上，选择 **Next**。 1. 在 EULA 屏幕上，仔细阅读许可协议；如果同意，请选择 **I accept the terms** 并选择 **Next**。 1. 要开始安装，请选择 **Install**。 1. 将 Broker 的自签名证书副本（您在上一步中复制的副本）放置在 Agent 上的 `C:\Program Files\NICE\DCVSessionManagerAgent\conf\` 文件夹中。 1. 使用常用的文本编辑器打开 `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`。 1. 保存并关闭该文件。 1. 停止并重新启动 Agent 服务以使更改生效。在命令提示符下运行以下命令。 ``` C:\> sc stop DcvSessionManagerAgentService ``` ``` C:\> sc start DcvSessionManagerAgentService ``` ------ #### [ macOS host ] **在 macOS 主机上安装代理** 1. 下载[代理安装程序](https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent-2025.0.888-macos-arm64.pkg)或使用命令行： ``` $ curl -O https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent-2025.0.888-macos-arm64.pkg ``` 1. 安装软件包。您可以使用命令行或通过代理安装程序： + 命令行： ``` $ sudo installer -pkg ./nice-dcv-session-manager-agent-2025.0.888-macos-arm64.pkg -target / ``` + 代理安装程序：双击`.pkg`文件并按照安装向导进行操作。 1. 将 Broker 的自签名证书副本（您在上一步中复制的副本）放置在 Agent 上的 `/etc/dcv-session-manager-agent/` 目录中。 1. 使用常用的文本编辑器打开 `/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 = '/usr/local/etc/dcv-session-manager-agent/{{broker_cert}}.pem' ``` 或者，如果您要禁用 TLS 验证，请将 `tls_strict` 设置为 `false`。 1. 保存并关闭该文件。 1. 启动代理服务。 ``` $ sudo launchctl load /Library/LaunchDaemons/com.amazon.dcv.session-manager.agent.plist ``` ------