Create and provision the control plane VMs

Create and provision the control plane VMsΒΆ

The control plane VMs are created on each node by running the salt state. This state leverages the salt virt module along with some customizations defined in a Mirantis formula called salt-formula-salt. Similarly to how MAAS manages bare metal, the salt virt module creates VMs based on profiles that are defined in the metadata and mounts the virtual disk to add the appropriate parameters to the minion configuration file.

After the salt state successfully runs against a KVM node where metadata specifies the VMs placement, these VMs will be started and automatically added to the Salt Master node.

To create control plane VMs:

  1. Log in to the KVM nodes that do not host the Salt Master node. The correct physical node names used in the installation described in this guide to perform the next step are kvm02 and kvm03.


    Otherwise, on running the command in the step below, you will delete the cfg Salt Master.

  2. Verify whether virtual machines are not yet present:

    virsh list --name --all | grep -Ev '^(mas|cfg|apt)' | xargs -n 1 virsh destroy
    virsh list --name --all | grep -Ev '^(mas|cfg|apt)' | xargs -n 1 virsh undefine
  3. Log in to the Salt Master node console.

  4. Verify that the Salt Minion nodes are synchronized by running the following command on the Salt Master node:

    salt '*' saltutil.sync_all
  5. Perform the initial Salt configuration:

    salt 'kvm*' state.sls salt.minion
  6. Set up the network interfaces and the SSH access:

    salt -C 'I@salt:control' 'salt-call state.sls \


    This will also reboot the Salt Master node because it is running on top of kvm01.

  7. Log in back to the Salt Master node console.

  8. Run the libvirt state:

    salt 'kvm*' state.sls libvirt
  9. For the OpenStack-based MCP clusters, add system.salt.control.cluster.openstack_gateway_single to infra/kvm.yml to enable a gateway VM for your OpenStack environment. Skip this step for the Kubernetes-based MCP clusters.

  10. Run salt.control to create virtual machines. This command also inserts minion.conf files from KVM hosts:

    salt 'kvm*' state.sls salt.control
  11. Verify that all your Salt Minion nodes are registered on the Salt Master node. This may take a few minutes.


    Example of system response: