Deploying a Standalone Baremetal Stack

The process described here will create a very minimal OVB environment, and the user will be responsible for creating most of the resources manually. In most cases it will be easier to use the QuintupleO deployment method, which creates most of the resources needed automatically.

  1. Create private network.

    If your cloud provider has already created a private network for your use then you can skip this step and reference the existing network in your OVB environment file.

    neutron net-create private
    neutron subnet-create --name private private --dns-nameserver

    You will also need to create a router so traffic from your private network can get to the external network. The external network should have been created by the cloud provider:

    neutron router-create router
    neutron router-gateway-set router [external network name or id]
    neutron router-interface-add router private
  2. Create provisioning network.


    The CIDR used for the subnet does not matter. Standard tenant and external networks are also needed to provide floating ip access to the undercloud and bmc instances


    Do not enable DHCP on this network. Addresses will be assigned by the undercloud Neutron.

    neutron net-create provision
    neutron subnet-create --name provision --no-gateway --disable-dhcp provision
  3. Create “public” network.


    The CIDR used for the subnet does not matter. This can be used as the network for the public API endpoints on the overcloud, but it does not have to be accessible externally. Only the undercloud VM will need to have access to this network.


    Do not enable DHCP on this network. Doing so may cause conflicts between the host cloud metadata service and the undercloud metadata service. Overcloud nodes will be assigned addresses on this network by the undercloud Neutron.

    neutron net-create public
    neutron subnet-create --name public --no-gateway --disable-dhcp public
  4. Copy the example env file and edit it to reflect the host environment:


    Some of the parameters in the base environment file are only used for QuintupleO deployments. Their values will be ignored in a plain virtual-baremetal deployment.

    cp environments/base.yaml env.yaml
    vi env.yaml
  5. Deploy the stack:

  6. Wait for Heat stack to complete:


    The BMC instance does post-deployment configuration that can take a while to complete, so the Heat stack completing does not necessarily mean the environment is entirely ready for use. To determine whether the BMC is finished starting up, run nova console-log bmc. The BMC service outputs a message like “Managing instance [uuid]” when it is fully configured. There should be one of these messages for each baremetal instance.

    heat stack-show baremetal
  7. Boot a VM to serve as the undercloud:

    nova boot undercloud --flavor m1.xlarge --image centos7 --nic net-id=[tenant net uuid] --nic net-id=[provisioning net uuid]
    neutron floatingip-create [external net uuid]
    neutron port-list
    neutron floatingip-associate [floatingip uuid] [undercloud instance port id]
  8. Turn off port-security on the undercloud provisioning port:

    neutron port-update [UUID of undercloud port on the provision network] --no-security-groups --port-security-enabled=False
  9. Build a nodes.json file that can be imported into Ironic:

    scp nodes.json centos@[undercloud floating ip]:~/instackenv.json


    build-nodes-json also outputs a file named bmc_bm_pairs that lists which BMC address corresponds to a given baremetal instance.

  10. The undercloud vm can now be used with something like TripleO to do a baremetal-style deployment to the virtual baremetal instances deployed previously.

Deleting an OVB Environment

All of the OpenStack resources created by OVB are part of the Heat stack, so to delete the environment just delete the Heat stack. There are a few local files that may also have been created as part of the deployment, such as nodes.json files and bmc_bm_pairs. Once the stack is deleted these can be removed safely as well.