Configure an OpenStack environment on nodes with multipath block devices

Configure an OpenStack environment on nodes with multipath block devicesΒΆ

You can deploy your OpenStack environment on servers with disks provided by storage systems with multipath I/O.

The advantages of using the multipath disk configuration feature include:

  • Proper discovering of multipath block devices and showing one storage device on server per a single multipath back-end block device.
  • Mapping multipath block devices to a host operating system, Cinder LVM, MongoDB storage, and so on.
  • Deploying an OpenStack environment with multiple multipath block devices attached to a single node.
  • Combining a configuration of multipath block devices with the directly attached drives within a single node.


Fuel supports only multipath block devices provided by Host-Based Adapter (HBA).

To configure an OpenStack environment on nodes with multipath block devices:

  1. Verify that the default bootable device meets the needs of your environment.

    By default, Fuel boots the first detected disk. You may need to change the default settings. For example, when the boot-loader is configured to boot from LUN other than LUN0. If you need to specify the bootable device, complete the steps described in Select a bootable device for a node.

  2. If you need an additional HBA card driver to run in the environment:

    1. Log in to the Fuel Master node.

    2. Add the HBA card driver by running:

      fuel-bootstrap build --package <package_name> --label fc_bootstrap


      If the required package is not located in the preconfigured for bootstrap repositories, specify the required repository by passing the --repo 'type uri distribution [components][,priority]' argument to the fuel-bootstrap build command.

    3. Log in to the Fuel web UI.

    4. On the Nodes tab, view the disks information on receiving the new node appeared online notification.

      The disks` details include the paths that correspond to the underlying paths to the multipath block devices.

    5. Configure the IBP (image-based provisioning) images for provisioning:

      • Using the Fuel web UI:

        1. Log in to the Fuel web UI.
        2. Click the Settings > Provision tab.
        3. Specify the Initial packages to provision.
      • Using the Fuel CLI:

        1. Log in to the Fuel Master node.

        2. Download the OpenStack environment configuration file:

          fuel settings --env-id=<env_id> --download
        3. Open settings_<env_id>.yaml for editing.

        4. In the editable/provision/packages/value section, change the initial package name.


          If the required package is located in the repository that is not included in the list, add the repository details to editable/repo_setup/repos/value of the settings_<env_id>.yaml file.

        5. Upload the modified settings to Fuel:

          fuel settings --env-id=<env_id> --upload
  3. Deploy your OpenStack environment as described in Deploy an OpenStack environment.

Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.