Chapter 13. Preparing for upgrading with external Ceph deployments
If you are upgrading with external Ceph deployments, you must complete the procedures included in this section.
If your deployment does not use an external Ceph Storage cluster, you must skip the procedures included in this section and continue to the next section.
13.1. Installing ceph-ansible
If you are upgrading with external Ceph deployments, you must complete this procedure.
The ceph-ansible
package is required when you use Ceph Storage with Red Hat OpenStack Platform.
Procedure
Enable the Ceph Tools repository:
[stack@director ~]$ sudo subscription-manager repos --enable=rhceph-4-tools-for-rhel-8-x86_64-rpms
Install the
ceph-ansible
package:[stack@director ~]$ sudo dnf install -y ceph-ansible
13.2. Setting the ceph-ansible repository
The Red Hat OpenStack Platform 16.2 validation framework tests that ceph-ansible
is installed correctly before director upgrades the overcloud to Red Hat Ceph Storage 4. The framework uses the CephAnsibleRepo
parameter to check that you installed ceph-ansible
from the correct repository. Director disables the test after you run the openstack overcloud upgrade prepare
command and this test remains disabled through the duration of the Red Hat OpenStack Platform 16.2 overcloud upgrade. Director re-enables this test after running the openstack overcloud upgrade converge
command. However, to prepare for this validation, you must set the CephAnsibleRepo
parameter to the Red Hat Ceph Storage Tools 4 for RHEL 8 repository.
Procedure
-
Log in to the undercloud as the
stack
user. Edit the environment file that contains your overcloud Ceph Storage configuration. This file is usually named
ceph-config.yaml
and you can find it in yourtemplates
directory:$ vi /home/stack/templates/ceph-config.yaml
Add the
CephAnsibleRepo
parameter to theparameter_defaults
section:parameter_defaults: ... CephAnsibleRepo: rhceph-4-tools-for-rhel-8-x86_64-rpms ...
CephAnsibleRepo
sets the repository that includesceph-ansible
. The validation framework uses this parameter to check that you have installedceph-ansible
on the undercloud.-
Save the
ceph-config.yaml
file.