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 the packer repo with the Mirantis Fuel packer build script
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.
- 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 172.16.0.1/24. 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 172.16.0.1/24 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
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