Installing Mirantis Fuel 8.0 on Virtual Box

Hi All,

Today we are going to see about how to install Miranis Fuel 8.0 in laptop



You can install Fuel on VirtualBox and use that to deploy a Mirantis OpenStack environment for demonstration and evaluation purposes. Mirantis provides scripts that create and configure all the VMs required for a test environment, including the Master node and Slave nodes.

Here we going to discuss about how to run Fuel and Mirantis OpenStack on VirtualBox.


Running Fuel and Mirantis OpenStack on VirtualBox has a number of prerequisites and dependencies. Before proceding with the deployment steps, please verify whether you meet these requirements:

  1. Run VirtualBox on a stable host system; we recommend 64-bit host OS. The scripts have been tested on Mac OS 10.7.5, Mac OS 10.8.3, Ubuntu 12.04, Ubuntu 12.10, Ubuntu 14.04, Fedora 19, OpenSUSE 12.2/12.3, Windows 7 x64 + Cygwin_x64, and Windows 8 x64 + Cygwin_x64.
  2. Download and install VirtualBox
  3. Download and install VirtualBox extensions.
  4. Download Mirantis VirtualBox scripts from the Downloads tab.
  5. Download the Mirantis OpenStack ISO.

If you want to run these scripts on Windows directly, you should also:

  1. Download and install Cygwin for 64-bit version of Windows.

  2. Select expect, openssh, and procps packages to install.

    To do this, search by the names of the packages required in the Select Packages dialog of the Cygwin install wizard:


Hardware Recommendations: 8 GB+ of RAM

  • Supports 4 VMs for Multi-node OpenStack installation (1 Master node, 1 Controller node, 1 Compute node, 1 Cinder node). The size of each VM should be reduced to 1536 MB RAM. For dedicated Cinder node, 768 MB of RAM is enough.


  • Supports 5 VMs for Multi-node with HA OpenStack installation (1 Master node, 3 combined Controller + Cinder nodes, 1 Compute node). The size of each VM should be reduced to 1280 MB RAM. This is less that the recommended amount of RAM amount per node for HA configurations (2048+ MB per controller) and may lead to unwanted issues.


Installing Using Automated Scripts

  1. Extract Mirantis VirtualBox scripts. The package should include the following:


    The directory containing the ISO image used to install Fuel. You should download the ISO from the portal to this directory or copy it into this directory after it is downloaded. If this directory contains more than one ISO file, the installation script uses the most recent one.

    Configuration file that allows you to specify parameters that automate the Fuel installation. For example, you can select how many virtual nodes to launch, as well as how much memory, disk, and processing to allocate for each.

    This is the script you run to install Fuel. It uses the ISO image from the iso directory, creates a VM, mounts the image, and automatically installs the Fuel Master node. After installing the Master node, the script creates Slave nodes for OpenStack and boots them via PXE from the Master node. When Fuel is installed, the script gives you the IP address to use to access the Web-based UI for Fuel. Use this address to deploy your OpenStack environment.

  2. Add Mirantis OpenStack ISO to the extracted VirtualBox iso folder.

  3. Run the script to install Fuel.

    For the Windows users:

    • Navigate to directory with the file in Cygwin prompt, for example: cd /cygdrive/c/Users/{name}/Desktop/virtualbox

    • Use the sh {shell script} command to run a shell script in Cygwin:


    The Fuel installation is complete when the VirtualBox fuel-master node shows the following details about your environment:


  4. See the Launch Wizard to Create New Environment for the instructions on how to log in to the Fuel UI and set up your first environment.

Manual Installation


The following steps are suitable only for setting up a vanilla OpenStack environment for evaluation purposes only.

If you cannot or would rather not run our helper scripts, you can still run Fuel on VirtualBox by following these steps.

Deploying the Master Node Manually

First, create the Master node VM.

  1. Configure the host-only interface vboxnet0 in VirtualBox by going to File -> Preferences -> Network, then on the Host-only Networks tab click the screwdriver icon:

    • IP address:
    • Network mask:
    • DHCP Server: disabled

    _images/host-only-networks-preferences.png _images/host-only-networks-details.png

  2. Create a VM for the Fuel Master node with the following parameters:

    • OS Type: Linux
    • Version: Ubuntu (64bit)
    • RAM: 1536+ MB (2048+ MB recommended)
    • HDD: 50 GB with dynamic disk expansion
  3. Modify your VM settings:

    • Network: Attach Adapter 1 to Host-only adapter vboxnet0
  4. Power on the VM in order to start the installation. Choose your Fuel ISO when prompted to select start-up disk.

  5. Wait for the Welcome message with all information needed to login into the UI of Fuel.

Adding Slave Nodes Manually

Configure the host-only interfaces.

  1. In the VirtualBox main window, go to File -> Preferences -> Network. On the Host-only Networks tab, click the screwdriver icon.

    • Create network vboxnet1:

      • IP address:
      • Network mask:
      • DHCP Server: disabled


    • Сreate network vboxnet2:

      • IP address:
      • Network mask:
      • DHCP Server: disabled


Next, create Slave nodes where OpenStack needs to be installed.

  1. Create 3 or 4 additional VMs with the following parameters:

    • OS Type: Linux, Version: Ubuntu (64bit)
    • RAM: 1536+ MB (2048+ MB recommended)
    • HDD: 50+ GB, with dynamic disk expansion
    • Network 1: host-only interface vboxnet0, Intel PRO/1000 MT desktop driver
  2. Set Network as first in the boot order:


  3. Configure two or more network adapters on each VM (in order to use single network adapter for each VM you should choose Use VLAN Tagging later in the Fuel UI):


  4. Open Advanced collapse, and set the following options:

    • Set Promiscuous mode to Allow All
    • Set Adapter Type to Intel PRO/1000 MT Desktop
    • Check Cable connected

Fuel Node Setup

  1. Boot Fuel Master Server from the ISO image as a virtual DVD (click here to download ISO image).
  2. Choose option 1. and press the TAB button to edit default options:
  3. a. Remove the default gateway (
    b. Change the DNS to (the Fuel VM IP).
    c. Add the following command to the end: “showmenu=yes”
    The tuned boot parameters should look like this:

    Note: Do not try to change eth0 to another interface or the deployment might fail.
    1. Fuel VM will reboot itself after the initial installation is completed and the Fuel menu will appear.
      Note: Ensure that the VM will start from the Local Disk and not CD-ROM. Otherwise you will restart the installation from beginning.
    2. Begin the network setup:
      1. Configure eth0 as the PXE (Admin) network interface.
        Ensure the default Gateway entry is empty for the interface. The network is enclosed within the switch and has no routing outside.
        Select Apply.
      2. Configure eth1 as the Public network interface.
        The interface is routable to LAN/internet and will be used to access the server. Configure the static IP address, netmask and default gateway on the public network interface, Here Eth1 is our vboxnet1, set settings as below

        • IP address:
        • Network mask:

        Select Apply.

    1. Set the PXE Setup.
      The PXE network is enclosed within the switch. Use the default settings.
      Press the Check button to ensure no errors are found.
    2. Set the Time Sync.
      a. Choose the Time Sync option on the left-hand Menu.
      b. Configure the NTP server entries suitable for your infrastructure.
      c. Press Check to verify settings.
    3. Proceed with the installation.
      Navigate to Quit Setup and select Save and Quit.

      Once the Fuel installation is done, you will see Fuel access details both for SSH and HTTP.
    4. Configure the Fuel Master VM SSH server to allow connections from Public network.By default Fuel will accept SSH connections from Admin(PXE) network only.

      Follow the below steps to allow connections from Public Network:

      1. Use virt-manager to access Fuel Master VM console
      2. Edit sshd_config:

        # vi /etc/ssh/sshd_config

      3. Find and comment this line:


      4. Restart sshd:

        # service sshd restart

    5. Access Fuel using one of the following ( To access from Desktop do port forwarding with URL and port 8000 or any port to your comfort)
    • Web UI by (use admin/admin as user/password)
    • SSH by connect to (use root/r00tme as user/password)


Here we go !!