Oracle Cloud Infrastructure Documentation

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 Tag Reference.