What is the correct syntax for OpenShift inventory file variables openshift_release, openshift_pkg_version, and openshift_image_tag?

Environment

• Red Hat OpenShift Container Platform (OCP) 3.x

Issue

We are trying to install or upgrade OpenShift but are confused by the differences in the correct syntaxes for the following inventory variables:

openshift_release=
openshift_pkg_version=
openshift_image_tag=

Resolution

The correct syntax for these variables is as follows:

openshift_release=v3.11
openshift_pkg_version=-3.11.188
openshift_image_tag=v3.11.188

Note: This example shows the variables set up for a 3.11.188 install or upgrade. Please use the version numbers appropriate for your environment.

Diagnostic Steps

• While installing or modifying a cluster using the ansible inventory file, the following error is shown when using a wrong openshift_pkg_version format:

Message:  last_checked_host: master1.example.com, last_checked_var: openshift_pkg_version;openshift_pkg_version must be in the format
   -[optional.release]. Examples: -3.6.0, -3.7.0-0.126.0.git.0.9351aae.el7 -3.11*
   You specified openshift_pkg_version=v3.11.188

• While installing or modifying a cluster using the ansible inventory file, the following error is shown while using openshift_release without the correspondent openshift_pkg_version:

Details:  check "package_version":
   Some required package(s) are available at a version that is higher than requested
      atomic-openshift-node-3.11.188
      atomic-openshift-3.11.188

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.