Version 1.4. This version is no longer supported. For more information see the version support policy.

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.

Click to see a template for a host configuration file.

hostconfig:
  dns: ""
  tod: ""
  otherdns:
  - ""
  ...
  othertod:
  - ""
  ...
  searchdomainsfordns:
  - ""
  ...
blocks:
  - netmask: ""
    gateway: ""
    ips:
    - ip: ""
      hostname: ""
    ...

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