Chapter 6. Deploying the overcloud

Prerequisites

Important

Do not enable Instance HA when deploying a RHOSP HCI environment. Contact your Red Hat representative if you want to use Instance HA with hyperconverged RHOSP deployments with Ceph.

Procedure

Run the following command to deploy your HCI overcloud:

$ openstack overcloud deploy --templates \
  -p /usr/share/openstack-tripleo-heat-templates/plan-samples/plan-environment-derived-params.yaml \
  -r /home/stack/templates/roles_data.yaml \
  -e /home/stack/templates/ports.yaml \
  -e /home/stack/templates/environment-rhel-registration.yaml \
  -e /usr/share/openstack-tripleo-heat-templates/environments/ceph-ansible/ceph-ansible.yaml \
  -e /home/stack/templates/storage-config.yaml \
  -e /home/stack/templates/storage-container-config.yaml \
  -e /home/stack/templates/network.yaml \
  [-e /home/stack/templates/ceph-backfill-recovery.yaml \ ]
  [-e /usr/share/openstack-tripleo-heat-templates/environments/services/neutron-sriov.yaml \]
  [-e /home/stack/templates/network-environment.yaml \ ]
  [-e <additional environment files for your planned overcloud deployment> \ ]
  --ntp-server pool.ntp.org

Where:

ArgumentDescription

--templates

Creates the overcloud from the default heat template collection: /usr/share/openstack-tripleo-heat-templates/).

-p /usr/share/openstack-tripleo-heat-templates/plan-samples/plan-environment-derived-params.yaml

Specifies that the derived parameters workflow should be run during the deployment to calculate how much memory and CPU should be reserved for a hyperconverged deployment.

-r /home/stack/templates/roles_data.yaml

Specifies the customized roles definition file created in the Preparing the overcloud role for hyperconverged nodes procedure, which includes the ComputeHCI role.

-e /home/stack/templates/ports.yaml

Adds the environment file created in the Preparing the overcloud role for hyperconverged nodes procedure, which configures the ports for the ComputeHCI role.

-e /home/stack/templates/environment-rhel-registration.yaml

Adds an environment file that registers overcloud nodes, as described in Registering the overcloud with the rhsm composable service in the Advanced Overcloud Customization guide.

-e /usr/share/openstack-tripleo-heat-templates/environments/ceph-ansible/ceph-ansible.yaml

Adds the base environment file that deploys a containerized Red Hat Ceph cluster, with all default settings. For more information, see the Deploying an Overcloud with Containerized Red Hat Ceph guide.

-e /home/stack/templates/storage-config.yaml

Adds a custom environment file that defines all other Ceph settings. For a detailed example of this, see Sample Environment File: Creating a Ceph Cluster in the Deploying an Overcloud with Containerized Red Hat Ceph guide. This sample environment file also specifies the flavors to use, and how many nodes to assign per role. For more information on this, see Assigning Nodes and Flavors to Roles in the Deploying an Overcloud with Containerized Red Hat Ceph guide.

-e /home/stack/templates/storage-container-config.yaml

Reserves CPU and memory for each Ceph OSD storage container, as described in Reserving CPU and memory resources for Ceph.

-e /home/stack/templates/network.yaml

Adds the environment file created in the Mapping storage management network ports to NICs procedure.

-e /home/stack/templates/ceph-backfill-recovery.yaml

(Optional) Adds the environment file from Reduce Ceph Backfill and Recovery Operations.

-e /usr/share/openstack-tripleo-heat-templates/environments/services/neutron-sriov.yaml

(Optional) Adds the environment file for Single-Root Input/Output Virtualization (SR-IOV).

-e /home/stack/templates/network-environment.yaml

(Optional) Adds the environment file that applies your SR-IOV network preferences.

-e <environment file>

(Optional) Adds any additional environment files for your planned overcloud deployment.

--ntp-server pool.ntp.org

Sets our NTP server.

Note

Currently, SR-IOV is the only Network Function Virtualization (NFV) implementation supported with HCI.

For a full list of deployment options, run the following command:

$ openstack help overcloud deploy

For more details on deployment options, see Creating the Overcloud with the CLI Tools in the Director Installation and Usage guide.

Tip

You can also use an answers file to specify which environment files to include in your deployment. For more information, see Including Environment Files in Overcloud Creation in the Director Installation and Usage guide.