Upgrading the Amazon DCV Server - Amazon DCV
Compatibility considerationsUpgrading the Amazon DCV Server on WindowsUpgrading the Amazon DCV Server on Linux
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Upgrading the Amazon DCV Server

The following topic describes how to upgrade the Amazon DCV server.

Compatibility considerations

Amazon DCV server versions 2017 and later are compatible with Amazon DCV client versions 2017 and later.

Note

For information about the Amazon DCV server licensing compatibility requirements for on-premises and non EC2-based servers, see Licensing requirements.

Upgrading the Amazon DCV Server on Windows

To upgrade the Amazon DCV server on Windows

  1. Using an RDP client, connect to the Amazon DCV server as the administrator.

  2. Ensure that there are no running Amazon DCV sessions. Use the dcv list-sessions Amazon DCV command to check for any running sessions. If there are running sessions, use the dcv close-session Amazon DCV command to stop them.

  3. After you confirm that there are no running sessions, stop the Amazon DCV server. For more information, see Stopping the Amazon DCV Server.

  4. Back up your Amazon DCV server configuration. Open the Registry Editor, navigate to HKEY_USERS/S-1-5-18/Software/GSettings/com/nicesoftware/dcv, right-click the dcv key, and choose Export.

  5. Download the latest version of the Amazon DCV Server from the NICE website.

  6. Follow the steps described in Using the wizard, starting at step 3.

  7. After the installation is complete, confirm that the Amazon DCV server configuration is still correct. Open the Registry Editor, navigate to HKEY_USERS/S-1-5-18/Software/GSettings/com/nicesoftware/dcv and compare the parameters to the configuration that you exported in step 4.

  8. Test the Amazon DCV server by starting a new Amazon DCV session. For more information, see Starting Amazon DCV sessions.

Upgrading the Amazon DCV Server on Linux

To upgrade the Amazon DCV server on Linux

  1. Use SSH to sign in to the server using the root user.

  2. Ensure that there are no running Amazon DCV sessions. Use the dcv list-sessions Amazon DCV command to check for any running sessions. If there are running sessions, use the dcv close-session Amazon DCV command to stop them.

  3. After you confirm that there are no running sessions, stop the Amazon DCV server. For more information, see Stopping the Amazon DCV Server.

  4. Back up your Amazon DCV server configuration. Copy the /etc/dcv/dcv.conf file to a safe location.

  5. Follow the steps described in Install the Amazon DCV Server.

  6. After the installation is complete, confirm that the Amazon DCV server configuration is still correct. Open the file that you copied in step 4 and compare it to the /etc/dcv/dcv.conf file.

  7. Test the Amazon DCV server by starting a new Amazon DCV session. For more information, see Starting Amazon DCV sessions.