Prerequisites

Ensure that the following prerequisites are met before you begin the upgrade procedure.

Availability of Root Credentials for MoP

Ensure that you have root credentials to execute the upgrade steps.

Check the PostgreSQL Health

Run the following command from management node to check the PostgreSQL health of your system:

crm_mon -Arf1

The following sample may resemble the output:

* Node mural-mgt-1.us.guavus.com:
+ master-pgsql : 10
+ pgsql-data-status : STREAMING|POTENTIAL
+ pgsql-master-baseline : 0000001285000090
+ pgsql-receiver-status : normal
+ pgsql-status : HS:alone
+ pgsql-xlog-loc : 000000128427F600
* Node mural-nn-1.us.guavus.com:
+ master-pgsql : 1000
+ pgsql-data-status : LATEST
+ pgsql-master-baseline : 0000001247000090
+ pgsql-receiver-status : normal (master)
+ pgsql-status : PRI
+ pgsql-xlog-loc : 000000128173E718
* Node mural-nn-2.us.guavus.com:
+ master-pgsql : 100
+ pgsql-data-status : STREAMING|SYNC
+ pgsql-receiver-status : normal
+ pgsql-status : HS:sync
+ pgsql-xlog-loc : 000000128173E888

Note: As illustrated above, all the nodes in PostgreSQL cluster must show status as normal.

Installing Ansible

Note: In the previous release of MURAL, Ansible and jinja2 were removed from the management node. In order to upgrade your system, you must re-install them.

Perform the following steps to install Ansible and jinja2

  1. Run the following command to verify if Ansible and jinja packages are already installed or not:

    pip list | grep -iE 'jinja2|ansible'
  2. If Ansible 2.3.1.0 and Jinja 2.8.1 are not found on the management node, run the following command to install them:

    cd /etc/reflex-provisioner/packages/pip
    pip install ansible-2.3.1.0.tar.gz Jinja2-2.8.1-py2.py3-none-any.whl
    
  3. Run the following command to verify if both the components are installed successfully:

    pip list | grep -iE 'jinja2|ansible'

Verify all the services

To verify all the services are up and running, run the following command:

cd /etc/reflex-provisioner
ansible-playbook -i inventory/generated/prod/mural/hosts playbooks/platform/service_checks/all.yml -k

Download RPMs

Perform the following steps to download the RPMs:

  1. Log into the management node.

  2. Download the patch artifacts from SFTP Server, to this location /opt/repos/mrx/5.6/5.6.2.rc1/.

    Note: Refer to the Release Notes of this patch for the complete list of artifacts. Contact technical support for SFTP access credentials.

Compare md5sum

Run the following command to verify the integrity of the copied packages and compare the values of md5sum of RPMs with the downloaded artifacts available in the Release Notes.

# md5sum *

The following sample may resemble the output:

a34fa84e937f05fe9483b96c785063e6  mrx-docker-release-5.6.2.rc1-310.tar.gz
f6d8271e7970d1904274bb111dfe29c5  reflex-aggregation-5.6.2.rc1-310.el7.centos.x86_64.rpm
c05f4065980ecd6f4dc9f4e5279bcfba  reflex-datafactory-5.6.2.rc1-310.el7.centos.x86_64.rpm
f0b84d0503474b5dc0f9e3624f59d5c9  reflex-ddj-5.6.2.rc1-310.el7.centos.x86_64.rpm
42ab03241b7a950e90ec3bf661a01a41  reflex-dme-5.6.2.rc1-310.el7.centos.x86_64.rpm
66f3d2aaba76a95123a07edd124cdf0f  reflex-solution-provisioner-5.6.2.rc1-310.el7.centos.x86_64.rpm
a16bdc0d3a566e379a51b3a48d787160  reportConfigFiles_UK.tgz

Extract the tar file

Run the following command to extract the properties tar file:

tar -zxvf reportConfigFiles_UK.tgz