5.6. Updating the undercloud.conf file
You can continue using the original undercloud.conf file from your Red Hat OpenStack Platform 16.2 environment, but you must modify the file to retain compatibility with Red Hat OpenStack Platform 17.1. For more information about parameters for configuring the undercloud.conf file, see Undercloud configuration parameters in Installing and managing Red Hat OpenStack Platform with director.
If your original undercloud.conf file includes the CertmongerKerberosRealm parameter in the /home/stack/custom-kerberos-params.yaml file, you must replace the CertmongerKerberosRealm parameter with the HAProxyCertificatePrincipal parameter. The CertmongerKerberosRealm parameter causes the undercloud upgrade to fail.
Procedure
-
Log in to your undercloud host as the
stackuser. Create a file called
skip_rhel_release.yamland set theSkipRhelEnforcementparameter totrue:parameter_defaults: SkipRhelEnforcement: trueOpen the
undercloud.conffile, and add thecontainer_images_fileparameter to theDEFAULTsection in the file:container_images_file = /home/stack/containers-prepare-parameter.yaml-
The
container_images_fileparameter defines the location of thecontainers-prepare-parameter.yamlenvironment file so that director pulls container images for the undercloud from the correct location.
-
The
Add the
custom_env_filesparameter to theDEFAULTsection in theundercloud.conffile. Thecustom_env_filesparameter defines the location of theskip_rhel_release.yamlfile that is required for the upgrade:custom_env_files = /home/stack/skip_rhel_release.yamlAdd any additional custom environment files to the
custom_env_filesparameter, separated by a comma. Ensure that any existing files in the parameter are included in the list. For example:custom_env_files = /home/stack/custom-undercloud-params.yaml,/home/stack/skip_rhel_release.yaml
- Check all other parameters in the file for any changes.
- Save the file.