Mirantis Fuel is a bare-metal installer for OpenStack. Mirantis provides a way to virtualize the setup using VirtualBox. Decided to virtualize Mirantis Fuel using vagrant-libvirt. Using a Vagrant Box opens the door to build virtual setups that include the underlay, like the switches (Cumulus VX) and external routers (Cisco VM)

Download the Mirantis Fuel ISO

Mirantis does not provide a URL for the ISO, so you have to sign up for it on the Mirantis Fuel Download Page.

Have not tried this yet, but you can get a copy of the Community edition from the Openstack Fuel Wiki

Copy the ISO to the $HOME/openstack directory. This is where the packer template is assuming the ISO to be.

Build the Mirantis Fuel Vagrant Box

git clone http://github.com/linuxsimba/packer-libvirt-profiles
  • Assign a temporary directory with at least 30GB of space. Defaults to /tmp. If /tmp is small then the build process will fail with a space exceeded message.
export TMPDIR=$HOME/tmp
  • Go to the packer build repo and run packer. Wait 14-45 minutes depending on the speed of your PC.
cd packer-libvirt-profiles
packer build packer build mirantis-7-x86_64.json

A vagrant libvirt box will be created in the following packer build repo directory.

==> qemu (vagrant): Creating Vagrant Box for 'libvirt' provider
    qemu (vagrant): Copying from artifact: packer-mirantis-7-qemu/mirantis-7
    qemu (vagrant): Compressing: Vagrantfile
    qemu (vagrant): Compressing: box.img
    qemu (vagrant): Compressing: metadata.json
Build 'qemu' finished.

==> Builds finished. The artifacts of successful builds are:
--> qemu: 'libvirt' provider box: builds/mirantis-fuel-7.libvirt.box
  • Copy the Vagrant Box into the default Vagrant Box location
vagrant box add builds/mirantis-fuel-7.libvirt.box --name "mirantis-7"

Start the Topology

mkdir $HOME/openstack-mirantis
cd $HOME/openstack-mirantis
vagrant init
cp $HOME/git/packer-libvirt-profiles/vagrantfile_examples/Vagrantfile.mirantis Vagrantfile
vagrant up --no-parallel

Using the example Vagrantfile the test virtual setup looks the topology shown above. It has a back-to-back connection between the first server and the 2nd server.

There is back-to-back connection for simplicity. Mirantis, with VLAN segmentation configures the non-admin NIC as a trunk with VLANS for storage, management and Openstack projects. A NIC is dedicated the public network with an IP address on a bridge interface (SVI) of This is the default IP range used for the public network settings in the Mirantis Fuel Network Settings. This step was necessary to include in the setup because the installer attempts to ping the public network gateway. If the ping fails the install never completes. The next step was to ensure the libvirt bridge interface on the vagrant hypervisor, is using NAT. This provides the ability to run the Calico Plugin, which downloads Calico code from the internet.

Future updates to this post, will include switches between the servers with a more realistic IP layout.

The topology takes advantage of the libvirt PXE boot feature. So the Server nodes come up in vagrant but the disks are empty. Vagrant can only halt or start a PXE enabled Vagrant instance. Use virsh commands instead for any other commands.

Would be interesting to know how PXE booting works with the Vagrant-Virtualbox provider.

Run vagrant with no-parallel because the Fuel master needs to be up and running first, to become a PXE and DHCP server for the openstack server nodes.

It will take a while for the Fuel master to load, because it has to install docker containers. On my Intel I5 server it took about 40 minutes to complete. About 20 minutes was needed to setup the APT mirror.

A port forward setting is configured in Vagrant, to access the Fuel GUI when vagrant up has completed.

Go to http://localhost:8000 to access the Fuel Dashboard. The username and password is admin/admin.

In the Fuel GUI ensure that the 2nd interface (eth1) is configured as the public, storage, management and private interface. Pictures of this can be found here