Host configuration file

This page describes the fields in a host configuration file.

You use a host configuration file to describe a set of host machines and the network that the host machines are on. Here are some examples of how you would use a host configuration file:

  • List the hostnames and static IP addresses for the nodes in your admin cluster.

  • List the hostnames and static IP addresses for the nodes in a user cluster.

  • List the hostnames and static IP addresses for the VMs that run the bundled Seesaw load balancer for your admin cluster.

  • List the hostnames and static IP addresses for the VMs that run the bundled Seesaw load balancer for a user cluster.

Filling in the fields in a host configuration file

In your configuration file, enter fields values as described in the following sections.

hostconfig

This section holds information about the DNS and time servers for the host machines.

hostconfig.dns

String. The address of the DNS server that the hosts use. For example:

hostconifg:
  dns: "172.16.255.1"

hostconifg.tod

String. The address of the time server that the hosts use. For example:

hostconfig:
  tod: "216.239.35.0"

hostconifg.otherdns

Array of strings. Additional DNS servers that the hosts can use. For example:

hostconifg:
  otherdns:
  - "8.8.8.8"
  - "8.8.4.4"

hostconfig.othertod

Array of strings. Additional time servers that the hosts can use. For example:

hostconfig:
  othertod:
  - "ntp.ubuntu.com"

hostconfig.searchdomainsfordns

Array of strings. DNS search domains to use in the cluster. These domains are used as part of a domain search list. For example:

hostconfig:
  searchdomainsfordns:
  - "my.local.com"

blocks

An array of objects, each of which describes a set of hosts.

blocks[i].netmask

String. The subnet mask for the set of hosts. For example:

blocks:
- netmask: "255.255.252.0"

blocks[i].gateway

String. The address of the default gateway for the set of hosts. For example:

blocks:
- netmask: "255.255.252.0"
  gateway: "172.16.23.254"

blocks[i].ips

An array of objects, each of which has an IP address and a hostname. For example:

blocks:
- netmask: "255.255.252.0"
  ips:
  - ip: 172.16.20.10
    hostname: admin-host1
  - ip: 172.16.20.11
    hostname: admin-host2
  - ip: 172.16.20.12
    hostname: admin-host3

Example host configuration file

Here is an example of a host configuration file with five hosts:

hostconfig:
  dns: 172.16.255.1
  tod: 216.239.35.0
  otherdns:
  - 8.8.8.8
  - 8.8.4.4
  othertod:
  - ntp.ubuntu.com
  searchdomainsfordns:
  - "my.local.com"
blocks:
  - netmask: 255.255.252.0
    gateway: 172.16.23.254
    ips:
    - ip: 172.16.20.10
      hostname: admin-host1
    - ip: 172.16.20.11
      hostname: admin-host2
    - ip: 172.16.20.12
      hostname: admin-host3
    - ip: 172.16.20.13
      hostname: admin-host4
    - ip: 172.16.20.14
      hostname: admin-host5