Connecting to a Amazon DCV session using the Windows client
The steps for connecting to a Amazon DCV session are the same for both the installable and portable versions of the Windows client.
To connect to a session using the Windows client
Launch the Windows client.
-
Choose Connections Settings, configure your proxy settings as follows, and then choose OK.
To avoid connecting through a proxy, choose Connect Directly.
To connect to the Amazon DCV server using your preconfigured operating system proxy settings, choose Use system proxy.
To connect to the Amazon DCV server through a specific HTTP proxy server, choose Get through web proxy. Specify the IP address and communication port or the hostname of the proxy server. If the HTTP proxy server requires authentication, select the Proxy server requiring password check box and enter your sign-in credentials.
To connect to the Amazon DCV server through a specific SOCKS5 proxy server, choose Get through SOCKSv5 proxy. Specify the IP address and communication port or the hostname of the proxy server. If the SOCKSv5 proxy server requires authentication, select the Proxy server requiring password check box and enter your sign-in credentials.
-
To select the transport protocol to use for data transport, choose the Protocol tab. By default, the client uses the QUIC protocol (based on UDP) for data transport if it's available. If it isn't available, the client uses the WebSocket protocol (based on TCP). This option is always available.
QUIC is available only if the two following conditions are met. First, the Amazon DCV server is configured to support it. Second, your network configuration supports UDP communication between the Amazon DCV client and the Amazon DCV server. Additionally, it's only supported for direct client-server communication where there are no intermediate proxies, gateways, or load balancers.
You can force the client to use a data transport protocol by explicitly selecting it. To verify which protocol is in use, check the Streaming Modes dialog. Additionally, if the QUIC protocol is in use, "QUIC" appears in the titlebar.
For more information and instructions, see Enable the QUIC UDP transport protocol in the Amazon DCV Administrator Guide.
-
Specify the session details in the following format:
server_hostname_or_IP
:port
#session_id
In the following example, the command connects to a session that's named
my-session
. This session is hosted on a Amazon DCV server with the hostnamemy-dcv-server.com
. It's connected over port8443
.my-dcv-server.com:8443#my-session
Choose Connect.
-
Enter sign-in credentials and choose Login.
Note
By default, the connection is terminated after three unsuccessful login attempts. To try again, restart the connection.
If you're prompted to verify the server's certificate, confirm the certificate's fingerprint with your Amazon DCV administrator. If the fingerprint is valid, choose Trust & Connect.