Mirantis Container Cloud (MCC) becomes part of Mirantis OpenStack for Kubernetes (MOSK)!
Starting with MOSK 25.2, the MOSK documentation set covers all product layers, including MOSK management (formerly Container Cloud). This means everything you need is in one place. Some legacy names may remain in the code and documentation and will be updated in future releases. The separate Container Cloud documentation site will be retired, so please update your bookmarks for continued easy access to the latest content.
Add a bare metal host using MOSK management console¶
This section describes how to add bare metal hosts using the
MOSK management console during a MOSK
cluster creation.
Before you proceed with adding a bare metal host:
Verify that the physical network on the server has been configured correctly.
For details, see Physical networks layout.
You can view the created profiles in the BM Host Profiles
tab of the MOSK management console.
Log in to the MOSK management console with the
m:kaas@operator or m:kaas:namespace@bm-pool-operator permissions.
Switch to the required non-default project using the
Switch Project action icon located on top of the main left-side
navigation panel.
Caution
Do not create a MOSK cluster in the default project
(Kubernetes namespace), which is dedicated for the management cluster only.
If no projects are defined, first create a new mosk project as described
in Create a project for MOSK clusters.
Optional. Available since Container Cloud 2.24.0 (Cluster releases 15.0.1
and 14.0.1). In the Credentials tab, click
Add Credential and add the IPMI user name and password of the
bare metal host to access the Baseboard Management Controller (BMC).
Select one of the following options:
Since Container Cloud 2.30.0 (21.0.0 and 20.0.0)
In the Baremetal tab, click Create Host
Inventory.
Fill out the Create baremetal host inventory form:
Name
Specify the name of the new bare metal host.
Boot Mode
Specify the BIOS boot mode. Available options: Legacy,
UEFI, or UEFISecureBoot.
MAC Address
Specify the MAC address of the PXE network interface.
Baseboard Management Controller (BMC)
Specify the following BMC details:
IP Address
Specify the IP address to access the BMC.
Credential Name
Specify the name of the previously added bare metal host
credentials to associate with the current host.
Cert Validation
Enable validation of the BMC API certificate. Applies only to
the redfish+http BMC protocol. Disabled by default.
Power off host inventory after creation
Experimental. Select to power off the bare metal host inventory
after creation.
Caution
This option is experimental and intended only for
testing and evaluation purposes. Do not use it for
production deployments.
Since Container Cloud 2.26.0 (17.1.0 and 16.1.0)
In the Baremetal tab, click Create Host.
Fill out the Create baremetal host form as required:
Name
Specify the name of the new bare metal host.
Boot Mode
Specify the BIOS boot mode. Available options: Legacy,
UEFI, or UEFISecureBoot.
MAC Address
Specify the MAC address of the PXE network interface.
Baseboard Management Controller (BMC)
Specify the following BMC details:
IP Address
Specify the IP address to access the BMC.
Credential Name
Specify the name of the previously added bare metal host
credentials to associate with the current host.
Cert Validation
Enable validation of the BMC API certificate. Applies only to the
redfish+http BMC protocol. Disabled by default.
Power off host after creation
Experimental. Select to power off the bare metal host after
creation.
Caution
This option is experimental and intended only for
testing and evaluation purposes. Do not use it for
production deployments.
Before Container Cloud 2.26.0 (17.0.0, 16.0.0, or earlier)
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.
Provider Credential
Optional. Available since Container Cloud 2.24.0 (Cluster releases
15.0.1 and 14.0.1). Specify the name of the previously added bare
metal host credentials to associate with the current host.
Add New Credential
Optional. Available since Container Cloud 2.24.0 (Cluster releases
15.0.1 and 14.0.1). Applies if you did not add bare metal host
credentials using the Credentials tab. Add the bare metal
host credentials:
Username
Specify the name of the IPMI user to access the BMC.
Password
Specify the IPMI password of the user to access the BMC.
Boot MAC address
Specify the MAC address of the PXE network interface.
IP Address
Specify the IP address to access the BMC.
Label
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:
Manager
This label is selected and set by default. Assign this label t
the bare metal hosts that can be used to deploy machines with the
manager type. These hosts must match the CPU and RAM
requirements described in MOSK cluster hardware requirements.
Worker
The host with this label may be used to deploy the worker
machine type. Assign this label to the bare metal hosts that have
sufficient CPU and RAM resources, as described in
MOSK cluster hardware requirements.
Storage
Assign this label to the bare metal hosts that have sufficient
storage devices to match MOSK cluster hardware requirements. Hosts with this
label will be used to deploy machines with the storage type that
run Ceph OSDs.
Click Create.
While adding the bare metal host, MOSK discovers and
inspects the hardware of the bare metal host and adds it to
BareMetalHost.status for future references.
During provisioning, baremetal-operator inspects the bare metal host
and moves it to the Preparing state. 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:
Select one of the following options:
Since MCC 2.26.0 (17.1.0 and 16.1.0)
In the left sidebar, click Baremetal. The
Hosts page opens.
Before MCC 2.26.0 (17.0.0, 16.0.0, or earlier)
In the left sidebar, click BM Hosts.
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
Select one of the following options:
Since MCC 2.26.0 (17.1.0 and 16.1.0)
On the Hosts page, click the host kebab menu and select
Host info.
Before MCC 2.26.0 (17.0.0, 16.0.0, or earlier)
On the BM Hosts page, 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
Create a MOSK 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 MOSK.