Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 25. Configuring Direct Deploy

When provisioning nodes, director mounts the overcloud base operating system image on an iSCSI mount and then copies the image to disk on each node. Direct deploy is an alternative method that writes disk images from a HTTP location directly to disk on bare metal nodes.

Note

Support for the iSCSI deploy interface, iscsi, will be deprecated in Red Hat OpenStack Platform (RHOSP) version 17.0, and will be removed in RHOSP 18.0. Direct deploy, direct, will be the default deploy interface from RHOSP 17.0.

The iSCSI deploy interface is the default deploy interface. However, you can enable the direct deploy interface to download an image from a HTTP location to the target disk.

Note

Support for the iSCSI deploy interface will be deprecated in Red Hat OpenStack Platform (RHOSP) version 17.0, and will be removed in RHOSP 18.0. Direct deploy will be the default deploy interface from RHOSP 17.0.

Prerequisites

  • Your overcloud node memory tmpfs must have at least 8GB of RAM.

Procedure

  1. Create or modify a custom environment file /home/stack/undercloud_custom_env.yaml and specify the IronicDefaultDeployInterface. 

    parameter_defaults:
  IronicDefaultDeployInterface: direct
    Copy to Clipboard Toggle word wrap

  2. By default, the Bare Metal service (ironic) agent on each node obtains the image stored in the Object Storage service (swift) through a HTTP link. Alternatively, ironic can stream this image directly to the node through the ironic-conductor HTTP server. To change the service that provides the image, set the IronicImageDownloadSource to http in the /home/stack/undercloud_custom_env.yaml file: 

    parameter_defaults:
  IronicDefaultDeployInterface: direct
  IronicImageDownloadSource: http
    Copy to Clipboard Toggle word wrap

  3. Include the custom environment file in the DEFAULT section of the undercloud.conf file. 

    custom_env_files = /home/stack/undercloud_custom_env.yaml
    Copy to Clipboard Toggle word wrap

  4. Perform the undercloud installation: 

    $ openstack undercloud install
    Copy to Clipboard Toggle word wrap
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat