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 to /opt/repos/mrx/5.6/5.6.2.rc1/ location from SFTP Server.

    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:

f0a16490d8b9ac51051297a5feef98e0  mural5Jobs.tgz
be5d55e3a7eb26146a98ec8d071e600a  app_protocol_list.gz
c141d5fcec869a7a93b3c934948b903a  mrx-docker-release-5.6.2.rc1-312.tar.gz
8b1488bf7c4b17de5b548d5c7901e9cb  reflex-aggregation-5.6.2.rc1-312.el7.centos.x86_64.rpm
ccea72a7b33a930320ae55298346d0cc  reflex-datafactory-5.6.2.rc1-312.el7.centos.x86_64.rpm
2522c99dc504ebadef1f120a78d5b668  reflex-solution-provisioner-5.6.2.rc1-312.el7.centos.x86_64.rpm