OpenShift Container Platform-4.4-Installing On Bare metal-en-US
OpenShift Container Platform-4.4-Installing On Bare metal-en-US
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons
Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is
available at
http://creativecommons.org/licenses/by-sa/3.0/
. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must
provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert,
Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift,
Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States
and other countries.
Linux ® is the registered trademark of Linus Torvalds in the United States and other countries.
XFS ® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States
and/or other countries.
MySQL ® is a registered trademark of MySQL AB in the United States, the European Union and
other countries.
Node.js ® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the
official Joyent Node.js open source or commercial project.
The OpenStack ® Word Mark and OpenStack logo are either registered trademarks/service marks
or trademarks/service marks of the OpenStack Foundation, in the United States and other
countries and are used with the OpenStack Foundation's permission. We are not affiliated with,
endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
Abstract
This document provides instructions for installing OpenShift Container Platform 4.4 clusters on
bare metal infrastructure.
Table of Contents
Table of Contents
.CHAPTER
. . . . . . . . . . 1.. .INSTALLING
. . . . . . . . . . . . . ON
. . . . BARE
. . . . . . METAL
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4. . . . . . . . . . . . .
1.1. INSTALLING A CLUSTER ON BARE METAL 4
1.1.1. Internet and Telemetry access for OpenShift Container Platform 4
1.1.2. Machine requirements for a cluster with user-provisioned infrastructure 5
1.1.2.1. Required machines 5
1.1.2.2. Network connectivity requirements 5
1.1.2.3. Minimum resource requirements 5
1.1.2.4. Certificate signing requests management 5
1.1.3. Creating the user-provisioned infrastructure 6
1.1.3.1. Networking requirements for user-provisioned infrastructure 6
Network topology requirements 7
1.1.3.2. User-provisioned DNS requirements 8
1.1.4. Generating an SSH private key and adding it to the agent 10
1.1.5. Obtaining the installation program 11
1.1.6. Installing the CLI by downloading the binary 12
1.1.7. Manually creating the installation configuration file 12
1.1.7.1. Sample install-config.yaml file for bare metal 13
1.1.7.2. Configuring the cluster-wide proxy during installation 15
1.1.7.3. Running a three-node cluster 17
1.1.8. Creating the Kubernetes manifest and Ignition config files 17
1.1.9. Creating Red Hat Enterprise Linux CoreOS (RHCOS) machines 18
1.1.9.1. Creating Red Hat Enterprise Linux CoreOS (RHCOS) machines using an ISO image 19
1.1.9.2. Creating Red Hat Enterprise Linux CoreOS (RHCOS) machines by PXE or iPXE booting 20
1.1.10. Creating the cluster 22
1.1.11. Logging in to the cluster 23
1.1.12. Approving the CSRs for your machines 24
1.1.13. Initial Operator configuration 25
1.1.13.1. Image registry removed during installation 26
1.1.13.2. Image registry storage configuration 26
1.1.13.2.1. Configuring registry storage for bare metal 26
1.1.13.2.2. Configuring storage for the image registry in non-production clusters 27
1.1.14. Completing installation on user-provisioned infrastructure 28
1.2. INSTALLING A CLUSTER ON BARE METAL WITH NETWORK CUSTOMIZATIONS 30
1.2.1. Internet and Telemetry access for OpenShift Container Platform 30
1.2.2. Machine requirements for a cluster with user-provisioned infrastructure 31
1.2.2.1. Required machines 31
1.2.2.2. Network connectivity requirements 31
1.2.2.3. Minimum resource requirements 31
1.2.2.4. Certificate signing requests management 32
1.2.3. Creating the user-provisioned infrastructure 32
1.2.3.1. Networking requirements for user-provisioned infrastructure 32
Network topology requirements 33
1.2.3.2. User-provisioned DNS requirements 34
1.2.4. Generating an SSH private key and adding it to the agent 36
1.2.5. Obtaining the installation program 37
1.2.6. Installing the CLI by downloading the binary 38
1.2.7. Manually creating the installation configuration file 39
1.2.7.1. Sample install-config.yaml file for bare metal 39
1.2.7.2. Network configuration parameters 41
1.2.8. Modifying advanced network configuration parameters 42
1.2.9. Cluster Network Operator configuration 43
1
OpenShift Container Platform 4.4 Installing on bare metal
2
Table of Contents
3
OpenShift Container Platform 4.4 Installing on bare metal
IMPORTANT
While you might be able to follow this procedure to deploy a cluster on virtualized or cloud
environments, you must be aware of additional considerations for non-bare metal
platforms. Review the information in the guidelines for deploying OpenShift Container
Platform on non-tested platforms before you attempt to install an OpenShift Container
Platform cluster in such an environment.
Prerequisites
Review details about the OpenShift Container Platform installation and update processes.
If you use a firewall, you must configure it to allow the sites that your cluster requires access to.
NOTE
Be sure to also review this site list if you are configuring a proxy.
Access the Red Hat OpenShift Cluster Manager page to download the installation program and
perform subscription management and entitlement. If the cluster has internet access and you
do not disable Telemetry, that service automatically entitles your cluster. If the Telemetry
service cannot entitle your cluster, you must manually entitle it on the Cluster registration page.
Access Quay.io to obtain the packages that are required to install your cluster.
IMPORTANT
If your cluster cannot have direct internet access, you can perform a restricted network
installation on some types of infrastructure that you provision. During that process, you
download the content that is required and use it to populate a mirror registry with the
packages that you need to install a cluster and generate the installation program. With
some installation types, the environment that you install your cluster in will not require
internet access. Before you update the cluster, you update the content of the mirror
registry.
4
CHAPTER 1. INSTALLING ON BARE METAL
The smallest OpenShift Container Platform clusters require the following hosts:
At least two compute machines, which are also known as worker machines
NOTE
The cluster requires the bootstrap machine to deploy the OpenShift Container Platform
cluster on the three control plane machines. You can remove the bootstrap machine after
you install the cluster.
IMPORTANT
To maintain high availability of your cluster, use separate physical hosts for these cluster
machines.
The bootstrap, control plane, and compute machines must use the Red Hat Enterprise Linux CoreOS
(RHCOS) as the operating system.
Note that RHCOS is based on Red Hat Enterprise Linux 8 and inherits all of its hardware certifications
and requirements. See Red Hat Enterprise Linux technology capabilities and limits .
All the Red Hat Enterprise Linux CoreOS (RHCOS) machines require network in initramfs during boot
to fetch Ignition config files from the Machine Config Server. During the initial boot, the machines
require either a DHCP server or that static IP addresses be set in order to establish a network
connection to download their Ignition config files.
5
OpenShift Container Platform 4.4 Installing on bare metal
Because your cluster has limited access to automatic machine management when you use infrastructure
that you provision, you must provide a mechanism for approving cluster certificate signing requests
(CSRs) after installation. The kube-controller-manager only approves the kubelet client CSRs. The
machine-approver cannot guarantee the validity of a serving certificate that is requested by using
kubelet credentials because it cannot confirm that the correct machine issued the request. You must
determine and implement a method of verifying the validity of the kubelet serving certificate requests
and approving them.
Prerequistes
Review the OpenShift Container Platform 4.x Tested Integrations page before you create the
supporting infrastructure for your cluster.
Procedure
4. Configure DNS.
All the Red Hat Enterprise Linux CoreOS (RHCOS) machines require network in initramfs during boot
to fetch Ignition config from the Machine Config Server.
During the initial boot, the machines require either a DHCP server or that static IP addresses be set on
each host in the cluster in order to establish a network connection, which allows them to download their
Ignition config files.
It is recommended to use the DHCP server to manage the machines for the cluster long-term. Ensure
that the DHCP server is configured to provide persistent IP addresses and host names to the cluster
machines.
The Kubernetes API server must be able to resolve the node names of the cluster machines. If the API
servers and worker nodes are in different zones, you can configure a default DNS search zone to allow
the API server to resolve the node names. Another supported approach is to always refer to hosts by
their fully-qualified domain names in both the node objects and all DNS requests.
You must configure the network connectivity between machines to allow cluster components to
communicate. Each machine must be able to resolve the host names of all other machines in the cluster.
6
CHAPTER 1. INSTALLING ON BARE METAL
TCP 9000- 9999 Host level services, including the node exporter on ports
9100- 9101 and the Cluster Version Operator on port9099.
10256 openshift-sdn
9000- 9999 Host level services, including the node exporter on ports
9100- 9101.
IMPORTANT
OpenShift Container Platform requires all nodes to have internet access to pull images
for platform containers and provide telemetry data to Red Hat.
Load balancers
Before you install OpenShift Container Platform, you must provision two layer-4 load balancers. The API
requires one load balancer and the default Ingress Controller needs the second load balancer to provide
ingress to applications.
7
OpenShift Container Platform 4.4 Installing on bare metal
NOTE
A working configuration for the Ingress router is required for an OpenShift Container
Platform cluster. You must configure the Ingress router after the control plane initializes.
The following DNS records are required for an OpenShift Container Platform cluster that uses user-
provisioned infrastructure. In each record, <cluster_name> is the cluster name and <base_domain> is
the cluster base domain that you specify in the install-config.yaml file. A complete DNS record takes
the form: <component>.<cluster_name>.<base_domain>..
8
CHAPTER 1. INSTALLING ON BARE METAL
IMPORTANT
9
OpenShift Container Platform 4.4 Installing on bare metal
# _service._proto.name.
TTL class SRV priority
weight port target.
_etcd-server-ssl._tcp.
<cluster_name>.
<base_domain>. 86400 IN
SRV 0 10 2380 etcd-
0.<cluster_name>.
<base_domain>
_etcd-server-ssl._tcp.
<cluster_name>.
<base_domain>. 86400 IN
SRV 0 10 2380 etcd-
1.<cluster_name>.
<base_domain>
_etcd-server-ssl._tcp.
<cluster_name>.
<base_domain>. 86400 IN
SRV 0 10 2380 etcd-
2.<cluster_name>.
<base_domain>
NOTE
You can use this key to SSH into the master nodes as the user core. When you deploy the cluster, the
key is added to the core user’s ~/.ssh/authorized_keys list.
NOTE
You must use a local key, not one that you configured with platform-specific approaches
such as AWS key pairs.
10
CHAPTER 1. INSTALLING ON BARE METAL
Procedure
1. If you do not have an SSH key that is configured for password-less authentication on your
computer, create one. For example, on a computer that uses a Linux operating system, run the
following command:
1 Specify the path and file name, such as ~/.ssh/id_rsa, of the SSH key.
Running this command generates an SSH key that does not require a password in the location
that you specified.
IMPORTANT
If you create a new SSH key pair, avoid overwriting existing SSH keys.
$ ssh-add <path>/<file_name> 1
1 Specify the path and file name for your SSH private key, such as ~/.ssh/id_rsa
Next steps
When you install OpenShift Container Platform, provide the SSH public key to the installation
program. If you install a cluster on infrastructure that you provision, you must provide this key to
your cluster’s machines.
Prerequisites
A computer that runs Linux or macOS, with 500 MB of local disk space
Procedure
1. Access the Infrastructure Provider page on the Red Hat OpenShift Cluster Manager site. If you
have a Red Hat account, log in with your credentials. If you do not, create an account.
2. Navigate to the page for your installation type, download the installation program for your
11
OpenShift Container Platform 4.4 Installing on bare metal
2. Navigate to the page for your installation type, download the installation program for your
operating system, and place the file in the directory where you will store the installation
configuration files.
IMPORTANT
The installation program creates several files on the computer that you use to
install your cluster. You must keep both the installation program and the files
that the installation program creates after you finish installing the cluster.
3. Extract the installation program. For example, on a computer that uses a Linux operating
system, run the following command:
4. From the Pull Secret page on the Red Hat OpenShift Cluster Manager site, download your
installation pull secret as a .txt file. This pull secret allows you to authenticate with the services
that are provided by the included authorities, including Quay.io, which serves the container
images for OpenShift Container Platform components.
IMPORTANT
If you installed an earlier version of oc, you cannot use it to complete all of the commands
in OpenShift Container Platform 4.4. Download and install the new version of oc.
Procedure
1. From the Infrastructure Provider page on the Red Hat OpenShift Cluster Manager site, navigate
to the page for your installation type and click Download Command-line Tools.
2. Click the folder for your operating system and architecture and click the compressed file.
NOTE
$ oc <command>
12
CHAPTER 1. INSTALLING ON BARE METAL
For installations of OpenShift Container Platform that use user-provisioned infrastructure, you must
manually generate your installation configuration file.
Prerequisites
Obtain the OpenShift Container Platform installation program and the access token for your
cluster.
Procedure
$ mkdir <installation_directory>
IMPORTANT
You must create a directory. Some installation assets, like bootstrap X.509
certificates have short expiration intervals, so you must not reuse an installation
directory. If you want to reuse individual files from another cluster installation,
you can copy them into your directory. However, the file names for the
installation assets might change between releases. Use caution when copying
installation files from an earlier OpenShift Container Platform version.
NOTE
3. Back up the install-config.yaml file so that you can use it to install multiple clusters.
IMPORTANT
The install-config.yaml file is consumed during the next step of the installation
process. You must back it up now.
You can customize the install-config.yaml file to specify more details about your OpenShift Container
Platform cluster’s platform or modify the values of the required parameters.
apiVersion: v1
baseDomain: example.com 1
compute:
- hyperthreading: Enabled 2 3
name: worker
replicas: 0 4
controlPlane:
hyperthreading: Enabled 5 6
name: master 7
replicas: 3 8
13
OpenShift Container Platform 4.4 Installing on bare metal
metadata:
name: test 9
networking:
clusterNetwork:
- cidr: 10.128.0.0/14 10
hostPrefix: 23 11
networkType: OpenShiftSDN
serviceNetwork: 12
- 172.30.0.0/16
platform:
none: {} 13
fips: false 14
pullSecret: '{"auths": ...}' 15
sshKey: 'ssh-ed25519 AAAA...' 16
1 The base domain of the cluster. All DNS records must be sub-domains of this base and include the
cluster name.
2 5 The controlPlane section is a single mapping, but the compute section is a sequence of mappings.
To meet the requirements of the different data structures, the first line of the compute section
must begin with a hyphen, -, and the first line of the controlPlane section must not. Although both
sections currently define a single machine pool, it is possible that future versions of OpenShift
Container Platform will support defining multiple compute pools during installation. Only one
control plane pool is used.
IMPORTANT
4 You must set the value of the replicas parameter to 0. This parameter controls the number of
workers that the cluster creates and manages for you, which are functions that the cluster does not
perform when you use user-provisioned infrastructure. You must manually deploy worker machines
for the cluster to use before you finish installing OpenShift Container Platform.
8 The number of control plane machines that you add to the cluster. Because the cluster uses this
values as the number of etcd endpoints in the cluster, the value must match the number of control
plane machines that you deploy.
10 A block of IP addresses from which Pod IP addresses are allocated. This block must not overlap
with existing physical networks. These IP addresses are used for the Pod network, and if you need
to access the Pods from an external network, configure load balancers and routers to manage the
traffic.
11 The subnet prefix length to assign to each individual node. For example, if hostPrefix is set to 23,
then each node is assigned a /23 subnet out of the given cidr, which allows for 510 (2^(32 - 23) - 2)
pod IPs addresses. If you are required to provide access to nodes from an external network,
configure load balancers and routers to manage the traffic.
14
CHAPTER 1. INSTALLING ON BARE METAL
12 The IP address pool to use for service IP addresses. You can enter only one IP address pool. If you
need to access the services from an external network, configure load balancers and routers to
13 You must set the platform to none. You cannot provide additional platform configuration variables
for bare metal infrastructure.
14 Whether to enable or disable FIPS mode. By default, FIPS mode is not enabled. If FIPS mode is
enabled, the Red Hat Enterprise Linux CoreOS (RHCOS) machines that OpenShift Container
Platform runs on bypass the default Kubernetes cryptography suite and use the cryptography
modules that are provided with RHCOS instead.
15 The pull secret that you obtained from the Pull Secret page on the Red Hat OpenShift Cluster
Manager site. This pull secret allows you to authenticate with the services that are provided by the
included authorities, including Quay.io, which serves the container images for OpenShift Container
Platform components.
16 The public portion of the default SSH key for the core user in Red Hat Enterprise Linux CoreOS
(RHCOS).
NOTE
For production OpenShift Container Platform clusters on which you want to perform
installation debugging or disaster recovery, specify an SSH key that your ssh-agent
process uses.
Production environments can deny direct access to the Internet and instead have an HTTP or HTTPS
proxy available. You can configure a new OpenShift Container Platform cluster to use a proxy by
configuring the proxy settings in the install-config.yaml file.
NOTE
For bare metal installations, if you do not assign node IP addresses from the range that is
specified in the networking.machineNetwork[].cidr field in the install-config.yaml file,
you must include them in the proxy.noProxy field.
Prerequisites
Review the sites that your cluster requires access to and determine whether any need to bypass
the proxy. By default, all cluster egress traffic is proxied, including calls to hosting cloud provider
APIs. Add sites to the Proxy object’s spec.noProxy field to bypass the proxy if necessary.
NOTE
Procedure
15
OpenShift Container Platform 4.4 Installing on bare metal
1. Edit your install-config.yaml file and add the proxy settings. For example:
apiVersion: v1
baseDomain: my.domain.com
proxy:
httpProxy: http://<username>:<pswd>@<ip>:<port> 1
httpsProxy: http://<username>:<pswd>@<ip>:<port> 2
noProxy: example.com 3
additionalTrustBundle: | 4
-----BEGIN CERTIFICATE-----
<MY_TRUSTED_CA_CERT>
-----END CERTIFICATE-----
...
1 A proxy URL to use for creating HTTP connections outside the cluster. The URL scheme
must be http. If you use an MITM transparent proxy network that does not require
additional proxy configuration but requires additional CAs, you must not specify an
httpProxy value.
2 A proxy URL to use for creating HTTPS connections outside the cluster. If this field is not
specified, then httpProxy is used for both HTTP and HTTPS connections. The URL
scheme must be http; https is currently not supported. If you use an MITM transparent
proxy network that does not require additional proxy configuration but requires additional
CAs, you must not specify an httpsProxy value.
NOTE
The installation program does not support the proxy readinessEndpoints field.
2. Save the file and reference it when installing OpenShift Container Platform.
The installation program creates a cluster-wide proxy that is named cluster that uses the proxy settings
in the provided install-config.yaml file. If no proxy settings are provided, a cluster Proxy object is still
created, but it will have a nil spec.
NOTE
Only the Proxy object named cluster is supported, and no additional proxies can be
created.
16
CHAPTER 1. INSTALLING ON BARE METAL
IMPORTANT
For more information about the support scope of Red Hat Technology Preview features,
see https://access.redhat.com/support/offerings/techpreview/.
You can install and run three-node clusters in OpenShift Container Platform with no workers. This
provides smaller, more resource efficient clusters for cluster administrators and developers to use for
deployment, development, and testing.
Procedure
Edit the install-config.yaml file to set the number of compute replicas, which are also known as
worker replicas, to 0, as shown in the following compute stanza:
- compute:
name: worker
platform: {}
replicas: 0
IMPORTANT
The Ignition config files that the installation program generates contain certificates that
expire after 24 hours. You must complete your cluster installation and keep the cluster
running for 24 hours in a non-degraded state to ensure that the first certificate rotation
has finished.
Prerequisites
Procedure
17
OpenShift Container Platform 4.4 Installing on bare metal
1 For <installation_directory>, specify the installation directory that contains the install-
config.yaml file you created.
Because you create your own compute machines later in the installation process, you can safely
ignore this warning.
WARNING
If you are running a three-node cluster, skip the following step to allow the masters
to be schedulable.
NOTE
.
├── auth
│ ├── kubeadmin-password
│ └── kubeconfig
├── bootstrap.ign
├── master.ign
├── metadata.json
└── worker.ign
18
CHAPTER 1. INSTALLING ON BARE METAL
1.1.9.1. Creating Red Hat Enterprise Linux CoreOS (RHCOS) machines using an ISO image
Before you install a cluster on bare metal infrastructure that you provision, you must create RHCOS
machines for it to use. You can use an ISO image to create the machines.
Prerequisites
Have access to an HTTP server that you can access from your computer and that the machines
that you create can access.
Procedure
1. Upload the control plane, compute, and bootstrap Ignition config files that the installation
program created to your HTTP server. Note the URLs of these files.
2. Obtain the RHCOS images that are required for your preferred method of installing operating
system instances from the Product Downloads page on the Red Hat customer portal or the
RHCOS image mirror page.
IMPORTANT
The RHCOS images might not change with every release of OpenShift Container
Platform. You must download images with the highest version that is less than or
equal to the OpenShift Container Platform version that you install. Use the image
versions that match your OpenShift Container Platform version if they are
available.
You must download the ISO file and the RAW disk file. Those file names resemble the following
examples:
ISO: rhcos-<version>-installer.<architecture>.iso
3. Upload either the RAW RHCOS image file to your HTTP server and note its URL.
4. Use the ISO to start the RHCOS installation. Use one of the following installation options:
5. After the instance boots, press the TAB or E key to edit the kernel command line.
coreos.inst=yes
coreos.inst.install_dev=sda 1
coreos.inst.image_url=<bare_metal_image_URL> 2
coreos.inst.ignition_url=http://example.com/config.ign 3
ip=<dhcp or static IP address> 4 5
19
OpenShift Container Platform 4.4 Installing on bare metal
2 Specify the URL of the RAW image that you uploaded to your server.
3 Specify the URL of the Ignition config file for this machine type.
4 Set ip=dhcp or set an individual static IP address ( ip=) and DNS server (nameserver=) on
each node. For example, setting
ip=10.10.10.2::10.10.10.254:255.255.255.0:core0.example.com:enp1s0:none
nameserver=4.4.4.41 sets:
Netmask to 255.255.255.0
Hostname to core0.example.com
5 If you use multiple network interfaces or DNS servers, you can further customize the IP
address configuration in the following ways:
If your system has multiple network interfaces, you can add multiple IP address
configurations by specifying multiple ip= entries.
If your system has multiple network interfaces, you can use a combination of DHCP
and static IP configurations. You must specify the interface to use, for example
ip=enp1s0:dhcp
ip=10.10.10.2::10.10.10.254:255.255.255.0:core0.example.com:enp2s0:none.
You can provide multiple DNS servers by adding a nameserver= entry for each server,
such as nameserver=1.1.1.1 nameserver=8.8.8.8.
7. Press Enter to complete the installation. After RHCOS installs, the system reboots. After the
system reboots, it applies the Ignition config file that you specified.
IMPORTANT
You must create the bootstrap and control plane machines at this time. Because
some pods are deployed on compute machines by default, also create at least
two compute machines before you install the cluster.
1.1.9.2. Creating Red Hat Enterprise Linux CoreOS (RHCOS) machines by PXE or iPXE
booting
Before you install a cluster on bare metal infrastructure that you provision, you must create RHCOS
machines for it to use. You can use PXE or iPXE booting to create the machines.
Prerequisites
20
CHAPTER 1. INSTALLING ON BARE METAL
Have access to an HTTP server that you can access from your computer.
Procedure
1. Upload the master, worker, and bootstrap Ignition config files that the installation program
created to your HTTP server. Note the URLs of these files.
2. Obtain the RHCOS ISO image, compressed metal RAW image, kernel and initramfs files from
the Product Downloads page on the Red Hat customer portal or the RHCOS image mirror
page.
IMPORTANT
The RHCOS images might not change with every release of OpenShift Container
Platform. You must download images with the highest version that is less than or
equal to the OpenShift Container Platform version that you install. Use the image
versions that match your OpenShift Container Platform version if they are
available.
The file names contain the OpenShift Container Platform version number. They resemble the
following examples:
ISO: rhcos-<version>-installer.<architecture>.iso
kernel: rhcos-<version>-installer-kernel-<architecture>
initramfs: rhcos-<version>-installer-initramfs.<architecture>.img
3. Upload the compressed metal RAW image and the kernel and initramfs files to your HTTP
server.
4. Configure the network boot infrastructure so that the machines boot from their local disks after
RHCOS is installed on them.
For PXE:
DEFAULT pxeboot
TIMEOUT 20
PROMPT 0
LABEL pxeboot
KERNEL http://<HTTP_server>/rhcos-<version>-installer-kernel-<architecture> 1
APPEND ip=dhcp rd.neednet=1 initrd=http://<HTTP_server>/rhcos-<version>-installer-
initramfs.<architecture>.img console=tty0 console=ttyS0 coreos.inst=yes
coreos.inst.install_dev=sda coreos.inst.image_url=http://<HTTP_server>/rhcos-
<version>-metal.<architecture>.raw.gz
coreos.inst.ignition_url=http://<HTTP_server>/bootstrap.ign 2 3
1 Specify the location of the kernel file that you uploaded to your HTTP server.
21
OpenShift Container Platform 4.4 Installing on bare metal
2 If you use multiple NICs, specify a single interface in the ip option. For example, to use
DHCP on a NIC that is named eno1, set ip=eno1:dhcp.
3 Specify locations of the RHCOS files that you uploaded to your HTTP server. The
initrd parameter value is the location of the initramfs file, the coreos.inst.image_url
parameter value is the location of the compressed metal RAW image, and the
coreos.inst.ignition_url parameter value is the location of the bootstrap Ignition
config file.
For iPXE:
1 Specify locations of the RHCOS files that you uploaded to your HTTP server. The
kernel parameter value is the location of the kernel file, the initrd parameter value is
the location of the initramfs file, the coreos.inst.image_url parameter value is the
location of the compressed metal RAW image, and the coreos.inst.ignition_url
parameter value is the location of the bootstrap Ignition config file.
2 If you use multiple NICs, specify a single interface in the ip option. For example, to use
DHCP on a NIC that is named eno1, set ip=eno1:dhcp.
3 Specify the location of the initramfs file that you uploaded to your HTTP server.
IMPORTANT
You must create the bootstrap and control plane machines at this time. Because
some pods are deployed on compute machines by default, also create at least
two compute machine before you install the cluster.
Prerequisites
You obtained the installation program and generated the Ignition config files for your cluster.
You used the Ignition config files to create RHCOS machines for your cluster.
22
CHAPTER 1. INSTALLING ON BARE METAL
Procedure
1 For <installation_directory>, specify the path to the directory that you stored the
installation files in.
2 To view different installation details, specify warn, debug, or error instead of info.
The command succeeds when the Kubernetes API server signals that it has been bootstrapped
on the control plane machines.
2. After bootstrap process is complete, remove the bootstrap machine from the load balancer.
IMPORTANT
You must remove the bootstrap machine from the load balancer at this point.
You can also remove or reformat the machine itself.
Prerequisites
Procedure
$ export KUBECONFIG=<installation_directory>/auth/kubeconfig 1
1 For <installation_directory>, specify the path to the directory that you stored the
installation files in.
2. Verify you can run oc commands successfully using the exported configuration:
23
OpenShift Container Platform 4.4 Installing on bare metal
$ oc whoami
system:admin
Prerequisites
Procedure
$ oc get nodes
2. Review the pending certificate signing requests (CSRs) and ensure that the you see a client and
server request with Pending or Approved status for each machine that you added to the
cluster:
$ oc get csr
In this example, two machines are joining the cluster. You might see more approved CSRs in the
list.
3. If the CSRs were not approved, after all of the pending CSRs for the machines you added are in
24
CHAPTER 1. INSTALLING ON BARE METAL
3. If the CSRs were not approved, after all of the pending CSRs for the machines you added are in
Pending status, approve the CSRs for your cluster machines:
NOTE
Because the CSRs rotate automatically, approve your CSRs within an hour of
adding the machines to the cluster. If you do not approve them within an hour, the
certificates will rotate, and more than two certificates will be present for each
node. You must approve all of these certificates. After you approve the initial
CSRs, the subsequent node client CSRs are automatically approved by the
cluster kube-controller-manager. You must implement a method of
automatically approving the kubelet serving certificate requests.
To approve them individually, run the following command for each valid CSR:
Prerequisites
Procedure
25
OpenShift Container Platform 4.4 Installing on bare metal
On platforms that do not provide shareable object storage, the OpenShift Image Registry Operator
bootstraps itself as Removed. This allows openshift-installer to complete installations on these
platform types.
After installation, you must edit the Image Registry Operator configuration to switch the
ManagementState from Removed to Managed.
NOTE
The image-registry Operator is not initially available for platforms that do not provide default storage.
After installation, you must configure your registry to use storage so the Registry Operator is made
available.
Instructions for both configuring a PersistentVolume, which is required for production clusters, and for
configuring an empty directory as the storage location, which is available for only non-production
clusters, are shown.
As a cluster administrator, following installation you must configure your registry to use storage.
Prerequisites
Provision persistent storage for your cluster, such as Red Hat OpenShift Container Storage. To
26
CHAPTER 1. INSTALLING ON BARE METAL
Provision persistent storage for your cluster, such as Red Hat OpenShift Container Storage. To
deploy a private image registry, your storage must provide ReadWriteMany access mode.
Procedure
NOTE
If the storage type is emptyDIR, the replica number cannot be greater than 1. If
the storage type is NFS, and you want to scale up the registry Pod by setting
replica>1 you must enable the no_wdelay mount option. For example:
# cat /etc/exports
/mnt/data *(rw,sync,no_wdelay,no_root_squash,insecure,fsid=0)
sh-4.2# exportfs -rv
exporting *:/mnt/data
$ oc edit configs.imageregistry.operator.openshift.io
storage:
pvc:
claim:
Leave the claim field blank to allow the automatic creation of an image-registry-storage PVC.
You must configure storage for the image registry Operator. For non-production clusters, you can set
the image registry to an empty directory. If you do so, all images are lost if you restart the registry.
Procedure
27
OpenShift Container Platform 4.4 Installing on bare metal
WARNING
If you run this command before the Image Registry Operator initializes its components, the oc
patch command fails with the following error:
Prerequisites
Procedure
28
CHAPTER 1. INSTALLING ON BARE METAL
When all of the cluster Operators are AVAILABLE, you can complete the installation.
1 For <installation_directory>, specify the path to the directory that you stored the
installation files in.
The command succeeds when the Cluster Version Operator finishes deploying the OpenShift
Container Platform cluster from Kubernetes API server.
IMPORTANT
The Ignition config files that the installation program generates contain
certificates that expire after 24 hours. You must keep the cluster running for 24
hours in a non-degraded state to ensure that the first certificate rotation has
finished.
3. Confirm that the Kubernetes API server is communicating with the Pods.
b. View the logs for a Pod that is listed in the output of the previous command by using the
following command:
29
OpenShift Container Platform 4.4 Installing on bare metal
1 Specify the Pod name and namespace, as shown in the output of the previous
command.
If the Pod logs display, the Kubernetes API server can communicate with the cluster
machines.
Next steps
You must set most of the network configuration parameters during installation, and you can modify only
kubeProxy configuration parameters in a running cluster.
Prerequisites
Review details about the OpenShift Container Platform installation and update processes.
If you use a firewall, you must configure it to access Red Hat Insights .
Access the Red Hat OpenShift Cluster Manager page to download the installation program and
perform subscription management and entitlement. If the cluster has internet access and you
do not disable Telemetry, that service automatically entitles your cluster. If the Telemetry
service cannot entitle your cluster, you must manually entitle it on the Cluster registration page.
Access Quay.io to obtain the packages that are required to install your cluster.
IMPORTANT
30
CHAPTER 1. INSTALLING ON BARE METAL
IMPORTANT
If your cluster cannot have direct internet access, you can perform a restricted network
installation on some types of infrastructure that you provision. During that process, you
download the content that is required and use it to populate a mirror registry with the
packages that you need to install a cluster and generate the installation program. With
some installation types, the environment that you install your cluster in will not require
internet access. Before you update the cluster, you update the content of the mirror
registry.
The smallest OpenShift Container Platform clusters require the following hosts:
At least two compute machines, which are also known as worker machines
NOTE
The cluster requires the bootstrap machine to deploy the OpenShift Container Platform
cluster on the three control plane machines. You can remove the bootstrap machine after
you install the cluster.
IMPORTANT
To maintain high availability of your cluster, use separate physical hosts for these cluster
machines.
The bootstrap, control plane, and compute machines must use the Red Hat Enterprise Linux CoreOS
(RHCOS) as the operating system.
Note that RHCOS is based on Red Hat Enterprise Linux 8 and inherits all of its hardware certifications
and requirements. See Red Hat Enterprise Linux technology capabilities and limits .
All the Red Hat Enterprise Linux CoreOS (RHCOS) machines require network in initramfs during boot
to fetch Ignition config files from the Machine Config Server. During the initial boot, the machines
require either a DHCP server or that static IP addresses be set in order to establish a network
connection to download their Ignition config files.
31
OpenShift Container Platform 4.4 Installing on bare metal
Because your cluster has limited access to automatic machine management when you use infrastructure
that you provision, you must provide a mechanism for approving cluster certificate signing requests
(CSRs) after installation. The kube-controller-manager only approves the kubelet client CSRs. The
machine-approver cannot guarantee the validity of a serving certificate that is requested by using
kubelet credentials because it cannot confirm that the correct machine issued the request. You must
determine and implement a method of verifying the validity of the kubelet serving certificate requests
and approving them.
Prerequistes
Review the OpenShift Container Platform 4.x Tested Integrations page before you create the
supporting infrastructure for your cluster.
Procedure
4. Configure DNS.
All the Red Hat Enterprise Linux CoreOS (RHCOS) machines require network in initramfs during boot
to fetch Ignition config from the Machine Config Server.
During the initial boot, the machines require either a DHCP server or that static IP addresses be set on
each host in the cluster in order to establish a network connection, which allows them to download their
Ignition config files.
It is recommended to use the DHCP server to manage the machines for the cluster long-term. Ensure
that the DHCP server is configured to provide persistent IP addresses and host names to the cluster
machines.
32
CHAPTER 1. INSTALLING ON BARE METAL
The Kubernetes API server must be able to resolve the node names of the cluster machines. If the API
servers and worker nodes are in different zones, you can configure a default DNS search zone to allow
the API server to resolve the node names. Another supported approach is to always refer to hosts by
their fully-qualified domain names in both the node objects and all DNS requests.
You must configure the network connectivity between machines to allow cluster components to
communicate. Each machine must be able to resolve the host names of all other machines in the cluster.
TCP 9000- 9999 Host level services, including the node exporter on ports
9100- 9101 and the Cluster Version Operator on port9099.
10256 openshift-sdn
9000- 9999 Host level services, including the node exporter on ports
9100- 9101.
IMPORTANT
OpenShift Container Platform requires all nodes to have internet access to pull images
for platform containers and provide telemetry data to Red Hat.
Load balancers
Before you install OpenShift Container Platform, you must provision two layer-4 load balancers. The API
33
OpenShift Container Platform 4.4 Installing on bare metal
Before you install OpenShift Container Platform, you must provision two layer-4 load balancers. The API
requires one load balancer and the default Ingress Controller needs the second load balancer to provide
ingress to applications.
NOTE
A working configuration for the Ingress router is required for an OpenShift Container
Platform cluster. You must configure the Ingress router after the control plane initializes.
The following DNS records are required for an OpenShift Container Platform cluster that uses user-
provisioned infrastructure. In each record, <cluster_name> is the cluster name and <base_domain> is
the cluster base domain that you specify in the install-config.yaml file. A complete DNS record takes
the form: <component>.<cluster_name>.<base_domain>..
34
CHAPTER 1. INSTALLING ON BARE METAL
IMPORTANT
35
OpenShift Container Platform 4.4 Installing on bare metal
# _service._proto.name.
TTL class SRV priority
weight port target.
_etcd-server-ssl._tcp.
<cluster_name>.
<base_domain>. 86400 IN
SRV 0 10 2380 etcd-
0.<cluster_name>.
<base_domain>
_etcd-server-ssl._tcp.
<cluster_name>.
<base_domain>. 86400 IN
SRV 0 10 2380 etcd-
1.<cluster_name>.
<base_domain>
_etcd-server-ssl._tcp.
<cluster_name>.
<base_domain>. 86400 IN
SRV 0 10 2380 etcd-
2.<cluster_name>.
<base_domain>
NOTE
You can use this key to SSH into the master nodes as the user core. When you deploy the cluster, the
key is added to the core user’s ~/.ssh/authorized_keys list.
NOTE
36
CHAPTER 1. INSTALLING ON BARE METAL
NOTE
You must use a local key, not one that you configured with platform-specific approaches
such as AWS key pairs.
Procedure
1. If you do not have an SSH key that is configured for password-less authentication on your
computer, create one. For example, on a computer that uses a Linux operating system, run the
following command:
1 Specify the path and file name, such as ~/.ssh/id_rsa, of the SSH key.
Running this command generates an SSH key that does not require a password in the location
that you specified.
IMPORTANT
If you create a new SSH key pair, avoid overwriting existing SSH keys.
$ ssh-add <path>/<file_name> 1
1 Specify the path and file name for your SSH private key, such as ~/.ssh/id_rsa
Next steps
When you install OpenShift Container Platform, provide the SSH public key to the installation
program.
Prerequisites
A computer that runs Linux or macOS, with 500 MB of local disk space
Procedure
37
OpenShift Container Platform 4.4 Installing on bare metal
1. Access the Infrastructure Provider page on the Red Hat OpenShift Cluster Manager site. If you
have a Red Hat account, log in with your credentials. If you do not, create an account.
2. Navigate to the page for your installation type, download the installation program for your
operating system, and place the file in the directory where you will store the installation
configuration files.
IMPORTANT
The installation program creates several files on the computer that you use to
install your cluster. You must keep both the installation program and the files
that the installation program creates after you finish installing the cluster.
3. Extract the installation program. For example, on a computer that uses a Linux operating
system, run the following command:
4. From the Pull Secret page on the Red Hat OpenShift Cluster Manager site, download your
installation pull secret as a .txt file. This pull secret allows you to authenticate with the services
that are provided by the included authorities, including Quay.io, which serves the container
images for OpenShift Container Platform components.
IMPORTANT
If you installed an earlier version of oc, you cannot use it to complete all of the commands
in OpenShift Container Platform 4.4. Download and install the new version of oc.
Procedure
1. From the Infrastructure Provider page on the Red Hat OpenShift Cluster Manager site, navigate
to the page for your installation type and click Download Command-line Tools.
2. Click the folder for your operating system and architecture and click the compressed file.
NOTE
$ oc <command>
38
CHAPTER 1. INSTALLING ON BARE METAL
Prerequisites
Obtain the OpenShift Container Platform installation program and the access token for your
cluster.
Procedure
$ mkdir <installation_directory>
IMPORTANT
You must create a directory. Some installation assets, like bootstrap X.509
certificates have short expiration intervals, so you must not reuse an installation
directory. If you want to reuse individual files from another cluster installation,
you can copy them into your directory. However, the file names for the
installation assets might change between releases. Use caution when copying
installation files from an earlier OpenShift Container Platform version.
NOTE
3. Back up the install-config.yaml file so that you can use it to install multiple clusters.
IMPORTANT
The install-config.yaml file is consumed during the next step of the installation
process. You must back it up now.
You can customize the install-config.yaml file to specify more details about your OpenShift Container
Platform cluster’s platform or modify the values of the required parameters.
apiVersion: v1
baseDomain: example.com 1
compute:
- hyperthreading: Enabled 2 3
name: worker
replicas: 0 4
controlPlane:
hyperthreading: Enabled 5 6
39
OpenShift Container Platform 4.4 Installing on bare metal
name: master 7
replicas: 3 8
metadata:
name: test 9
networking:
clusterNetwork:
- cidr: 10.128.0.0/14 10
hostPrefix: 23 11
networkType: OpenShiftSDN
serviceNetwork: 12
- 172.30.0.0/16
platform:
none: {} 13
fips: false 14
pullSecret: '{"auths": ...}' 15
sshKey: 'ssh-ed25519 AAAA...' 16
1 The base domain of the cluster. All DNS records must be sub-domains of this base and include the
cluster name.
2 5 The controlPlane section is a single mapping, but the compute section is a sequence of mappings.
To meet the requirements of the different data structures, the first line of the compute section
must begin with a hyphen, -, and the first line of the controlPlane section must not. Although both
sections currently define a single machine pool, it is possible that future versions of OpenShift
Container Platform will support defining multiple compute pools during installation. Only one
control plane pool is used.
IMPORTANT
4 You must set the value of the replicas parameter to 0. This parameter controls the number of
workers that the cluster creates and manages for you, which are functions that the cluster does not
perform when you use user-provisioned infrastructure. You must manually deploy worker machines
for the cluster to use before you finish installing OpenShift Container Platform.
8 The number of control plane machines that you add to the cluster. Because the cluster uses this
values as the number of etcd endpoints in the cluster, the value must match the number of control
plane machines that you deploy.
10 A block of IP addresses from which Pod IP addresses are allocated. This block must not overlap
with existing physical networks. These IP addresses are used for the Pod network, and if you need
to access the Pods from an external network, configure load balancers and routers to manage the
traffic.
11 The subnet prefix length to assign to each individual node. For example, if hostPrefix is set to 23,
then each node is assigned a /23 subnet out of the given cidr, which allows for 510 (2^(32 - 23) - 2)
40
CHAPTER 1. INSTALLING ON BARE METAL
then each node is assigned a /23 subnet out of the given cidr, which allows for 510 (2^(32 - 23) - 2)
pod IPs addresses. If you are required to provide access to nodes from an external network,
configure load balancers and routers to manage the traffic.
12 The IP address pool to use for service IP addresses. You can enter only one IP address pool. If you
need to access the services from an external network, configure load balancers and routers to
manage the traffic.
13 You must set the platform to none. You cannot provide additional platform configuration variables
for bare metal infrastructure.
14 Whether to enable or disable FIPS mode. By default, FIPS mode is not enabled. If FIPS mode is
enabled, the Red Hat Enterprise Linux CoreOS (RHCOS) machines that OpenShift Container
Platform runs on bypass the default Kubernetes cryptography suite and use the cryptography
modules that are provided with RHCOS instead.
15 The pull secret that you obtained from the Pull Secret page on the Red Hat OpenShift Cluster
Manager site. This pull secret allows you to authenticate with the services that are provided by the
included authorities, including Quay.io, which serves the container images for OpenShift Container
Platform components.
16 The public portion of the default SSH key for the core user in Red Hat Enterprise Linux CoreOS
(RHCOS).
NOTE
For production OpenShift Container Platform clusters on which you want to perform
installation debugging or disaster recovery, specify an SSH key that your ssh-agent
process uses.
You can modify your cluster network configuration parameters in the install-config.yaml configuration
file. The following table describes the parameters.
NOTE
You cannot modify these parameters in the install-config.yaml file after installation.
networking.net The Pod network provider plug-in to deploy. The The default value is
workType OpenShiftSDN plug-in is the only plug-in OpenShiftSDN .
supported in OpenShift Container Platform 4.4.
41
OpenShift Container Platform 4.4 Installing on bare metal
networking.clus The subnet prefix length to assign to each individual A subnet prefix. The default
terNetwork[].ho node. For example, if hostPrefix is set to 23, then value is 23.
stPrefix each node is assigned a /23 subnet out of the given
cidr, allowing for 510 (2^(32 - 23) - 2) Pod IP
addresses.
IMPORTANT
Modifying the OpenShift Container Platform manifest files directly is not supported.
Prerequisites
Procedure
1 For <installation_directory>, specify the name of the directory that contains the install-
config.yaml file for your cluster.
$ touch <installation_directory>/manifests/cluster-network-03-config.yml 1
42
CHAPTER 1. INSTALLING ON BARE METAL
1 For <installation_directory>, specify the directory name that contains the manifests/
directory for your cluster.
After creating the file, several network configuration files are in the manifests/ directory, as
shown:
$ ls <installation_directory>/manifests/cluster-network-*
cluster-network-01-crd.yml
cluster-network-02-config.yml
cluster-network-03-config.yml
3. Open the cluster-network-03-config.yml file in an editor and enter a CR that describes the
Operator configuration you want:
apiVersion: operator.openshift.io/v1
kind: Network
metadata:
name: cluster
spec: 1
clusterNetwork:
- cidr: 10.128.0.0/14
hostPrefix: 23
serviceNetwork:
- 172.30.0.0/16
defaultNetwork:
type: OpenShiftSDN
openshiftSDNConfig:
mode: NetworkPolicy
mtu: 1450
vxlanPort: 4789
1 The parameters for the spec parameter are only an example. Specify your configuration
for the Cluster Network Operator in the CR.
The CNO provides default values for the parameters in the CR, so you must specify only the
parameters that you want to change.
You can specify the cluster network configuration for your OpenShift Container Platform cluster by
setting the parameter values for the defaultNetwork parameter in the CNO CR. The following CR
displays the default configuration for the CNO and explains both the parameters you can configure and
the valid parameter values:
43
OpenShift Container Platform 4.4 Installing on bare metal
apiVersion: operator.openshift.io/v1
kind: Network
metadata:
name: cluster
spec:
clusterNetwork: 1
- cidr: 10.128.0.0/14
hostPrefix: 23
serviceNetwork: 2
- 172.30.0.0/16
defaultNetwork: 3
...
kubeProxyConfig: 4
iptablesSyncPeriod: 30s 5
proxyArguments:
iptables-min-sync-period: 6
- 30s
4 The parameters for this object specify the kube-proxy configuration. If you do not specify the
parameter values, the Network Operator applies the displayed default parameter values.
5 The refresh period for iptables rules. The default value is 30s. Valid suffixes include s, m, and h
and are described in the Go time package documentation.
6 The minimum duration before refreshing iptables rules. This parameter ensures that the refresh
does not happen too frequently. Valid suffixes include s, m, and h and are described in the Go time
package.
The following YAML object describes the configuration parameters for the OpenShift SDN Pod network
provider.
defaultNetwork:
type: OpenShiftSDN 1
openshiftSDNConfig: 2
mode: NetworkPolicy 3
mtu: 1450 4
vxlanPort: 4789 5
2 Specify only if you want to override part of the OpenShift SDN configuration.
3 Configures the network isolation mode for OpenShift SDN. The allowed values are Multitenant,
Subnet, or NetworkPolicy. The default value is NetworkPolicy.
4 The maximum transmission unit (MTU) for the VXLAN overlay network. This value is normally
44
CHAPTER 1. INSTALLING ON BARE METAL
5 The port to use for all VXLAN packets. The default value is 4789. If you are running in a virtualized
environment with existing nodes that are part of another VXLAN network, then you might be
On Amazon Web Services (AWS), you can select an alternate port for the VXLAN between port
9000 and port 9999.
apiVersion: operator.openshift.io/v1
kind: Network
metadata:
name: cluster
spec:
clusterNetwork:
- cidr: 10.128.0.0/14
hostPrefix: 23
serviceNetwork:
- 172.30.0.0/16
defaultNetwork:
type: OpenShiftSDN
openshiftSDNConfig:
mode: NetworkPolicy
mtu: 1450
vxlanPort: 4789
kubeProxyConfig:
iptablesSyncPeriod: 30s
proxyArguments:
iptables-min-sync-period:
- 30s
IMPORTANT
The Ignition config files that the installation program generates contain certificates that
expire after 24 hours. You must complete your cluster installation and keep the cluster
running for 24 hours in a non-degraded state to ensure that the first certificate rotation
has finished.
Prerequisites
Obtain the OpenShift Container Platform installation program and the pull secret for your
cluster.
Procedure
45
OpenShift Container Platform 4.4 Installing on bare metal
1 For <installation_directory>, specify the directory name to store the files that the
installation program creates.
IMPORTANT
If you created an install-config.yaml file, specify the directory that contains it.
Otherwise, specify an empty directory. Some installation assets, like bootstrap
X.509 certificates have short expiration intervals, so you must not reuse an
installation directory. If you want to reuse individual files from another cluster
installation, you can copy them into your directory. However, the file names for
the installation assets might change between releases. Use caution when copying
installation files from an earlier OpenShift Container Platform version.
.
├── auth
│ ├── kubeadmin-password
│ └── kubeconfig
├── bootstrap.ign
├── master.ign
├── metadata.json
└── worker.ign
1.2.11.1. Creating Red Hat Enterprise Linux CoreOS (RHCOS) machines using an ISO image
Before you install a cluster on bare metal infrastructure that you provision, you must create RHCOS
machines for it to use. You can use an ISO image to create the machines.
Prerequisites
Have access to an HTTP server that you can access from your computer and that the machines
that you create can access.
Procedure
1. Upload the control plane, compute, and bootstrap Ignition config files that the installation
program created to your HTTP server. Note the URLs of these files.
2. Obtain the RHCOS images that are required for your preferred method of installing operating
46
CHAPTER 1. INSTALLING ON BARE METAL
2. Obtain the RHCOS images that are required for your preferred method of installing operating
system instances from the Product Downloads page on the Red Hat customer portal or the
RHCOS image mirror page.
IMPORTANT
The RHCOS images might not change with every release of OpenShift Container
Platform. You must download images with the highest version that is less than or
equal to the OpenShift Container Platform version that you install. Use the image
versions that match your OpenShift Container Platform version if they are
available.
You must download the ISO file and the RAW disk file. Those file names resemble the following
examples:
ISO: rhcos-<version>-installer.<architecture>.iso
3. Upload either the RAW RHCOS image file to your HTTP server and note its URL.
4. Use the ISO to start the RHCOS installation. Use one of the following installation options:
5. After the instance boots, press the TAB or E key to edit the kernel command line.
coreos.inst=yes
coreos.inst.install_dev=sda 1
coreos.inst.image_url=<bare_metal_image_URL> 2
coreos.inst.ignition_url=http://example.com/config.ign 3
ip=<dhcp or static IP address> 4 5
2 Specify the URL of the RAW image that you uploaded to your server.
3 Specify the URL of the Ignition config file for this machine type.
4 Set ip=dhcp or set an individual static IP address ( ip=) and DNS server (nameserver=) on
each node. For example, setting
ip=10.10.10.2::10.10.10.254:255.255.255.0:core0.example.com:enp1s0:none
nameserver=4.4.4.41 sets:
Netmask to 255.255.255.0
Hostname to core0.example.com
47
OpenShift Container Platform 4.4 Installing on bare metal
5 If you use multiple network interfaces or DNS servers, you can further customize the IP
address configuration in the following ways:
If your system has multiple network interfaces, you can add multiple IP address
configurations by specifying multiple ip= entries.
If your system has multiple network interfaces, you can use a combination of DHCP
and static IP configurations. You must specify the interface to use, for example
ip=enp1s0:dhcp
ip=10.10.10.2::10.10.10.254:255.255.255.0:core0.example.com:enp2s0:none.
You can provide multiple DNS servers by adding a nameserver= entry for each server,
such as nameserver=1.1.1.1 nameserver=8.8.8.8.
7. Press Enter to complete the installation. After RHCOS installs, the system reboots. After the
system reboots, it applies the Ignition config file that you specified.
IMPORTANT
You must create the bootstrap and control plane machines at this time. Because
some pods are deployed on compute machines by default, also create at least
two compute machines before you install the cluster.
1.2.11.2. Creating Red Hat Enterprise Linux CoreOS (RHCOS) machines by PXE or iPXE
booting
Before you install a cluster on bare metal infrastructure that you provision, you must create RHCOS
machines for it to use. You can use PXE or iPXE booting to create the machines.
Prerequisites
Have access to an HTTP server that you can access from your computer.
Procedure
1. Upload the master, worker, and bootstrap Ignition config files that the installation program
created to your HTTP server. Note the URLs of these files.
2. Obtain the RHCOS ISO image, compressed metal RAW image, kernel and initramfs files from
the Product Downloads page on the Red Hat customer portal or the RHCOS image mirror
page.
IMPORTANT
48
CHAPTER 1. INSTALLING ON BARE METAL
IMPORTANT
The RHCOS images might not change with every release of OpenShift Container
Platform. You must download images with the highest version that is less than or
equal to the OpenShift Container Platform version that you install. Use the image
versions that match your OpenShift Container Platform version if they are
available.
The file names contain the OpenShift Container Platform version number. They resemble the
following examples:
ISO: rhcos-<version>-installer.<architecture>.iso
kernel: rhcos-<version>-installer-kernel-<architecture>
initramfs: rhcos-<version>-installer-initramfs.<architecture>.img
3. Upload the compressed metal RAW image and the kernel and initramfs files to your HTTP
server.
4. Configure the network boot infrastructure so that the machines boot from their local disks after
RHCOS is installed on them.
For PXE:
DEFAULT pxeboot
TIMEOUT 20
PROMPT 0
LABEL pxeboot
KERNEL http://<HTTP_server>/rhcos-<version>-installer-kernel-<architecture> 1
APPEND ip=dhcp rd.neednet=1 initrd=http://<HTTP_server>/rhcos-<version>-installer-
initramfs.<architecture>.img console=tty0 console=ttyS0 coreos.inst=yes
coreos.inst.install_dev=sda coreos.inst.image_url=http://<HTTP_server>/rhcos-
<version>-metal.<architecture>.raw.gz
coreos.inst.ignition_url=http://<HTTP_server>/bootstrap.ign 2 3
1 Specify the location of the kernel file that you uploaded to your HTTP server.
2 If you use multiple NICs, specify a single interface in the ip option. For example, to use
DHCP on a NIC that is named eno1, set ip=eno1:dhcp.
3 Specify locations of the RHCOS files that you uploaded to your HTTP server. The
initrd parameter value is the location of the initramfs file, the coreos.inst.image_url
parameter value is the location of the compressed metal RAW image, and the
coreos.inst.ignition_url parameter value is the location of the bootstrap Ignition
config file.
For iPXE:
49
OpenShift Container Platform 4.4 Installing on bare metal
1 Specify locations of the RHCOS files that you uploaded to your HTTP server. The
kernel parameter value is the location of the kernel file, the initrd parameter value is
the location of the initramfs file, the coreos.inst.image_url parameter value is the
location of the compressed metal RAW image, and the coreos.inst.ignition_url
parameter value is the location of the bootstrap Ignition config file.
2 If you use multiple NICs, specify a single interface in the ip option. For example, to use
DHCP on a NIC that is named eno1, set ip=eno1:dhcp.
3 Specify the location of the initramfs file that you uploaded to your HTTP server.
IMPORTANT
You must create the bootstrap and control plane machines at this time. Because
some pods are deployed on compute machines by default, also create at least
two compute machine before you install the cluster.
Prerequisites
You obtained the installation program and generated the Ignition config files for your cluster.
You used the Ignition config files to create RHCOS machines for your cluster.
Procedure
50
CHAPTER 1. INSTALLING ON BARE METAL
1 For <installation_directory>, specify the path to the directory that you stored the
installation files in.
2 To view different installation details, specify warn, debug, or error instead of info.
The command succeeds when the Kubernetes API server signals that it has been bootstrapped
on the control plane machines.
2. After bootstrap process is complete, remove the bootstrap machine from the load balancer.
IMPORTANT
You must remove the bootstrap machine from the load balancer at this point.
You can also remove or reformat the machine itself.
Prerequisites
Procedure
$ export KUBECONFIG=<installation_directory>/auth/kubeconfig 1
1 For <installation_directory>, specify the path to the directory that you stored the
installation files in.
2. Verify you can run oc commands successfully using the exported configuration:
$ oc whoami
system:admin
Prerequisites
51
OpenShift Container Platform 4.4 Installing on bare metal
Prerequisites
Procedure
$ oc get nodes
2. Review the pending certificate signing requests (CSRs) and ensure that the you see a client and
server request with Pending or Approved status for each machine that you added to the
cluster:
$ oc get csr
In this example, two machines are joining the cluster. You might see more approved CSRs in the
list.
3. If the CSRs were not approved, after all of the pending CSRs for the machines you added are in
Pending status, approve the CSRs for your cluster machines:
NOTE
Because the CSRs rotate automatically, approve your CSRs within an hour of
adding the machines to the cluster. If you do not approve them within an hour, the
certificates will rotate, and more than two certificates will be present for each
node. You must approve all of these certificates. After you approve the initial
CSRs, the subsequent node client CSRs are automatically approved by the
cluster kube-controller-manager. You must implement a method of
automatically approving the kubelet serving certificate requests.
52
CHAPTER 1. INSTALLING ON BARE METAL
To approve them individually, run the following command for each valid CSR:
Prerequisites
Procedure
53
OpenShift Container Platform 4.4 Installing on bare metal
On platforms that do not provide shareable object storage, the OpenShift Image Registry Operator
bootstraps itself as Removed. This allows openshift-installer to complete installations on these
platform types.
After installation, you must edit the Image Registry Operator configuration to switch the
ManagementState from Removed to Managed.
NOTE
The image-registry Operator is not initially available for platforms that do not provide default storage.
After installation, you must configure your registry to use storage so the Registry Operator is made
available.
Instructions for both configuring a PersistentVolume, which is required for production clusters, and for
configuring an empty directory as the storage location, which is available for only non-production
clusters, are shown.
Prerequisites
Procedure
54
CHAPTER 1. INSTALLING ON BARE METAL
When all of the cluster Operators are AVAILABLE, you can complete the installation.
1 For <installation_directory>, specify the path to the directory that you stored the
installation files in.
The command succeeds when the Cluster Version Operator finishes deploying the OpenShift
Container Platform cluster from Kubernetes API server.
IMPORTANT
The Ignition config files that the installation program generates contain
certificates that expire after 24 hours. You must keep the cluster running for 24
hours in a non-degraded state to ensure that the first certificate rotation has
finished.
3. Confirm that the Kubernetes API server is communicating with the Pods.
55
OpenShift Container Platform 4.4 Installing on bare metal
Running 1 9m
openshift-apiserver apiserver-67b9g 1/1 Running 0
3m
openshift-apiserver apiserver-ljcmx 1/1 Running 0
1m
openshift-apiserver apiserver-z25h4 1/1 Running 0
2m
openshift-authentication-operator authentication-operator-69d5d8bf84-vh2n8 1/1
Running 0 5m
...
b. View the logs for a Pod that is listed in the output of the previous command by using the
following command:
1 Specify the Pod name and namespace, as shown in the output of the previous
command.
If the Pod logs display, the Kubernetes API server can communicate with the cluster
machines.
Next steps
IMPORTANT
While you might be able to follow this procedure to deploy a cluster on virtualized or cloud
environments, you must be aware of additional considerations for non-bare metal
platforms. Review the information in the guidelines for deploying OpenShift Container
Platform on non-tested platforms before you attempt to install an OpenShift Container
Platform cluster in such an environment.
Prerequisites
Create a mirror registry on your bastion host and obtain the imageContentSources data for
your version of OpenShift Container Platform.
IMPORTANT
Because the installation media is on the bastion host, use that computer to
complete all installation steps.
56
CHAPTER 1. INSTALLING ON BARE METAL
Provision persistent storage for your cluster. To deploy a private image registry, your storage
must provide ReadWriteMany access modes.
Review details about the OpenShift Container Platform installation and update processes.
If you use a firewall and plan to use telemetry, you must configure the firewall to allow the sites
that your cluster requires access to.
NOTE
Be sure to also review this site list if you are configuring a proxy.
If you choose to perform a restricted network installation on a cloud platform, you still require access to
its cloud APIs. Some cloud functions, like Amazon Web Service’s IAM service, require internet access, so
you might still require internet access. Depending on your network, you might require less internet
access for an installation on bare metal hardware or on VMware vSphere.
To complete a restricted network installation, you must create a registry that mirrors the contents of the
OpenShift Container Platform registry and contains the installation media. You can create this mirror on
a bastion host, which can access both the internet and your closed network, or by using other methods
that meet your restrictions.
IMPORTANT
Clusters in restricted networks have the following additional limitations and restrictions:
By default, you cannot use the contents of the Developer Catalog because you cannot access
the required ImageStreamTags.
57
OpenShift Container Platform 4.4 Installing on bare metal
Access the Red Hat OpenShift Cluster Manager page to download the installation program and
perform subscription management and entitlement. If the cluster has internet access and you
do not disable Telemetry, that service automatically entitles your cluster. If the Telemetry
service cannot entitle your cluster, you must manually entitle it on the Cluster registration page.
Access Quay.io to obtain the packages that are required to install your cluster.
IMPORTANT
If your cluster cannot have direct internet access, you can perform a restricted network
installation on some types of infrastructure that you provision. During that process, you
download the content that is required and use it to populate a mirror registry with the
packages that you need to install a cluster and generate the installation program. With
some installation types, the environment that you install your cluster in will not require
internet access. Before you update the cluster, you update the content of the mirror
registry.
The smallest OpenShift Container Platform clusters require the following hosts:
At least two compute machines, which are also known as worker machines
NOTE
The cluster requires the bootstrap machine to deploy the OpenShift Container Platform
cluster on the three control plane machines. You can remove the bootstrap machine after
you install the cluster.
IMPORTANT
To maintain high availability of your cluster, use separate physical hosts for these cluster
machines.
The bootstrap, control plane, and compute machines must use the Red Hat Enterprise Linux CoreOS
(RHCOS) as the operating system.
Note that RHCOS is based on Red Hat Enterprise Linux 8 and inherits all of its hardware certifications
and requirements. See Red Hat Enterprise Linux technology capabilities and limits .
All the Red Hat Enterprise Linux CoreOS (RHCOS) machines require network in initramfs during boot
58
CHAPTER 1. INSTALLING ON BARE METAL
All the Red Hat Enterprise Linux CoreOS (RHCOS) machines require network in initramfs during boot
to fetch Ignition config files from the Machine Config Server. During the initial boot, the machines
require either a DHCP server or that static IP addresses be set in order to establish a network
connection to download their Ignition config files.
Because your cluster has limited access to automatic machine management when you use infrastructure
that you provision, you must provide a mechanism for approving cluster certificate signing requests
(CSRs) after installation. The kube-controller-manager only approves the kubelet client CSRs. The
machine-approver cannot guarantee the validity of a serving certificate that is requested by using
kubelet credentials because it cannot confirm that the correct machine issued the request. You must
determine and implement a method of verifying the validity of the kubelet serving certificate requests
and approving them.
Prerequistes
Review the OpenShift Container Platform 4.x Tested Integrations page before you create the
supporting infrastructure for your cluster.
Procedure
4. Configure DNS.
All the Red Hat Enterprise Linux CoreOS (RHCOS) machines require network in initramfs during boot
59
OpenShift Container Platform 4.4 Installing on bare metal
All the Red Hat Enterprise Linux CoreOS (RHCOS) machines require network in initramfs during boot
to fetch Ignition config from the Machine Config Server.
During the initial boot, the machines require either a DHCP server or that static IP addresses be set on
each host in the cluster in order to establish a network connection, which allows them to download their
Ignition config files.
It is recommended to use the DHCP server to manage the machines for the cluster long-term. Ensure
that the DHCP server is configured to provide persistent IP addresses and host names to the cluster
machines.
The Kubernetes API server must be able to resolve the node names of the cluster machines. If the API
servers and worker nodes are in different zones, you can configure a default DNS search zone to allow
the API server to resolve the node names. Another supported approach is to always refer to hosts by
their fully-qualified domain names in both the node objects and all DNS requests.
You must configure the network connectivity between machines to allow cluster components to
communicate. Each machine must be able to resolve the host names of all other machines in the cluster.
TCP 9000- 9999 Host level services, including the node exporter on ports
9100- 9101 and the Cluster Version Operator on port9099.
10256 openshift-sdn
9000- 9999 Host level services, including the node exporter on ports
9100- 9101.
The infrastructure that you provision for your cluster must meet the following network topology
60
CHAPTER 1. INSTALLING ON BARE METAL
The infrastructure that you provision for your cluster must meet the following network topology
requirements.
IMPORTANT
OpenShift Container Platform requires all nodes to have internet access to pull images
for platform containers and provide telemetry data to Red Hat.
Load balancers
Before you install OpenShift Container Platform, you must provision two layer-4 load balancers. The API
requires one load balancer and the default Ingress Controller needs the second load balancer to provide
ingress to applications.
NOTE
A working configuration for the Ingress router is required for an OpenShift Container
Platform cluster. You must configure the Ingress router after the control plane initializes.
The following DNS records are required for an OpenShift Container Platform cluster that uses user-
provisioned infrastructure. In each record, <cluster_name> is the cluster name and <base_domain> is
the cluster base domain that you specify in the install-config.yaml file. A complete DNS record takes
the form: <component>.<cluster_name>.<base_domain>..
61
OpenShift Container Platform 4.4 Installing on bare metal
IMPORTANT
62
CHAPTER 1. INSTALLING ON BARE METAL
# _service._proto.name.
TTL class SRV priority
weight port target.
_etcd-server-ssl._tcp.
<cluster_name>.
<base_domain>. 86400 IN
SRV 0 10 2380 etcd-
0.<cluster_name>.
<base_domain>
_etcd-server-ssl._tcp.
<cluster_name>.
<base_domain>. 86400 IN
SRV 0 10 2380 etcd-
1.<cluster_name>.
<base_domain>
_etcd-server-ssl._tcp.
<cluster_name>.
<base_domain>. 86400 IN
SRV 0 10 2380 etcd-
2.<cluster_name>.
<base_domain>
63
OpenShift Container Platform 4.4 Installing on bare metal
If you want to perform installation debugging or disaster recovery on your cluster, you must provide an
SSH key to both your ssh-agent and to the installation program.
NOTE
You can use this key to SSH into the master nodes as the user core. When you deploy the cluster, the
key is added to the core user’s ~/.ssh/authorized_keys list.
NOTE
You must use a local key, not one that you configured with platform-specific approaches
such as AWS key pairs.
Procedure
1. If you do not have an SSH key that is configured for password-less authentication on your
computer, create one. For example, on a computer that uses a Linux operating system, run the
following command:
1 Specify the path and file name, such as ~/.ssh/id_rsa, of the SSH key.
Running this command generates an SSH key that does not require a password in the location
that you specified.
IMPORTANT
If you create a new SSH key pair, avoid overwriting existing SSH keys.
$ ssh-add <path>/<file_name> 1
1 Specify the path and file name for your SSH private key, such as ~/.ssh/id_rsa
Next steps
When you install OpenShift Container Platform, provide the SSH public key to the installation
64
CHAPTER 1. INSTALLING ON BARE METAL
When you install OpenShift Container Platform, provide the SSH public key to the installation
program. If you install a cluster on infrastructure that you provision, you must provide this key to
your cluster’s machines.
Prerequisites
Obtain the OpenShift Container Platform installation program and the access token for your
cluster.
Obtain the imageContentSources section from the output of the command to mirror the
repository.
Procedure
$ mkdir <installation_directory>
IMPORTANT
You must create a directory. Some installation assets, like bootstrap X.509
certificates have short expiration intervals, so you must not reuse an installation
directory. If you want to reuse individual files from another cluster installation,
you can copy them into your directory. However, the file names for the
installation assets might change between releases. Use caution when copying
installation files from an earlier OpenShift Container Platform version.
NOTE
Unless you use a registry that RHCOS trusts by default, such as docker.io, you must provide
the contents of the certificate for your mirror repository in the additionalTrustBundle
section. In most cases, you must provide the certificate for your mirror.
You must include the imageContentSources section from the output of the command to
mirror the repository.
3. Back up the install-config.yaml file so that you can use it to install multiple clusters.
IMPORTANT
65
OpenShift Container Platform 4.4 Installing on bare metal
IMPORTANT
The install-config.yaml file is consumed during the next step of the installation
process. You must back it up now.
You can customize the install-config.yaml file to specify more details about your OpenShift Container
Platform cluster’s platform or modify the values of the required parameters.
apiVersion: v1
baseDomain: example.com 1
compute:
- hyperthreading: Enabled 2 3
name: worker
replicas: 0 4
controlPlane:
hyperthreading: Enabled 5 6
name: master 7
replicas: 3 8
metadata:
name: test 9
networking:
clusterNetwork:
- cidr: 10.128.0.0/14 10
hostPrefix: 23 11
networkType: OpenShiftSDN
serviceNetwork: 12
- 172.30.0.0/16
platform:
none: {} 13
fips: false 14
pullSecret: '{"auths":{"<bastion_host_name>:5000": {"auth": "<credentials>","email":
"[email protected]"}}}' 15
sshKey: 'ssh-ed25519 AAAA...' 16
additionalTrustBundle: | 17
-----BEGIN CERTIFICATE-----
ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ
-----END CERTIFICATE-----
imageContentSources: 18
- mirrors:
- <bastion_host_name>:5000/<repo_name>/release
source: quay.io/openshift-release-dev/ocp-release
- mirrors:
- <bastion_host_name>:5000/<repo_name>/release
source: registry.svc.ci.openshift.org/ocp/release
1 The base domain of the cluster. All DNS records must be sub-domains of this base and include the
cluster name.
2 5 The controlPlane section is a single mapping, but the compute section is a sequence of mappings.
To meet the requirements of the different data structures, the first line of the compute section
must begin with a hyphen, -, and the first line of the controlPlane section must not. Although both
66
CHAPTER 1. INSTALLING ON BARE METAL
sections currently define a single machine pool, it is possible that future versions of OpenShift
Container Platform will support defining multiple compute pools during installation. Only one
control plane pool is used.
IMPORTANT
4 You must set the value of the replicas parameter to 0. This parameter controls the number of
workers that the cluster creates and manages for you, which are functions that the cluster does not
perform when you use user-provisioned infrastructure. You must manually deploy worker machines
for the cluster to use before you finish installing OpenShift Container Platform.
8 The number of control plane machines that you add to the cluster. Because the cluster uses this
values as the number of etcd endpoints in the cluster, the value must match the number of control
plane machines that you deploy.
10 A block of IP addresses from which Pod IP addresses are allocated. This block must not overlap
with existing physical networks. These IP addresses are used for the Pod network, and if you need
to access the Pods from an external network, configure load balancers and routers to manage the
traffic.
11 The subnet prefix length to assign to each individual node. For example, if hostPrefix is set to 23,
then each node is assigned a /23 subnet out of the given cidr, which allows for 510 (2^(32 - 23) - 2)
pod IPs addresses. If you are required to provide access to nodes from an external network,
configure load balancers and routers to manage the traffic.
12 The IP address pool to use for service IP addresses. You can enter only one IP address pool. If you
need to access the services from an external network, configure load balancers and routers to
manage the traffic.
13 You must set the platform to none. You cannot provide additional platform configuration variables
for bare metal infrastructure.
14 Whether to enable or disable FIPS mode. By default, FIPS mode is not enabled. If FIPS mode is
enabled, the Red Hat Enterprise Linux CoreOS (RHCOS) machines that OpenShift Container
Platform runs on bypass the default Kubernetes cryptography suite and use the cryptography
modules that are provided with RHCOS instead.
15 For bastion_host_name, specify the registry domain name that you specified in the certificate for
your mirror registry, and for <credentials>, specify the base64-encoded user name and password
for your mirror registry.
16 The public portion of the default SSH key for the core user in Red Hat Enterprise Linux CoreOS
(RHCOS).
NOTE
67
OpenShift Container Platform 4.4 Installing on bare metal
NOTE
For production OpenShift Container Platform clusters on which you want to perform
installation debugging or disaster recovery, specify an SSH key that your ssh-agent
process uses.
17 Provide the contents of the certificate file that you used for your mirror registry.
18 Provide the imageContentSources section from the output of the command to mirror the
repository.
Production environments can deny direct access to the Internet and instead have an HTTP or HTTPS
proxy available. You can configure a new OpenShift Container Platform cluster to use a proxy by
configuring the proxy settings in the install-config.yaml file.
NOTE
For bare metal installations, if you do not assign node IP addresses from the range that is
specified in the networking.machineNetwork[].cidr field in the install-config.yaml file,
you must include them in the proxy.noProxy field.
Prerequisites
Review the sites that your cluster requires access to and determine whether any need to bypass
the proxy. By default, all cluster egress traffic is proxied, including calls to hosting cloud provider
APIs. Add sites to the Proxy object’s spec.noProxy field to bypass the proxy if necessary.
NOTE
Procedure
1. Edit your install-config.yaml file and add the proxy settings. For example:
apiVersion: v1
baseDomain: my.domain.com
proxy:
httpProxy: http://<username>:<pswd>@<ip>:<port> 1
httpsProxy: http://<username>:<pswd>@<ip>:<port> 2
noProxy: example.com 3
additionalTrustBundle: | 4
-----BEGIN CERTIFICATE-----
<MY_TRUSTED_CA_CERT>
-----END CERTIFICATE-----
...
68
CHAPTER 1. INSTALLING ON BARE METAL
1 A proxy URL to use for creating HTTP connections outside the cluster. The URL scheme
must be http. If you use an MITM transparent proxy network that does not require
additional proxy configuration but requires additional CAs, you must not specify an
httpProxy value.
2 A proxy URL to use for creating HTTPS connections outside the cluster. If this field is not
specified, then httpProxy is used for both HTTP and HTTPS connections. The URL
scheme must be http; https is currently not supported. If you use an MITM transparent
proxy network that does not require additional proxy configuration but requires additional
CAs, you must not specify an httpsProxy value.
NOTE
The installation program does not support the proxy readinessEndpoints field.
2. Save the file and reference it when installing OpenShift Container Platform.
The installation program creates a cluster-wide proxy that is named cluster that uses the proxy settings
in the provided install-config.yaml file. If no proxy settings are provided, a cluster Proxy object is still
created, but it will have a nil spec.
NOTE
Only the Proxy object named cluster is supported, and no additional proxies can be
created.
IMPORTANT
For more information about the support scope of Red Hat Technology Preview features,
see https://access.redhat.com/support/offerings/techpreview/.
You can install and run three-node clusters in OpenShift Container Platform with no workers. This
69
OpenShift Container Platform 4.4 Installing on bare metal
You can install and run three-node clusters in OpenShift Container Platform with no workers. This
provides smaller, more resource efficient clusters for cluster administrators and developers to use for
deployment, development, and testing.
Procedure
Edit the install-config.yaml file to set the number of compute replicas, which are also known as
worker replicas, to 0, as shown in the following compute stanza:
- compute:
name: worker
platform: {}
replicas: 0
IMPORTANT
The Ignition config files that the installation program generates contain certificates that
expire after 24 hours. You must complete your cluster installation and keep the cluster
running for 24 hours in a non-degraded state to ensure that the first certificate rotation
has finished.
Prerequisites
Obtain the OpenShift Container Platform installation program. For a restricted network
installation, these files are on your bastion host.
Procedure
1 For <installation_directory>, specify the installation directory that contains the install-
config.yaml file you created.
Because you create your own compute machines later in the installation process, you can safely
ignore this warning.
70
CHAPTER 1. INSTALLING ON BARE METAL
WARNING
If you are running a three-node cluster, skip the following step to allow the masters
to be schedulable.
NOTE
.
├── auth
│ ├── kubeadmin-password
│ └── kubeconfig
├── bootstrap.ign
├── master.ign
├── metadata.json
└── worker.ign
1.3.8.1. Creating Red Hat Enterprise Linux CoreOS (RHCOS) machines using an ISO image
Before you install a cluster on bare metal infrastructure that you provision, you must create RHCOS
machines for it to use. You can use an ISO image to create the machines.
71
OpenShift Container Platform 4.4 Installing on bare metal
Prerequisites
Have access to an HTTP server that you can access from your computer and that the machines
that you create can access.
Procedure
1. Upload the control plane, compute, and bootstrap Ignition config files that the installation
program created to your HTTP server. Note the URLs of these files.
2. Obtain the RHCOS images that are required for your preferred method of installing operating
system instances from the Product Downloads page on the Red Hat customer portal or the
RHCOS image mirror page.
IMPORTANT
The RHCOS images might not change with every release of OpenShift Container
Platform. You must download images with the highest version that is less than or
equal to the OpenShift Container Platform version that you install. Use the image
versions that match your OpenShift Container Platform version if they are
available.
You must download the ISO file and the RAW disk file. Those file names resemble the following
examples:
ISO: rhcos-<version>-installer.<architecture>.iso
3. Upload either the RAW RHCOS image file to your HTTP server and note its URL.
4. Use the ISO to start the RHCOS installation. Use one of the following installation options:
5. After the instance boots, press the TAB or E key to edit the kernel command line.
coreos.inst=yes
coreos.inst.install_dev=sda 1
coreos.inst.image_url=<bare_metal_image_URL> 2
coreos.inst.ignition_url=http://example.com/config.ign 3
ip=<dhcp or static IP address> 4 5
2 Specify the URL of the RAW image that you uploaded to your server.
3 Specify the URL of the Ignition config file for this machine type.
Set ip=dhcp or set an individual static IP address ( ip=) and DNS server (nameserver=) on
72
CHAPTER 1. INSTALLING ON BARE METAL
4 Set ip=dhcp or set an individual static IP address ( ip=) and DNS server (nameserver=) on
each node. For example, setting
ip=10.10.10.2::10.10.10.254:255.255.255.0:core0.example.com:enp1s0:none
nameserver=4.4.4.41 sets:
Netmask to 255.255.255.0
Hostname to core0.example.com
5 If you use multiple network interfaces or DNS servers, you can further customize the IP
address configuration in the following ways:
If your system has multiple network interfaces, you can add multiple IP address
configurations by specifying multiple ip= entries.
If your system has multiple network interfaces, you can use a combination of DHCP
and static IP configurations. You must specify the interface to use, for example
ip=enp1s0:dhcp
ip=10.10.10.2::10.10.10.254:255.255.255.0:core0.example.com:enp2s0:none.
You can provide multiple DNS servers by adding a nameserver= entry for each server,
such as nameserver=1.1.1.1 nameserver=8.8.8.8.
7. Press Enter to complete the installation. After RHCOS installs, the system reboots. After the
system reboots, it applies the Ignition config file that you specified.
IMPORTANT
You must create the bootstrap and control plane machines at this time. Because
some pods are deployed on compute machines by default, also create at least
two compute machines before you install the cluster.
1.3.8.2. Creating Red Hat Enterprise Linux CoreOS (RHCOS) machines by PXE or iPXE
booting
Before you install a cluster on bare metal infrastructure that you provision, you must create RHCOS
machines for it to use. You can use PXE or iPXE booting to create the machines.
Prerequisites
Have access to an HTTP server that you can access from your computer.
Procedure
1. Upload the master, worker, and bootstrap Ignition config files that the installation program
73
OpenShift Container Platform 4.4 Installing on bare metal
1. Upload the master, worker, and bootstrap Ignition config files that the installation program
created to your HTTP server. Note the URLs of these files.
2. Obtain the RHCOS ISO image, compressed metal RAW image, kernel and initramfs files from
the Product Downloads page on the Red Hat customer portal or the RHCOS image mirror
page.
IMPORTANT
The RHCOS images might not change with every release of OpenShift Container
Platform. You must download images with the highest version that is less than or
equal to the OpenShift Container Platform version that you install. Use the image
versions that match your OpenShift Container Platform version if they are
available.
The file names contain the OpenShift Container Platform version number. They resemble the
following examples:
ISO: rhcos-<version>-installer.<architecture>.iso
kernel: rhcos-<version>-installer-kernel-<architecture>
initramfs: rhcos-<version>-installer-initramfs.<architecture>.img
3. Upload the compressed metal RAW image and the kernel and initramfs files to your HTTP
server.
4. Configure the network boot infrastructure so that the machines boot from their local disks after
RHCOS is installed on them.
For PXE:
DEFAULT pxeboot
TIMEOUT 20
PROMPT 0
LABEL pxeboot
KERNEL http://<HTTP_server>/rhcos-<version>-installer-kernel-<architecture> 1
APPEND ip=dhcp rd.neednet=1 initrd=http://<HTTP_server>/rhcos-<version>-installer-
initramfs.<architecture>.img console=tty0 console=ttyS0 coreos.inst=yes
coreos.inst.install_dev=sda coreos.inst.image_url=http://<HTTP_server>/rhcos-
<version>-metal.<architecture>.raw.gz
coreos.inst.ignition_url=http://<HTTP_server>/bootstrap.ign 2 3
1 Specify the location of the kernel file that you uploaded to your HTTP server.
2 If you use multiple NICs, specify a single interface in the ip option. For example, to use
DHCP on a NIC that is named eno1, set ip=eno1:dhcp.
Specify locations of the RHCOS files that you uploaded to your HTTP server. The
74
CHAPTER 1. INSTALLING ON BARE METAL
Specify locations of the RHCOS files that you uploaded to your HTTP server. The
initrd parameter value is the location of the initramfs file, the coreos.inst.image_url
For iPXE:
1 Specify locations of the RHCOS files that you uploaded to your HTTP server. The
kernel parameter value is the location of the kernel file, the initrd parameter value is
the location of the initramfs file, the coreos.inst.image_url parameter value is the
location of the compressed metal RAW image, and the coreos.inst.ignition_url
parameter value is the location of the bootstrap Ignition config file.
2 If you use multiple NICs, specify a single interface in the ip option. For example, to use
DHCP on a NIC that is named eno1, set ip=eno1:dhcp.
3 Specify the location of the initramfs file that you uploaded to your HTTP server.
IMPORTANT
You must create the bootstrap and control plane machines at this time. Because
some pods are deployed on compute machines by default, also create at least
two compute machine before you install the cluster.
Prerequisites
You obtained the installation program and generated the Ignition config files for your cluster.
You used the Ignition config files to create RHCOS machines for your cluster.
Procedure
75
OpenShift Container Platform 4.4 Installing on bare metal
1 For <installation_directory>, specify the path to the directory that you stored the
installation files in.
2 To view different installation details, specify warn, debug, or error instead of info.
The command succeeds when the Kubernetes API server signals that it has been bootstrapped
on the control plane machines.
2. After bootstrap process is complete, remove the bootstrap machine from the load balancer.
IMPORTANT
You must remove the bootstrap machine from the load balancer at this point.
You can also remove or reformat the machine itself.
Prerequisites
Procedure
$ export KUBECONFIG=<installation_directory>/auth/kubeconfig 1
1 For <installation_directory>, specify the path to the directory that you stored the
installation files in.
2. Verify you can run oc commands successfully using the exported configuration:
$ oc whoami
system:admin
76
CHAPTER 1. INSTALLING ON BARE METAL
Prerequisites
Procedure
$ oc get nodes
2. Review the pending certificate signing requests (CSRs) and ensure that the you see a client and
server request with Pending or Approved status for each machine that you added to the
cluster:
$ oc get csr
In this example, two machines are joining the cluster. You might see more approved CSRs in the
list.
3. If the CSRs were not approved, after all of the pending CSRs for the machines you added are in
Pending status, approve the CSRs for your cluster machines:
NOTE
77
OpenShift Container Platform 4.4 Installing on bare metal
NOTE
Because the CSRs rotate automatically, approve your CSRs within an hour of
adding the machines to the cluster. If you do not approve them within an hour, the
certificates will rotate, and more than two certificates will be present for each
node. You must approve all of these certificates. After you approve the initial
CSRs, the subsequent node client CSRs are automatically approved by the
cluster kube-controller-manager. You must implement a method of
automatically approving the kubelet serving certificate requests.
To approve them individually, run the following command for each valid CSR:
Prerequisites
Procedure
78
CHAPTER 1. INSTALLING ON BARE METAL
The image-registry Operator is not initially available for platforms that do not provide default storage.
After installation, you must configure your registry to use storage so the Registry Operator is made
available.
Instructions for both configuring a PersistentVolume, which is required for production clusters, and for
configuring an empty directory as the storage location, which is available for only non-production
clusters, are shown.
As a cluster administrator, following installation you must configure your registry to use storage.
Prerequisites
Provision persistent storage for your cluster, such as Red Hat OpenShift Container Storage. To
deploy a private image registry, your storage must provide ReadWriteMany access mode.
Procedure
NOTE
79
OpenShift Container Platform 4.4 Installing on bare metal
NOTE
If the storage type is emptyDIR, the replica number cannot be greater than 1. If
the storage type is NFS, and you want to scale up the registry Pod by setting
replica>1 you must enable the no_wdelay mount option. For example:
# cat /etc/exports
/mnt/data *(rw,sync,no_wdelay,no_root_squash,insecure,fsid=0)
sh-4.2# exportfs -rv
exporting *:/mnt/data
$ oc edit configs.imageregistry.operator.openshift.io
storage:
pvc:
claim:
Leave the claim field blank to allow the automatic creation of an image-registry-storage PVC.
You must configure storage for the image registry Operator. For non-production clusters, you can set
the image registry to an empty directory. If you do so, all images are lost if you restart the registry.
Procedure
WARNING
If you run this command before the Image Registry Operator initializes its components, the oc
patch command fails with the following error:
80
CHAPTER 1. INSTALLING ON BARE METAL
Prerequisites
Procedure
When all of the cluster Operators are AVAILABLE, you can complete the installation.
81
OpenShift Container Platform 4.4 Installing on bare metal
1 For <installation_directory>, specify the path to the directory that you stored the
installation files in.
The command succeeds when the Cluster Version Operator finishes deploying the OpenShift
Container Platform cluster from Kubernetes API server.
IMPORTANT
The Ignition config files that the installation program generates contain
certificates that expire after 24 hours. You must keep the cluster running for 24
hours in a non-degraded state to ensure that the first certificate rotation has
finished.
3. Confirm that the Kubernetes API server is communicating with the Pods.
b. View the logs for a Pod that is listed in the output of the previous command by using the
following command:
1 Specify the Pod name and namespace, as shown in the output of the previous
command.
If the Pod logs display, the Kubernetes API server can communicate with the cluster
machines.
Next steps
82
CHAPTER 1. INSTALLING ON BARE METAL
83