1.1.1.3 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 then select Instance Settings from the pop-up menu.

Instance Settings - Properties 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.

Properties Tab

Each instance that you have added to the Desktop Launcher can be configured with a set of properties that control display and behavior. To update the properties, select the Properties tab.

The values that are grayed out are set in the Platform Container and fetched by 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  the bottom of the table.

For a complete list of properties, see 2.6.9 Desktop Properties in the System Administrator's Guide.

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 on 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 will be populated automatically. If the certificate from the Platform changes, you will be 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 then click OK
  3. Enter the password at the prompt. 

Copy Key from Existing Instance or Launcher Service

  1. Right-click on 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 4. Network Security in the System Administrator's Guide.