# 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.6.

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

Table 17. 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 18. Ensure that these entries are created for all the nodes in the installation environment.

Table 18. 'A' type DNS entry

Host (A) IP Address Host name
master_nodes master_ip master_nam
e.cluster_name.baseDomain
worker_nodes worker_ip worker_nam
e.cluster_name.baseDomain
bootstrap_nodes bootstrap_ip bootstrap_nam
e.cluster_name.baseDomain
installer VM installer_ip installer_nam
e.cluster_name.baseDomain
* haproxy_ip *.app
s.cluster_name.baseDomain
api haproxy_ip ap
i.cluster_name.baseDomain
api-int haproxy_ip api-in
t.cluster_name.baseDomain
haproxy haproxy_ip haproxy_nam
e.cluster_name.baseDomain

2.Create a CNAME resource record [ Alias (CNAME) ] in DNS. Example entries are shown in Table 19. Ensure that these entries are created for all of the master nodes.

Table 19. 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. Figure 37 shows the creation of a SRV record.
  • Creating an SRVrecord

Figure 37. Creating a SRV record