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).

Viewing NICE DCV sessions

The administrator on a Windows NICE DCV server or the root user on a Linux NICE DCV server can view all active sessions that are running on the server. NICE DCV users can only view sessions that they have created.

List all active sessions

To list the active console or virtual sessions on a Windows or Linux NICE DCV server, use the dcv list-sessions command.

Syntax

dcv list-sessions

Output

The command returns a list of active sessions in the following format.

Session: session-id (owner:session-owner type:virtual|console name:'my session')

View information about a specific session

To view information about a session, use the dcv describe-session command and specify the unique session ID.

Syntax

$ dcv describe-session session_id

Output

In the following example output, the display-layout element indicates that the session's display layout is set to use two 800x600 screens. Of these, the second screen is offset to x=800 (to the right) of the first screen.

Session: test
  owner: session-id
  name: session-name
  x display: :1
  x authority: /run/user/1009/dcv/test.xauth
  display layout: 800x600+0+0,800x600+800+0

You can also include the --json (or -j) option to force the command to return the output in JSON format. The JSON output provides additional details about the session.

$ dcv describe-session session-id --json

The following is example JSON output.

{
  "id" : "session-id",
  "owner" : "dcvuser",
  "name" : "session-name",
  "num-of-connections" : 0,
  "creation-time" : "2020-03-02T16:08:50Z",
  "last-disconnection-time" : "",
  "licenses" : [
    {
      "product" : "dcv",
      "status" : "licensed",
      "check-timestamp" : "2020-03-02T16:08:50Z",
      "expiration-date" : "2020-03-29T00:00:00Z"
    },
    {
      "product" : "dcv-gl",
      "status" : "licensed",
      "check-timestamp" : "2020-03-02T16:08:50Z",
      "expiration-date" : "2020-03-29T00:00:00Z"
    }
  ],
  "storage-root" : "",
  "type" : "virtual",
  "x11-display" : ":2",
  "x11-authority" : "/run/user/1009/dcv/vsession.xauth",
  "display-layout" : [
    {
      "width" : 800,
      "height" : 600,
      "x" : 0,
      "y" : 0
    },
    {
      "width" : 800,
      "height" : 600,
      "x" : 800,
      "y" : 0
    }
  ]
}