# User-provisioned DNS requirements

This section covers the host entries that need to be made in the base domain to enable installation of Red Hat OpenShift Container Platform 4.9.

Red Hat OpenShift Container Platform 4.9 uses three types of DNS records (A, CNAME, and SRV). The host names and their types are described in Table 20.

Table 20. DNS entries for Red Hat OpenShift Container Platform

Hosts DNS Record Types
master_nodes A
worker_nodes A
bootstrap_nodes A
installer VM A
*, api, api-int, haproxy A
Etcd CNAME, SRV

To add the appropriate records, follow these steps:

  1. 'A' type resource record [ Host (A) ]. An A record specifies an IPv4 address. Example entries are shown in Table 21. Ensure that these entries are created for all the nodes in the installation environment.

    Table 21. 'A' type DNS entry

    Host (A) IP Address Host name
    master_nodes master_ip master_name.cluster_name.baseDomain
    worker_nodes worker_ip worker_name.cluster_name.baseDomain
    bootstrap_nodes bootstrap_ip bootstrap_name.cluster_name.baseDomain
    installer VM installer_ip installer_name.cluster_name.baseDomain
    * haproxy_ip *.apps.cluster_name.baseDomain
    Api haproxy_ip api.cluster_name.baseDomain
    api-int haproxy_ip api-int.cluster_name.baseDomain
    haproxy haproxy_ip haproxy_name.cluster_name.baseDomain
  2. Create a CNAME resource record [ Alias (CNAME) ] in DNS. Example entries are shown in Table 22. Ensure that these entries are created for all of the master nodes.

    Table 22. DNS entries for Red Hat OpenShift Container Platform

    Host (CNAME) Target host name
    etcd-0 *master01_name.cluster_name.baseDomain
    etcd-1 *master02_name.cluster_name.baseDomain
    etcd-2 *master03_name.cluster_name.baseDomain

NOTE

Replace the italicized components in the examples above with the actual values that align to the installation environment.

  1. For each master node, Red Hat OpenShift Container Platform also requires a Service Location (SRV) DNS record for the etcd server on that machine with priority 0, weight 10, and port 2380. The SRV record is used to identify computers that host specific services.