Setting the Hostname Prefix for a Desktop Pool

Set a custom hostname prefix used for desktops in Secure Desktops.

During desktop pool creation, an OCI compute instance is created for each desktop in the pool. For each instance, a hostname is automatically set in the format <prefix>-<32-bit hash>.

Where:
  • <prefix> is a hostname prefix specified by the administrator through a desktop pool tag. The default value is sd.
  • <32-bit hash> is an 8-character hexadecimal number based on the OCID of the desktop instance.

For example:

oci:desktops:hostname=sd-20b2c2fb

To specify a custom prefix, add the following tag when creating the desktop pool from the Secure Desktops administrator console:

oci:desktops:hostname_prefix=<prefix>

where <prefix> is a 1-6 character alphanumeric string.
  • The first character must be alphabetic.
  • Special characters are not allowed.
  • If the prefix specified is invalid, it is rejected.

To add this tag, DNS must be enabled for your VCN and subnet. Otherwise, the request fails with the following error message:

The hostname prefix cannot be set when DNS is not enabled

If you choose not to add the tag, the desktop pool uses the following defaults:
  • If DNS is enabled for your VCN and subnet, desktops launch using the default hostname prefix sd.
  • If DNS is not enabled for your VCN and subnet, desktops launch using hostname desktopocid1.
Note

For more information about adding tags to desktop pools, see Secure Desktops Tags.

Was this article helpful?