Prepare the seed node

Before installing Mirantis Container Cloud on a bare metal environment, complete the following preparation steps:

  1. Verify that the hardware allocated for the installation meets the minimal requirements described in Requirements for a baremetal-based cluster.

  2. Install basic Ubuntu 20.04 server using standard installation images of the operating system on the bare metal seed node.

  3. Log in to the seed node that is running Ubuntu 20.04.

  4. Prepare the system and network configuration:

    1. Establish a virtual bridge using an IP address of the PXE network on the seed node. Use the following netplan-based configuration file as an example:

      # cat /etc/netplan/config.yaml
        version: 2
        renderer: networkd
              dhcp4: false
              dhcp6: false
                # Replace with IP address from PXE network to create a virtual bridge
                dhcp4: false
                dhcp6: false
                # Adjust for your environment
                # Interface name may be different in your environment
                - ens3
                    # Adjust for your environment
                    forward-delay: 4
                    stp: false
    2. Apply the new network configuration using netplan:

      sudo netplan apply
    3. Verify the new network configuration:

      sudo apt update && sudo apt install -y bridge-utils
      sudo brctl show

      Example of system response:

      bridge name     bridge id               STP enabled     interfaces
      br0             8000.fa163e72f146       no              ens3

      Verify that the interface connected to the PXE network belongs to the previously configured bridge.

    4. Install the current Docker version available for Ubuntu 20.04:

      sudo apt-get update
      sudo apt-get install
    5. Verify that your logged USER has access to the Docker daemon:

      sudo usermod -aG docker $USER
    6. Log out and log in again to the seed node to apply the changes.

    7. Verify that Docker is configured correctly and has access to Container Cloud CDN. For example:

      docker run --rm alpine sh -c "apk add --no-cache curl; \

      The system output must contain a json file with no error messages. In case of errors, follow the steps provided in Troubleshooting.


      If you require all Internet access to go through a proxy server for security and audit purposes, configure Docker proxy settings as described in the official Docker documentation.

  5. Verify that the seed node has direct access to the Baseboard Management Controller (BMC) of each bare metal host. All target hardware nodes must be in the power off state.

    For example, using the IPMI tool:

    apt install ipmitool
    ipmitool -I lanplus -H 'IPMI IP' -U 'IPMI Login' -P 'IPMI password' \
    chassis power status

    Example of system response:

    Chassis Power is off