Installing IML on Vagrant

Software Contributor Documentation Table of Contents



Please refer to on how to create a virtual HPC storage cluster with vagrant before attempting to install IML.

  1. Install Virtualbox and Vagrant

  2. Verify that the following vagrant plugins are installed:

    vagrant plugin list
    vagrant plugin install vagrant-shell-commander
    vagrant plugin install vagrant-proxyconf    <--- Optional, for example, this may be needed if behind corporate firewall.
  3. Clone the Vagrantfiles repo from github

    git clone
  4. navigate to the Vagrantfiles/iml-sandbox directory

  5. Start the VM cluster

    vagrant up

Installing IML

  1. Install IML via vagrant provisioning

    vagrant provision adm --provision-with install-iml-5
  2. Test that a connection can be made to IML by going to the following link in your browser: https://localhost:8443

Adding Servers

You should now be able to see IML when navigating to https://localhost:8443. Click on the login link at the top right and log in as the admin user (password: lustre). After logging in, go to the servers page by selecting the following:

Configuration -> Servers

Click the Add Servers button and enter the following hostlist expression:


Click the Next button and all servers will be verified for installation. After verifying all servers, proceed to the profile selection screen. Select the appropriate profile based on the setup type:

Finally, select the Proceed button and the servers will be configured based upon the selected profile.

Configuring Interfaces

Once all servers have been added, each server will need to know which interface should be assigned the lustre network. This can be done manually or automated by a provisioning script depending on the type of filesystem being created.

1. Managed ldiskfs and ZFS filesystems

On the servers page, navigate to each server’s detail page by clicking on the server link. Scroll to the bottom of the server detail page where you will see a list of network interfaces. Click on the Configure button and you will be given the option to change the network driver and the network for each interface.

The vagrant file indicates that the lustre network will run on 10.73.20.x. If Lustre Network 0 is specified for a different IP address, you will need to change its interface to Not Lustre Network and update the network for 10.73.20.x to use Lustre Network 0. It is very important that Lustre Network 0 is specified on the correct interface; otherwise, creating a filesystem will fail. Make sure that all servers have been updated where appropriate.

2. Monitor only ldiskfs and ZFS filesystems

The interfaces can be configured automatically by running the following script:

 vagrant provision mds1 mds2 oss1 oss2 --provision-with configure-lustre-network

Continue with Setup

Select the following options to continue setting up the filesystem:

Monitored ZFS

Monitored ldiskfs

Managed ZFS

Top of page