The section describes the software requirements for nodes in a Bare Metal Orchestrator high availability cluster in the Red Hat Enterprise Linux environment.
All nodes in the Bare Metal Orchestrator cluster must have the same Linux environment, either Ubuntu 20.04 LTS or Red Hat Enterprise Linux 8.6. Ensure that the same Linux user account is configured on all nodes.
Global Controller (CP1) and HA nodes (CP2 and CP3) software requirements for Red Hat Enterprise Linux environments
Ensure that the VMs hosting the two redundant HA nodes (CP2 and CP3) and Load Balancers are reachable from the Global Controller (CP1) host over the network. From the Global Controller host, you should be able to ssh <user>@<ip_address>
to each of the four VMs, where <ip_address>
is the IP address of the VM. For more information about network requirements, see Network requirements.
The VMs hosting CP1, CP2, and CP3 must be accessible over the network using the root account.
Before you deploy Bare Metal Orchestrator in a Red Hat Enterprise Linux environments, set up the VM hosting the Global Controller (CP1), and the two redundant HA nodes (CP2 and CP3) as follows:
Item | Details |
Operating system | The VM hosting the Global Controller node must have a Red Hat Enterprise Linux 8.6 environment. SSH must be enabled and ensure the following Linux utilities are installed and running on the node: jq, coreutils, mktemp, openiscsi, curl, findmnt, grep, awk, blkid, and lsblk. |
Enable Red Hat Enterprise Linux subscription | Run subscription-manager register# enter your RHEL credentials as root user. |
Install packages | Run these commands as root user after registering the subscription in all CP1, CP2, CP3, worker and Load Balancer nodes: |
Disable firewall | Run these commands as root user: |
Install Docker on CP1 | Install Docker version 20.10.11. Note: You must manually add the common installer username to the Docker group. For example: sudo adduser <username> docker |
Edit the kernel | Set the default virtual memory limit of the servers hosting the Global Controller node to 262114 in the sysctl.conf file and make it persistent. Run the following to change the kernel configuration, and then save the sysctl.conf file: Run CAUTION: If the virtual memory is not properly configured on the CP1, CP2, and CP3 nodes, Bare Metal Orchestrator logs do not display in the OpenSearch dashboard and the GC site goes into the failed state. |
Install iscsi | You must install iscsid. Run the following commands to install iscsi: |
Load Balancer software requirements for Red Hat Enterprise Linux environments
Ensure the VMs that host the two redundant Load Balancers are reachable from the Global Controller host over the network. From the Global Controller host, you should be able to ssh root@<ip_address>
to each of the VMs, where <ip_address>
is the IP address of the VM.
The VMs hosting the Load Balancers must be accessible over the network using the root account.
Set up both Load Balancer VMs for Red Hat Enterprise Linux environments as described in the following table:
Item | Details |
Operating system | The VMs hosting the two Load Balancers must have a Red Hat Enterprise Linux 8.6 environment. |
Enable Red Hat Enterprise Linux subscription | Run subscription-manager register# enter your RHEL credentials as root user. |
Install packages | Run the following command as root user: |
Disable Firewall | Run these commands as root user: |
Install NGINX | Run the following command: |
For worker node requirements, see Worker node software requirements–Red Hat Enterprise Linux.
For storage requirements, see Storage requirements.