Chapter 16. Final review before upgrade
Chapter 16. Final review before upgrade Complete a final check of all preparation steps before you begin the upgrade. 16.1. Custom files to include in your deployment If any overcloud nodes in your deployment are dedicated Object Storage (swift) nodes, you must copy the default roles_data.yaml file and edit ObjectStorage to remove deprecated_server_resource_name: 'SwiftStorage' . Then use the --roles-file option to pass the file to the openstack overcloud upgrade prepare or the openstack overcloud upgrade converge command. 16.2. New environment files to include with your deployment In addition to your regular overcloud environment files, you must include new environment files to facilitate the upgrade to Red Hat OpenStack Platform (RHOSP) 16.2. File Notes /home/stack/templates/upgrades-environment.yaml This file contains the parameters specific to the upgrade. This file is necessary only for the duration of the upgrade. Discard this file after you run openstack overcloud upgrade converge . /home/stack/templates/rhsm.yaml This file contains registration and subscription information for the overcloud. This file registers your systems either to the Red Hat Customer Portal or Red Hat Satellite Server. /home/stack/containers-prepare-parameter.yaml The file that contains the source and preparation steps. This is the same file that you use with the undercloud upgrade. /usr/share/openstack-tripleo-heat-templates/environments/services/neutron-ovs.yaml OpenStack Platform 16.2 uses Open Virtual Network (OVN) as the default networking backend. However, OpenStack Platform 13 used Open vSwitch (OVS). Include this file to retain OVS compatibility during the upgrade. The OpenStack Platform 16.2 documentation includes instructions on migrating from OVS to OVN after the upgrade. Add these files to the end of your environment file listing when you run the following commands: openstack overcloud upgrade prepare openstack overcloud upgrade converge openstack overcloud deploy 16.3. Environment files to remove from your deployment Remove any environment files specific to your OpenStack Platform Red Hat OpenStack Platform 13: Red Hat OpenStack Platform 13 container image list Red Hat OpenStack Platform 13 Customer Portal or Satellite rhel-registration scripts Remove these files from the list of environment files you include when you run the following commands: openstack overcloud upgrade prepare openstack overcloud upgrade converge openstack overcloud deploy 16.4. Upgrade checklist Use the following checklist to determine your readiness to upgrade the overcloud: Item Complete Validated a working overcloud. Y / N Performed a Relax-and-Recover (ReaR) backup of the overcloud control plane. For more information, see Red Hat OpenStack Platform 13 Undercloud and Control Plane Back Up and Restore . Y / N Created a backup of the database that runs on the undercloud node. For more information, see Creating a database backup of the undercloud node in the Red Hat OpenStack Platform 16.2 Backing up and restoring the undercloud and control plane nodes guide. Y / N Implemented all preparation for Leapp, including: Leapp environment file All overcloud nodes are now using predictable NIC names. Y / N Updated your registration details to Red Hat OpenStack Platform 16.2 repositories and converted your environment file to use the Ansible-based method. Y / N Updated your network configuration templates. Y / N Updated your environment file list with new environment files for Red Hat OpenStack Platform 16.2. Y / N Optional: If your deployment includes dedicated Object Storage (swift) nodes: Copied the roles_data.yaml file, removed deprecated_server_resource_name: 'SwiftStorage' , and passed the file to the openstack overcloud upgrade prepare or the openstack overcloud upgrade converge command. Y / N Removed old environment files only relevant to Red Hat OpenStack Platform 13, such as old Red Hat registration and container image location files. Y / N