7.4. Remote Desktop Client (RDC)

7.4.1. About the Bundled RDP Broker
7.4.2. How to Access Desktops with Microsoft RDC

7.4.1. About the Bundled RDP Broker

Oracle VDI includes a built-in RDP broker that enables easy desktop access leveraging the Remote Desktop Protocol (RDP). This way users can take advantage of existing RDP clients (for example, the remote desktop connection in Windows XP) for accessing desktops. How Does it Work?

  1. The RDP client first contacts the Oracle VDI RDP broker (passing over any information like username, password, etc).

  2. The RDP broker will then contact the Oracle VDI service on behalf of the client and will ask to startup the desired desktop.

  3. The Oracle VDI service will first verify the username/password combination if client authentication is enabled on the service side (default), see Section 7.2.7, “How to Disable Client Authentication”.

  4. If authentication succeeds, the corresponding desktop will be started up and the Oracle VDI service returns the IP and optionally RDP port of the virtual machine (VM) running the desktop.

  5. This information is used by the RDP broker to construct an RDP Server Redirection Packet containing either:

    • the VM host/IP address as the server to redirect to (if using Windows RDP, as done for VMware Infrastructure 3)

    • or a routing token containing encoded IP address and RDP port information (if using Oracle VM VirtualBox RDP, also known as VRDP)

      The latter is necessary, because VRDP does not use the standard Windows RDP port. Thus the RDP broker needs to hand back both the IP and the RDP port information. For details of the routing token encoding, see the "Routing Token Format" section of Session Directory and Load Balancing Using Terminal Server; see: http://download.microsoft.com/download/8/6/2/8624174c-8587-4a37-8722-00139613a5bc/TS_Session_Directory.doc.

  6. Finally, this RDP redirection packet is sent back to the RDP client and the client will redirect accordingly. Supported RDP Clients

RDP clients that support all the above mentioned mechanism and that have been tested with Oracle VDI are:

  • The Microsoft RDP client (also known as remote desktop connection)

  • The Sun Ray Windows connector (also known as uttsc)

  • The Oracle Secure Global Desktop Remote Desktop Client (also known as ttatsc)

Other clients may work, but have not been tested by QA. Examples With Uttsc

To connect to any machine from a pool, run the following.

/opt/SUNWuttsc/bin/uttsc -u username::pool=poolname \
-d domain IP of broker -- any secondary server

To connect to a specific desktop, run the following.

/opt/SUNWuttsc/bin/uttsc -u username::pool=poolname,desktop=desktopId \
-d domainIP of broker -- any secondary server Security Considerations

Oracle VDI authenticates users each time they sign into their desktop. If you would prefer to disable this feature, refer to the Section 7.2.7, “How to Disable Client Authentication” section.

7.4.2. How to Access Desktops with Microsoft RDC

Oracle VDI includes a built-in RDP broker that allows easy desktop access leveraging the Remote Desktop Protocol (RDP). This way users can take advantage of existing Windows PCs for accessing desktops. There is typically no need to install any additional software on your PC. Both Windows XP and Windows Vista provide out of the box the necessary functionality. The following screenshots illustrate how to access a desktop from an end-user perspective using Windows XP.


  1. Click on Start, All Programs, Accessories, Remote Desktop Connection.

  2. In the dialog, specify as Computer the name, or IP address of the host running the Oracle VDI.

  3. Specify the user name, and optionally Windows domain. Click Connect.

  4. A popup dialog will come up asking for the user password. Enter the password and click OK.

  5. After a while, the desktop should be displayed, and be ready to use.

    Figure 7.11. Microsoft RDC Connection

    Screen capture showing the Remote Desktop Connection option selected in the Windows Start menu and the Remote Desktop Connection dialog.

    The remote desktop connection on your computer might be configured for performance optimization. Thus certain elements like desktop background, theming, menu and window animations might not be displayed in your setup. You can easily adapt these settings (see Experience tab of the remote desktop connection) to meet your personal requirements.

Accessing a Specific Desktop or Pool

If multiple desktops are assigned to a user, then the Oracle VDI connects to the user's default desktop, which can be defined using Oracle VDI Manager.

Alternatively, it is possible to specify the desired desktop or pool when opening the remote desktop connection. To do this, enter the user name, followed by the pool name, and the optional desktop ID using the following syntax:


It is usually sufficient to just specify the pool name. However, if you have multiple desktops assigned from the same pool, you must specify both the pool name and the desktop ID. Desktop identifiers can be listed via the Oracle VDI CLI executing /opt/SUNWvda/sbin/vda user-desktops username

Figure 7.12. Specifying Pool Name and Desktop ID for Microsoft RDC

Screen capture of the Microsoft RDC dialog showing how to specify the pool name and desktop ID.

If you frequently switch between various desktops, then it is convenient to store the remote desktop connection settings for each desktop in an RDP file, using the Save As button in Connection Settings. You can then create shortcuts to these files allowing you to initiate a connection via a simple mouse double-click.