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

# 升级 Amazon DCV Session Manager Agent
<a name="upgrading-agent"></a>

Amazon DCV Session Manager Agent 从 Broker 接收指令，并在相应的 Amazon DCV 服务器上运行这些指令。作为例行维护的一部分，需要对 Agent 进行升级以满足新的标准和要求。本节指导您完成 Session Manager Agent 的升级过程。

------
#### [ Linux host ]

**注意**  
以下说明适用于在 64 位 x86 主机上安装 Agent。要在 64 位 ARM 主机上安装代理，对于亚马逊 Linux、RHEL 和 Centos，请替换为，对于 Ubuntu`aarch64`，请{{x86\_64}}替换为。{{amd64}} `arm64`

**更新 Linux 主机上的 Agent**

1. 运行以下命令以停止 Agent。

   ```
   $  sudo systemctl stop dcv-session-manager-agent
   ```

1. 下载安装软件包。
   + Amazon Linux 2 和 RHEL 7.x

     ```
     $  wget https://d1uj6qtbmh3dt5.cloudfront.net/2025.0/SessionManagerAgents/nice-dcv-session-manager-agent-2025.0.888-1.el7.{{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
     ```
   + 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 和 RHEL 7.x

     ```
     $  sudo yum install -y nice-dcv-session-manager-agent-2025.0.888-1.el7.{{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
     ```
   + 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. 运行以下命令以启动 Agent。

   ```
   $  sudo systemctl start dcv-session-manager-agent
   ```

------
#### [ Windows host ]

**更新 Windows 主机上的 Agent**

1. 停止 Agent 服务。在命令提示符下运行以下命令。

   ```
   C:\>  sc stop DcvSessionManagerAgentService
   ```

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. 重新启动 Agent 服务。在命令提示符下运行以下命令。

   ```
   C:\>  sc start DcvSessionManagerAgentService
   ```

------
#### [ macOS host ]

**在 macOS 主机上更新代理**

1. 运行以下命令以停止 Agent。

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

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. 运行以下命令以启动 Agent。

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

------