Chapter 1. Preparing Infrastructure for Upgrading

You can upgrade RHMAP by either

  • Installing Ansible version 2.4 and running the installer scripts.
  • Running a docker container, which has ansible installed, and running the installer scripts in that container.

To prepare for the upgrade:

  1. Ensure that RHMAP is deployed to a compatible OpenShift installation.
  2. Install Ansible version 2.4 as described in Ansible Installation Guide. After installing Ansible, configure Ansible for installing RHMAP components.
  3. Install the RHMAP OpenShift Templates.
  4. Set up an inventory file.
Note

Before proceeding with the automated upgrade, Red Hat recommends you use the RHMAP Ansible scripts to download the new images onto each of the target nodes. For instructions, see Seeding the Nodes with the RHMAP Images.

This step improves the robustness of the upgrade process, especially on low speed networks.

1.1. Using Docker to Upgrade RHMAP (Optional)

An alternative method for upgrading is to use the RHMAP installer docker image, which includes Ansible and the templates, so you do not need to install Ansible.

Enter the following command to download the docker image:

docker pull rhmap47/installer

The procedures in this guide provide example commands for using this container.