Advanced Cluster Options
Also available as:
PDF

Custom hostnames inside a cluster

Cloudbreak maintains an internal DNS server and allows you to specify a custom hostname and a custom domain name.

Cloudbreak maintains an internal DNS server (using Unbound) with entries for all hosts in the cluster. In this setup, only the internal DNS is configured to allow internal communication between the nodes of the same cluster. Queries that the internal DNS cannot resolve are automatically forwarded to the cloud provider’s nameserver. The DNS server is distributed in a sense that each of the VMs is running one server with the correct entries, so there is no single point of failure.

By default, the internal FQDNs are inherited from the cloud provider’s DNS server. You can optionally change the hostname prefix and the domain by specifying them as parameters in your cluster CLI JSON.

If you would like to specify a custom hostname and a custom domain name, add the following entries to the CLI JSON at the top level of the JSON, replacing the [$DOMAIN_NAME] and [$HOST_NAME_PATTERN] with actual values:
"customDomain": {
    "customDomain": "[$DOMAIN_NAME]",
    "customHostname": "[$HOST_NAME_PATTERN]"
  }
For example:
 "customDomain": {
    "customDomain": "hortonworks.local",
    "customHostname": "test"
  },

When these parameters are provided in the CLI JSON, VM FQDNs are generated based on the values specified. For the values included in the example, these FQDNs are “test0.hortonworks.local”, “test1.hortonworks.local”, “test2.hortonworks.local”, and so on.