Step 1: Prepare the Amazon DCV servers - Amazon DCV Session Manager
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).

Step 1: Prepare the Amazon DCV servers

You must have a fleet of Amazon DCV servers with which you intend to use Session Manager. For more information about installing Amazon DCV servers, see Installing the Amazon DCV server in the Amazon DCV Administrator Guide.

On Linux Amazon DCV servers, Session Manager uses a local service user named dcvsmagent. This user is automatically created when the Session Manager agent is installed. You must grant this service user administrator privileges for Amazon DCV so that it can perform actions on behalf of other users. To grant the Session Manager service user administrator privileges, do the following:

To add the local service user for Linux Amazon DCV servers

  1. Open /etc/dcv/dcv.conf using your preferred text editor.

  2. Add the administrators parameter to the [security] section and specify the Session Manager user. For example:

    [security]
administrators=["dcvsmagent"]

  3. Save and close the file.

  4. Stop and restart the Amazon DCV server.

Session Manager is only able to create Amazon DCV sessions on behalf of users that already exist on the Amazon DCV server. If a request is made to create a session for a user that doesn't exist, the request fails. Therefore, you must ensure that each intended end user has a valid system user on the Amazon DCV server.

Tip

If you intend to use multiple broker hosts or Amazon DCV servers with agents, we recommend that you configure only one broker and one Amazon DCV server with an agent by performing the following steps, creating Amazon Machine Images (AMI) of the hosts with the completed configurations, and then using the AMIs to launch the remaining brokers and Amazon DCV servers. Alternatively, you can use Amazon Systems Manager to run the commands on multiple instances remotely.