Red Hat Customer Portal

Skip to main content

Main Navigation

  • Products & Services
    • Back
    • View All Products
    • Infrastructure and Management
      • Back
      • Red Hat Enterprise Linux
      • Red Hat Virtualization
      • Red Hat Identity Management
      • Red Hat Directory Server
      • Red Hat Certificate System
      • Red Hat Satellite
      • Red Hat Subscription Management
      • Red Hat Update Infrastructure
      • Red Hat Insights
      • Red Hat Ansible Automation Platform
    • Cloud Computing
      • Back
      • Red Hat CloudForms
      • Red Hat OpenStack Platform
      • Red Hat OpenShift Container Platform
      • Red Hat OpenShift Online
      • Red Hat OpenShift Dedicated
      • Red Hat Advanced Cluster Management for Kubernetes
      • Red Hat Quay
      • Red Hat CodeReady Workspaces
    • Storage
      • Back
      • Red Hat Gluster Storage
      • Red Hat Hyperconverged Infrastructure
      • Red Hat Ceph Storage
      • Red Hat Openshift Container Storage
    • Runtimes
      • Back
      • Red Hat Runtimes
      • Red Hat JBoss Enterprise Application Platform
      • Red Hat Data Grid
      • Red Hat JBoss Web Server
      • Red Hat Single Sign On
      • Red Hat support for Spring Boot
      • Red Hat build of Node.js
      • Red Hat build of Thorntail
      • Red Hat build of Eclipse Vert.x
      • Red Hat build of OpenJDK
      • Red Hat build of Quarkus
      • Red Hat CodeReady Studio
    • Integration and Automation
      • Back
      • Red Hat Integration
      • Red Hat Fuse
      • Red Hat AMQ
      • Red Hat 3scale API Management
      • Red Hat JBoss Data Virtualization
      • Red Hat Process Automation
      • Red Hat Process Automation Manager
      • Red Hat Decision Manager
    • Support
    • Production Support
    • Development Support
    • Product Life Cycles
    • Documentation
    • Red Hat Enterprise Linux
    • Red Hat JBoss Enterprise Application Platform
    • Red Hat OpenStack Platform
    • Red Hat OpenShift Container Platform
    • Services
    • Consulting
    • Technical Account Management
    • Training & Certifications
    • Ecosystem Catalog
    • Partner Resources
    • Red Hat in the Public Cloud
  • Tools
    • Back
    • Red Hat Insights
    • Tools
    • Solution Engine
    • Packages
    • Errata
    • Customer Portal Labs
    • Explore Labs
    • Configuration
    • Deployment
    • Security
    • Troubleshooting
  • Security
    • Back
    • Product Security Center
    • Security Updates
    • Security Advisories
    • Red Hat CVE Database
    • Security Labs
    • Resources
    • Overview
    • Security Blog
    • Security Measurement
    • Severity Ratings
    • Backporting Policies
    • Product Signing (GPG) Keys
  • Community
    • Back
    • Customer Portal Community
    • Discussions
    • Blogs
    • Private Groups
    • Community Activity
    • Customer Events
    • Red Hat Convergence
    • Red Hat Summit
    • Stories
    • Red Hat Subscription Value
    • You Asked. We Acted.
    • Open Source Communities
  • Subscriptions
  • Downloads
  • Containers
  • Support Cases
  • Account
    • Back
    • Log In
    • Register
    • Red Hat Account Number:
    • Account Details
    • User Management
    • Account Maintenance
    • My Profile
    • Notifications
    • Help
    • Log Out
  • Language
    • Back
    • English
    • 한국어
    • 日本語
    • 中文 (中国)
Red Hat Customer Portal
  • Products & Services
    • Back
    • View All Products
    • Infrastructure and Management
      • Back
      • Red Hat Enterprise Linux
      • Red Hat Virtualization
      • Red Hat Identity Management
      • Red Hat Directory Server
      • Red Hat Certificate System
      • Red Hat Satellite
      • Red Hat Subscription Management
      • Red Hat Update Infrastructure
      • Red Hat Insights
      • Red Hat Ansible Automation Platform
    • Cloud Computing
      • Back
      • Red Hat CloudForms
      • Red Hat OpenStack Platform
      • Red Hat OpenShift Container Platform
      • Red Hat OpenShift Online
      • Red Hat OpenShift Dedicated
      • Red Hat Advanced Cluster Management for Kubernetes
      • Red Hat Quay
      • Red Hat CodeReady Workspaces
    • Storage
      • Back
      • Red Hat Gluster Storage
      • Red Hat Hyperconverged Infrastructure
      • Red Hat Ceph Storage
      • Red Hat Openshift Container Storage
    • Runtimes
      • Back
      • Red Hat Runtimes
      • Red Hat JBoss Enterprise Application Platform
      • Red Hat Data Grid
      • Red Hat JBoss Web Server
      • Red Hat Single Sign On
      • Red Hat support for Spring Boot
      • Red Hat build of Node.js
      • Red Hat build of Thorntail
      • Red Hat build of Eclipse Vert.x
      • Red Hat build of OpenJDK
      • Red Hat build of Quarkus
      • Red Hat CodeReady Studio
    • Integration and Automation
      • Back
      • Red Hat Integration
      • Red Hat Fuse
      • Red Hat AMQ
      • Red Hat 3scale API Management
      • Red Hat JBoss Data Virtualization
      • Red Hat Process Automation
      • Red Hat Process Automation Manager
      • Red Hat Decision Manager
    • Support
    • Production Support
    • Development Support
    • Product Life Cycles
    • Documentation
    • Red Hat Enterprise Linux
    • Red Hat JBoss Enterprise Application Platform
    • Red Hat OpenStack Platform
    • Red Hat OpenShift Container Platform
    • Services
    • Consulting
    • Technical Account Management
    • Training & Certifications
    • Ecosystem Catalog
    • Partner Resources
    • Red Hat in the Public Cloud
  • Tools
    • Back
    • Red Hat Insights
    • Tools
    • Solution Engine
    • Packages
    • Errata
    • Customer Portal Labs
    • Explore Labs
    • Configuration
    • Deployment
    • Security
    • Troubleshooting
  • Security
    • Back
    • Product Security Center
    • Security Updates
    • Security Advisories
    • Red Hat CVE Database
    • Security Labs
    • Resources
    • Overview
    • Security Blog
    • Security Measurement
    • Severity Ratings
    • Backporting Policies
    • Product Signing (GPG) Keys
  • Community
    • Back
    • Customer Portal Community
    • Discussions
    • Blogs
    • Private Groups
    • Community Activity
    • Customer Events
    • Red Hat Convergence
    • Red Hat Summit
    • Stories
    • Red Hat Subscription Value
    • You Asked. We Acted.
    • Open Source Communities
  • Subscriptions
  • Downloads
  • Containers
  • Support Cases
  • Account
    • Back
    • Log In
    • Register
    • Red Hat Account Number:
    • Account Details
    • User Management
    • Account Maintenance
    • My Profile
    • Notifications
    • Help
    • Log Out
  • Language
    • Back
    • English
    • 한국어
    • 日本語
    • 中文 (中国)
  • Subscriptions
  • Downloads
  • Containers
  • Support Cases
  • Search
  • Log In
  • Language
Or troubleshoot an issue.

Log in to Your Red Hat Account

Log In

Your Red Hat account gives you access to your profile, preferences, and services, depending on your status.

Register

If you are a new customer, register now for access to product evaluations and purchasing capabilities.

Need access to an account?

If your company has an existing Red Hat account, your organization administrator can grant you access.

If you have any questions, please contact customer service.

Red Hat Account Number:

Red Hat Account

  • Account Details
  • User Management
  • Account Maintenance
  • Account Team

Customer Portal

  • My Profile
  • Notifications
  • Help

For your security, if you’re on a public computer and have finished using your Red Hat services, please be sure to log out.

Log Out

Select Your Language

  • English
  • 한국어
  • 日本語
  • 中文 (中国)
Red Hat Customer Portal Red Hat Customer Portal
  • Products & Services
  • Tools
  • Security
  • Community
  • Infrastructure and Management

  • Cloud Computing

  • Storage

  • Runtimes

  • Integration and Automation

  • Red Hat Enterprise Linux
  • Red Hat Virtualization
  • Red Hat Identity Management
  • Red Hat Directory Server
  • Red Hat Certificate System
  • Red Hat Satellite
  • Red Hat Subscription Management
  • Red Hat Update Infrastructure
  • Red Hat Insights
  • Red Hat Ansible Automation Platform
  • Red Hat CloudForms
  • Red Hat OpenStack Platform
  • Red Hat OpenShift Container Platform
  • Red Hat OpenShift Online
  • Red Hat OpenShift Dedicated
  • Red Hat Advanced Cluster Management for Kubernetes
  • Red Hat Quay
  • Red Hat CodeReady Workspaces
  • Red Hat OpenShift Service on AWS
  • Red Hat Gluster Storage
  • Red Hat Hyperconverged Infrastructure
  • Red Hat Ceph Storage
  • Red Hat Openshift Container Storage
  • Red Hat Runtimes
  • Red Hat JBoss Enterprise Application Platform
  • Red Hat Data Grid
  • Red Hat JBoss Web Server
  • Red Hat Single Sign On
  • Red Hat support for Spring Boot
  • Red Hat build of Node.js
  • Red Hat build of Thorntail
  • Red Hat build of Eclipse Vert.x
  • Red Hat build of OpenJDK
  • Red Hat build of Quarkus
  • Red Hat CodeReady Studio
  • Red Hat Integration
  • Red Hat Fuse
  • Red Hat AMQ
  • Red Hat 3scale API Management
  • Red Hat JBoss Data Virtualization
  • Red Hat Process Automation
  • Red Hat Process Automation Manager
  • Red Hat Decision Manager
View All Products
  • Support
  • Production Support
  • Development Support
  • Product Life Cycles

Services

  • Consulting
  • Technical Account Management
  • Training & Certifications
  • Documentation
  • Red Hat Enterprise Linux
  • Red Hat JBoss Enterprise Application Platform
  • Red Hat OpenStack Platform
  • Red Hat OpenShift Container Platform
  • Ecosystem Catalog
  • Red Hat in the Public Cloud
  • Partner Resources

Tools

  • Solution Engine
  • Packages
  • Errata
  • Customer Portal Labs
  • Configuration
  • Deployment
  • Security
  • Troubleshooting

Red Hat Insights

Increase visibility into IT operations to detect and resolve technical issues before they impact your business.

  • Learn more
  • Go to Insights

Red Hat Product Security Center

Engage with our Red Hat Product Security team, access security updates, and ensure your environments are not exposed to any known security vulnerabilities.

Product Security Center

Security Updates

  • Security Advisories
  • Red Hat CVE Database
  • Security Labs

Keep your systems secure with Red Hat's specialized responses to security vulnerabilities.

  • View Responses

Resources

  • Overview
  • Security Blog
  • Security Measurement
  • Severity Ratings
  • Backporting Policies
  • Product Signing (GPG) Keys

Customer Portal Community

  • Discussions
  • Blogs
  • Private Groups
  • Community Activity

Customer Events

  • Red Hat Convergence
  • Red Hat Summit

Stories

  • Red Hat Subscription Value
  • You Asked. We Acted.
  • Open Source Communities
Show Table of Contents
Hide Table of Contents
  • English
  • 日本語
  • 한국어
  • 简体中文
  • Single-page HTML
  • PDF
  • ePub
  1. Director Installation and Usage
  2. 1. Introduction to director
    1. 1.1. Undercloud
    2. 1.2. Understanding the overcloud
    3. 1.3. Understanding high availability in Red Hat OpenStack Platform
    4. 1.4. Understanding containerization in Red Hat OpenStack Platform
    5. 1.5. Working with Ceph Storage in Red Hat OpenStack Platform
  3. I. Director installation and configuration
    1. 2. Planning your undercloud
      1. 2.1. Containerized undercloud
      2. 2.2. Preparing your undercloud networking
      3. 2.3. Determining environment scale
      4. 2.4. Undercloud disk sizing
      5. 2.5. Virtualization support
      6. 2.6. Character encoding configuration
      7. 2.7. Considerations when running the undercloud with a proxy
      8. 2.8. Undercloud repositories
    2. 3. Preparing for director installation
      1. 3.1. Preparing the undercloud
      2. 3.2. Installing ceph-ansible
      3. 3.3. Preparing container images
      4. 3.4. Container image preparation parameters
      5. 3.5. Layering image preparation entries
      6. 3.6. Excluding Ceph Storage container images
      7. 3.7. Obtaining container images from private registries
      8. 3.8. Modifying images during preparation
      9. 3.9. Updating existing packages on container images
      10. 3.10. Installing additional RPM files to container images
      11. 3.11. Modifying container images with a custom Dockerfile
      12. 3.12. Preparing a Satellite server for container images
    3. 4. Installing director
      1. 4.1. Configuring director
      2. 4.2. Director configuration parameters
      3. 4.3. Configuring the undercloud with environment files
      4. 4.4. Common heat parameters for undercloud configuration
      5. 4.5. Configuring hieradata on the undercloud
      6. 4.6. Configuring the undercloud for bare metal provisioning over IPv6
      7. 4.7. Installing director
      8. 4.8. Obtaining images for overcloud nodes
        1. 4.8.1. Single CPU architecture overclouds
        2. 4.8.2. Multiple CPU architecture overclouds
        3. 4.8.3. Minimal overcloud image
      9. 4.9. Setting a nameserver for the control plane
      10. 4.10. Updating the undercloud configuration
      11. 4.11. Undercloud container registry
      12. 4.12. Next steps
    4. 5. Installing undercloud minions
      1. 5.1. Undercloud minion
      2. 5.2. Undercloud minion requirements
      3. 5.3. Preparing a minion
      4. 5.4. Copying the undercloud configuration files to the minion
      5. 5.5. Copying the undercloud certificate authority
      6. 5.6. Configuring the minion
      7. 5.7. Minion configuration parameters
      8. 5.8. Installing the minion
      9. 5.9. Verifying the minion installation
      10. 5.10. Next Steps
  4. II. Basic overcloud deployment
    1. 6. Planning your overcloud
      1. 6.1. Node roles
      2. 6.2. Overcloud networks
      3. 6.3. Overcloud storage
      4. 6.4. Overcloud security
      5. 6.5. Overcloud high availability
      6. 6.6. Controller node requirements
      7. 6.7. Compute node requirements
      8. 6.8. Ceph Storage node requirements
      9. 6.9. Object Storage node requirements
      10. 6.10. Overcloud repositories
      11. 6.11. Provisioning methods
    2. 7. Configuring a basic overcloud with CLI tools
      1. 7.1. Registering nodes for the overcloud
      2. 7.2. Validating the introspection requirements
      3. 7.3. Inspecting the hardware of nodes
      4. 7.4. Tagging nodes into profiles
      5. 7.5. Setting UEFI boot mode
      6. 7.6. Enabling virtual media boot
      7. 7.7. Defining the root disk for multi-disk clusters
      8. 7.8. Using the overcloud-minimal image to avoid using a Red Hat subscription entitlement
      9. 7.9. Creating architecture specific roles
      10. 7.10. Environment files
      11. 7.11. Creating an environment file that defines node counts and flavors
      12. 7.12. Creating an environment file for undercloud CA trust
      13. 7.13. Deployment command
      14. 7.14. Deployment command options
      15. 7.15. Including environment files in an overcloud deployment
      16. 7.16. Validating the deployment requirements
      17. 7.17. Overcloud deployment output
      18. 7.18. Accessing the overcloud
      19. 7.19. Validating the post-deployment state
      20. 7.20. Next steps
    3. 8. Provisioning bare metal nodes before deploying the overcloud
      1. 8.1. Registering nodes for the overcloud
      2. 8.2. Inspecting the hardware of nodes
      3. 8.3. Provisioning bare metal nodes
      4. 8.4. Scaling up bare metal nodes
      5. 8.5. Scaling down bare metal nodes
      6. 8.6. Bare metal node provisioning attributes
    4. 9. Configuring a basic overcloud with pre-provisioned nodes
      1. 9.1. Pre-provisioned node requirements
      2. 9.2. Creating a user on pre-provisioned nodes
      3. 9.3. Registering the operating system for pre-provisioned nodes
      4. 9.4. Configuring SSL/TLS access to director
      5. 9.5. Configuring networking for the control plane
      6. 9.6. Using a separate network for pre-provisioned nodes
      7. 9.7. Mapping pre-provisioned node hostnames
      8. 9.8. Configuring Ceph Storage for pre-provisioned nodes
      9. 9.9. Creating the overcloud with pre-provisioned nodes
      10. 9.10. Overcloud deployment output
      11. 9.11. Accessing the overcloud
      12. 9.12. Scaling pre-provisioned nodes
      13. 9.13. Removing a pre-provisioned overcloud
      14. 9.14. Next steps
    5. 10. Deploying multiple overclouds
      1. 10.1. Deploying additional overclouds
      2. 10.2. Managing multiple overclouds
  5. III. Post deployment operations
    1. 11. Performing overcloud post-installation tasks
      1. 11.1. Checking overcloud deployment status
      2. 11.2. Creating basic overcloud flavors
      3. 11.3. Creating a default tenant network
      4. 11.4. Creating a default floating IP network
      5. 11.5. Creating a default provider network
      6. 11.6. Creating additional bridge mappings
      7. 11.7. Validating the overcloud
      8. 11.8. Protecting the overcloud from removal
    2. 12. Performing basic overcloud administration tasks
      1. 12.1. Managing containerized services
      2. 12.2. Modifying the overcloud environment
      3. 12.3. Importing virtual machines into the overcloud
      4. 12.4. Running the dynamic inventory script
      5. 12.5. Removing the overcloud
    3. 13. Configuring the overcloud with Ansible
      1. 13.1. Ansible-based overcloud configuration (config-download)
      2. 13.2. config-download working directory
      3. 13.3. Enabling access to config-download working directories
      4. 13.4. Checking config-download log
      5. 13.5. Separating the provisioning and configuration processes
      6. 13.6. Running config-download manually
      7. 13.7. Performing Git operations on the working directory
      8. 13.8. Creating config-download files manually
      9. 13.9. config-download top level files
      10. 13.10. config-download tags
      11. 13.11. config-download deployment steps
      12. 13.12. Next Steps
    4. 14. Using the validation framework
      1. 14.1. Ansible-based validations
      2. 14.2. Listing validations
      3. 14.3. Running validations
      4. 14.4. In-flight validations
    5. 15. Scaling overcloud nodes
      1. 15.1. Adding nodes to the overcloud
      2. 15.2. Increasing node counts for roles
      3. 15.3. Removing Compute nodes
      4. 15.4. Replacing Ceph Storage nodes
      5. 15.5. Replacing Object Storage nodes
      6. 15.6. Blacklisting nodes
    6. 16. Replacing Controller nodes
      1. 16.1. Preparing for Controller replacement
      2. 16.2. Removing a Ceph Monitor daemon
      3. 16.3. Preparing the cluster for Controller node replacement
      4. 16.4. Replacing a Controller node
      5. 16.5. Triggering the Controller node replacement
      6. 16.6. Cleaning up after Controller node replacement
    7. 17. Rebooting nodes
      1. 17.1. Rebooting the undercloud node
      2. 17.2. Rebooting Controller and composable nodes
      3. 17.3. Rebooting standalone Ceph MON nodes
      4. 17.4. Rebooting a Ceph Storage (OSD) cluster
      5. 17.5. Rebooting Compute nodes
  6. IV. Additional director operations and configuration
    1. 18. Configuring custom SSL/TLS certificates
      1. 18.1. Initializing the signing host
      2. 18.2. Creating a certificate authority
      3. 18.3. Adding the certificate authority to clients
      4. 18.4. Creating an SSL/TLS key
      5. 18.5. Creating an SSL/TLS certificate signing request
      6. 18.6. Creating the SSL/TLS certificate
      7. 18.7. Adding the certificate to the undercloud
    2. 19. Additional introspection operations
      1. 19.1. Performing individual node introspection
      2. 19.2. Performing node introspection after initial introspection
      3. 19.3. Performing network introspection for interface information
    3. 20. Automatically discovering bare metal nodes
      1. 20.1. Prerequisites
      2. 20.2. Enabling auto-discovery
      3. 20.3. Testing auto-discovery
      4. 20.4. Using rules to discover different vendor hardware
    4. 21. Configuring automatic profile tagging
      1. 21.1. Policy file syntax
      2. 21.2. Policy file example
      3. 21.3. Importing policy files
    5. 22. Creating whole disk images
      1. 22.1. Security hardening measures
      2. 22.2. Whole disk image workflow
      3. 22.3. Downloading the base cloud image
      4. 22.4. Disk image environment variables
      5. 22.5. Customizing the disk layout
      6. 22.6. Modifying the partitioning schema
      7. 22.7. Modifying the image size
      8. 22.8. Building the whole disk image
      9. 22.9. Uploading the whole disk image
    6. 23. Configuring Direct Deploy
      1. 23.1. Configuring the direct deploy interface on the undercloud
    7. 24. Creating virtualized control planes
      1. 24.1. Virtualized control plane architecture
      2. 24.2. Benefits and limitations of virtualizing your RHOSP overcloud control plane
      3. 24.3. Provisioning virtualized controllers using the Red Hat Virtualization driver
  7. V. Troubleshooting and tips
    1. 25. Troubleshooting director errors
      1. 25.1. Troubleshooting node registration
      2. 25.2. Troubleshooting hardware introspection
      3. 25.3. Troubleshooting workflows and executions
      4. 25.4. Troubleshooting overcloud creation and deployment
      5. 25.5. Troubleshooting node provisioning
      6. 25.6. Troubleshooting IP address conflicts during provisioning
      7. 25.7. Troubleshooting "No Valid Host Found" errors
      8. 25.8. Troubleshooting overcloud configuration
      9. 25.9. Troubleshooting container configuration
      10. 25.10. Troubleshooting Compute node failures
      11. 25.11. Creating an sosreport
      12. 25.12. Log locations
    2. 26. Tips for undercloud and overcloud services
      1. 26.1. Review the database flush intervals
      2. 26.2. Tuning deployment performance
      3. 26.3. Running swift-ring-builder in a container
      4. 26.4. Changing the SSL/TLS cipher rules for HAProxy
  8. VI. Appendices
    1. A. Power management drivers
      1. A.1. Intelligent Platform Management Interface (IPMI)
      2. A.2. Redfish
      3. A.3. Dell Remote Access Controller (DRAC)
      4. A.4. Integrated Lights-Out (iLO)
      5. A.5. Fujitsu Integrated Remote Management Controller (iRMC)
      6. A.6. Red Hat Virtualization
      7. A.7. manual-management Driver
    2. B. Red Hat OpenStack Platform for POWER
      1. B.1. Ceph Storage
      2. B.2. Composable services
  9. Legal Notice

Part V. Troubleshooting and tips

  • 24.3. Provisioning virtualized controllers using the Red Hat Virtualization driver
  • 25. Troubleshooting director errors
Red Hat

Quick Links

  • Downloads
  • Subscriptions
  • Support Cases
  • Customer Service
  • Product Documentation

Help

  • Contact Us
  • Customer Portal FAQ
  • Log-in Assistance

Site Info

  • Trust Red Hat
  • Browser Support Policy
  • Accessibility
  • Awards and Recognition
  • Colophon

Related Sites

  • redhat.com
  • openshift.com
  • developers.redhat.com
  • connect.redhat.com

About

  • Red Hat Subscription Value
  • About Red Hat
  • Red Hat Jobs
Copyright © 2021 Red Hat, Inc.
  • Privacy Statement
  • Customer Portal Terms of Use
  • All Policies and Guidelines
Red Hat Summit
Twitter Facebook

Formatting Tips

Here are the common uses of Markdown.

Code blocks
~~~
Code surrounded in tildes is easier to read
~~~
Links/URLs
[Red Hat Customer Portal](https://access.redhat.com)
Learn more