Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Preferences
Contact Us
Feedback
AWS Documentation
Create an AWS Account

Step 2: Set up the Amazon DCV Session Manager broker

PDF
RSS
Focus mode
Step 2: Set up the Amazon DCV Session Manager broker - Amazon DCV Session Manager

The broker must be installed on a Linux host. For more information about the supported Linux distributions, see Amazon DCV Session Manager requirements. Install the broker on a host that is separate from the agent and the Amazon DCV server host. The host can be installed on a different private network, but it must be able to connect to and communicate with the agent.

To install and start the broker

  1. Connect to the host on which you intend to install the broker.

  2. The packages are digitally signed with a secure GPG signature. To allow the package manager to verify the package signature, you must import the Amazon DCV GPG key. Run the following command to import the Amazon DCV GPG key.

    • Amazon Linux 2, RHEL, CentOS, and Rocky Linux

      $ sudo rpm --import https://d1uj6qtbmh3dt5.cloudfront.net/NICE-GPG-KEY

    • Ubuntu

      $ wget https://d1uj6qtbmh3dt5.cloudfront.net/NICE-GPG-KEY
      $ gpg --import NICE-GPG-KEY

  3. Download the installation package.

    • Amazon Linux 2

      $ wget https://d1uj6qtbmh3dt5.cloudfront.net/2024.0/SessionManagerBrokers/nice-dcv-session-manager-broker-2024.0.504-1.el7.noarch.rpm

    • Amazon Linux 2023

      $ wget https://d1uj6qtbmh3dt5.cloudfront.net/2024.0/SessionManagerBrokers/nice-dcv-session-manager-broker-2024.0.504-1.amzn2023.noarch.rpm

    • RHEL 8.x, and Rocky Linux 8.x

      $ wget https://d1uj6qtbmh3dt5.cloudfront.net/2024.0/SessionManagerBrokers/nice-dcv-session-manager-broker-2024.0.504-1.el8.noarch.rpm

    • CentOS 9.x, RHEL 9.x, and Rocky Linux 9.x

      $ wget https://d1uj6qtbmh3dt5.cloudfront.net/2024.0/SessionManagerBrokers/nice-dcv-session-manager-broker-2024.0.504-1.el9.noarch.rpm

    • Ubuntu 20.04

      $ wget https://d1uj6qtbmh3dt5.cloudfront.net/2024.0/SessionManagerBrokers/nice-dcv-session-manager-broker_2024.0.504-1_all.ubuntu2004.deb

    • Ubuntu 22.04

      $ wget https://d1uj6qtbmh3dt5.cloudfront.net/2024.0/SessionManagerBrokers/nice-dcv-session-manager-broker_2024.0.504-1_all.ubuntu2204.deb

    • Ubuntu 24.04

      $ wget https://d1uj6qtbmh3dt5.cloudfront.net/2024.0/SessionManagerBrokers/nice-dcv-session-manager-broker_2024.0.504-1_all.ubuntu2404.deb

  4. Install the package.

    • Amazon Linux 2

      $ sudo yum install -y ./nice-dcv-session-manager-broker-2024.0.504-1.el7.noarch.rpm

    • Amazon Linux 2023

      $ sudo yum install -y ./nice-dcv-session-manager-broker-2024.0.504-1.amzn2023.noarch.rpm

    • RHEL 8.x and Rocky Linux 8.x

      $ sudo yum install -y ./nice-dcv-session-manager-broker-2024.0.504-1.el8.noarch.rpm

    • CentOS 9.x, RHEL 9.x, and Rocky Linux 9.x

      $ sudo yum install -y ./nice-dcv-session-manager-broker-2024.0.504-1.el9.noarch.rpm

    • Ubuntu 20.04

      $ sudo apt install -y ./nice-dcv-session-manager-broker_2024.0.504-1_all.ubuntu2004.deb

    • Ubuntu 22.04

      $ sudo apt install -y ./nice-dcv-session-manager-broker_2024.0.504-1_all.ubuntu2204.deb

    • Ubuntu 24.04

      $ sudo apt install -y ./nice-dcv-session-manager-broker_2024.0.504-1_all.ubuntu2404.deb

  5. Check that the default Java environment version is 11

    $ java -version

    If not, you can explicitly set the Java home directory that the broker will use to target the right Java version. This is done setting the parameter broker-java-home in the broker configuration file. For more information, see broker Configuration File.

  6. Start the broker service and ensure that it starts automatically every time the instance starts.

    $  sudo systemctl start dcv-session-manager-broker && sudo systemctl enable dcv-session-manager-broker

  7. Place a copy of the broker's self-signed certificate in your user directory. You'll need it when you install the agents in the next step.

    sudo cp /var/lib/dcvsmbroker/security/dcvsmbroker_ca.pem $HOME
PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.