Updating Instance Settings

You can update the connection parameters and Desktop properties for manually added instances from the Instance Settings dialog.

Click the cogwheel icon () next to the name or right-click and select Instance Settings from the pop-up menu.

Instance Settings - Configuration tab

Connection Parameters

The URL to start the Desktop is specified in the following format:

<protocol>://<ip address or hostname>:<port>/launch/desktop

The protocol can be either http or https.

Configuration Tab

Each instance that you have added to the Desktop Launcher can be configured with a set of properties that control display and behavior. The properties are displayed in the Properties list in the Configuration tab.

In the left column, there are grayed out values. These are set in the Platform Container and fetched by the Desktop Launcher. Enter a new value in a field to override its initial value. To revert back to the initial values, clear all text in the field.

You can also add properties that are not already set in the Platform Container by using the rows at the bottom of the table.

For a complete list of properties, see Desktop Properties.

Security Tab

The Security tab contains settings related to digital certificates that are required for a secure connection, via HTTPS, and the cryptographic key that is required when client authentication is enabled for the Platform.

Instance Settings - Security tab

The Platform Certificate Chain field contains a certificate downloaded from the Platform. This field is for information only.

The first time that you establish a secure connection to the Platform, the Trusted Certificates field is populated automatically. If the certificate from the Platform changes, you are prompted to accept the new certificate. Alternatively, right-click on the downloaded certificate and select Add As Trusted Certificate.

When client authentication is enabled, you must import a key in the Client Key field. You can import the key from a keystore file or you may copy the key from an existing instance in the Desktop Launcher.

Importing Key from File

  1. Right-click on the field and select Import Key from File

  2. Select the keystore file and click OK

  3. Enter the password at the prompt. 

Copy Key from Existing Instance or Launcher Service

  1. Right-click the Client Key field and select Copy Key From Instance or Copy from Service. 

  2. Select a name of an instance or launcher service from the sub-menu.

For further information about security settings and how to enable client authentication, see Network Security.