User-Defined Host Entries Configuration

You can configure user-defined host entries for external resources that are not maintained by DNS records resolvable by the external DNS server(s) (i.e. nameservers in system dns-show/dns-modify). This functionality enables the configuration of local host records, supplementing hosts resolvable by external DNS server(s).

User-defined host entries can be configured at bootstrap time and/or post-deployment.

The following methods are enabled to configure user host records/entries.

Configure User-Defined Host Entries During Bootstrap

During the bootstrap phase, update the Ansible playbook override file, localhost.yaml <hostname.yaml>, with the following data within the user_dns_host_records section.

To add host records, use the following command syntax:

user_dns_host_records:
  <host-record-name>: <fqdn>[,<fqdn>...],[<IPv4-address>],[<IPv6-address>][,<TTL>]

Where, TTL can be optionally provided and fqdn = fully qualified domain name.

For example:

user_dns_host_records:
  test-server: example.com,192.168.0.1,1234::100,300
  host1: host,example2.com,127.0.0.1

Note

Upon system initialization, you can observe that data has been updated within the system database, and it can be listed using the system CLI.

Configure User-Defined Host Entries via System Inventory API/CLI

After system deployment, update host records using the CLI. Source the script /etc/platform/openrc to obtain administrative privileges and use the following procedure:

Procedure

  1. Use the following command syntax to add the parameter.

    system service-parameter-add dns host-record <host-record-name>=<fqdn>[,<fqdn>...],[<IPv4-address>],[<IPv6-address>][,<TTL>]
    system service-parameter-apply dns
    

    Where fqdn = fully qualified domain name.

    For example:

    system service-parameter-add dns host-record test-server1=host1,testserver1.com,127.0.0.1
    
    ../../_images/add-parameter.png
  2. Use the following command syntax to modify the parameter.

    system service-parameter-modify dns host-record <host-record-name>:<fqdn>[,<fqdn>...],[<IPv4-address>],[<IPv6-address>][,<TTL>]
    system service-parameter-apply dns
    

    Where fqdn = fully qualified domain name.

    The following example shows the command syntax to add another DNS name for the existing host entry.

    Example:

    system service-parameter-modify dns host-record test-server1=host1,host,testserver1.com,127.0.0.1
    
    ../../_images/modify-parameter.png
  3. Follow the steps below to delete the parameter.

    1. Run the command to display the service parameter list for host-record service-parameter type.

      system service-parameter-list | grep host-record
      

      Copy the UUID of the parameter that needs to be deleted.

    2. Run the command to delete the entry.

      system service-parameter-delete <uuid>
      

      For example:

      system service-parameter-delete  a24e147f-2d13-4d7b-a8e7-47a1d77b95b5