Chapter 3. Upgrading with external Ceph deployments

Procedure

1. Log in to the undercloud host as the stack user.

2. Source the stackrc undercloud credentials file:

   $ source ~/stackrc

3. If you included the environments/ceph-ansible/ceph-ansible-external.yaml file in the following commands, you must replace the file with the environments/external-ceph.yaml file.

   • openstack overcloud upgrade prepare

   • openstack overcloud deploy

     For example, replace

     $ openstack overcloud deploy
     ...
     -e environments/ceph-ansible/ceph-ansible-external.yaml
     ...

     with

     $ openstack overcloud deploy
     ...
     -e environments/external-ceph.yaml
     ...

4. Create a file called ceph_params.yaml and include the following content:

   parameter_defaults:
     CephClusterFSID: <fsid>
     CephClientKey: <key>
     CephExternalMonHost: <mon ip addresses>
     CephSpecFqdn: <true/false>
     CephConfigPath: "/etc/ceph"
     DeployedCeph: false
     GrafanaPlugins: []

   • Replace <fsid> with the UUID of your Red Hat Ceph Storage cluster.
   • Replace <key> with your Ceph client key.
   • Replace <mon ip addresses> with a list of your Ceph Mon Host IPs.

   • Replace <true/false> with the value that applies to your environment.

     Note

     If your Red Hat Ceph Storage deployment includes short names, you must set the CephSpecFqdn parameter to false. If set to true, the inventory generates with both the short names and domain names, causing the Red Hat Ceph Storage upgrade to fail.

5. Include the ceph_params.yaml file in the overcloud deployment command:

   $ openstack overcloud deploy \
   ...
   -e ~/environments/ceph_params.yaml \

   Important

   Do not remove the ceph_params.yaml file after the RHOSP upgrade is complete. This file must be present in external Red Hat Ceph Storage environments. Additionally, any time you run openstack overcloud deploy, you must include the ceph_params.yaml file, for example, -e ceph_params.yaml.