Add a bare metal host using web UI¶
This section describes how to add bare metal hosts using the Container Cloud web UI during a managed cluster creation.
Before you proceed with adding a bare metal host:
Verify that the physical network on the server has been configured correctly. See Network fabric for details.
Enable the boot NIC support for UEFI load. Usually, at least the built-in network interfaces support it.
Enable the UEFI-LAN-OPROM support in BIOS -> Advanced -> PCIPCIe.
Enable the IPv4-PXE stack.
Set the following boot order:
If your PXE network is not configured to use the first network interface, fix the UEFI-PXE boot order to speed up node discovering by selecting only one required network interface.
Power off all bare metal hosts.
Only one Ethernet port on a host must be connected to the
PXE network at any given time. The physical address
(MAC) of this interface must be noted and used to configure
BareMetalHost object describing the host.
To add a bare metal host to a baremetal-based managed cluster:
Optional. Create a custom bare metal host profile depending on your needs as described in Create a custom bare metal host profile.
You can view the created profiles in the BM Host Profiles tab of the Container Cloud web UI.
Log in to the Container Cloud web UI with the
Switch to the required non-
defaultproject using the Switch Project action icon located on top of the main left-side navigation panel.
To create a project, refer to Create a project for managed clusters.
In the Baremetal tab, click Add BM host.
Fill out the Add new BM host form as required:
- Baremetal host name
Specify the name of the new bare metal host.
Specify the name of the user for accessing the BMC (IPMI user).
Specify the password of the user for accessing the BMC (IPMI password).
- Boot MAC address
Specify the MAC address of the PXE network interface.
- IP Address
Specify the IP address to access the BMC.
Assign the machine label to the new host that defines which type of machine may be deployed on this bare metal host. Only one label can be assigned to a host. The supported labels include:
This label is selected and set by default. Assign this label to the bare metal hosts that can be used to deploy machines with the
managertype. These hosts must match the CPU and RAM requirements described in Reference hardware configuration.
The host with this label may be used to deploy the
workermachine type. Assign this label to the bare metal hosts that have sufficient CPU and RAM resources, as described in Reference hardware configuration.
Assign this label to the bare metal hosts that have sufficient storage devices to match Reference hardware configuration. Hosts with this label will be used to deploy machines with the storage type that run Ceph OSDs.
While adding the bare metal host, Container Cloud discovers and inspects the hardware of the bare metal host and adds it to
BareMetalHost.statusfor future references.
baremetal-operatorinspects the bare metal host and moves it to the
Preparingstate. The host becomes ready to be linked to a bare metal machine.
Verify the results of the hardware inspection to avoid unexpected errors during the host usage:
In the BM Hosts tab, verify that the bare metal host is registered and switched to one of the following statuses:
Preparing for a newly added host
Ready for a previously used host or for a host that is already linked to a machine
Click the name of the newly added bare metal host.
In the window with the host details, scroll down to the Hardware section.
Review the section and make sure that the number and models of disks, network interface cards, and CPUs match the hardware specification of the server.
If the hardware details are consistent with the physical server specifications for all your hosts, proceed to Add a managed baremetal cluster.
If you find any discrepancies in the hardware inspection results, it might indicate that the server has hardware issues or is not compatible with Container Cloud.