1. Upgrade Guide
  2. Upgrading Session Monitor
  3. Pre-requisites

Pre-requisites

Before beginning with the process of upgrading, ensure that the following pre-requisites are fulfilled.

Configuring Proxies and Repos

You are required to configure the proxies and repos.

Configure the http proxy in /etc/yum.conf file and also export the proxy's address to the environment.

  1. In /etc/yum.conf, add the following line: 

    proxy=<proxy_server>
  2. Export the proxy's address. 
    export http_proxy=<proxy_server>
export https_proxy=<proxy_server>

Preparing MySQL before Upgrading

Upgrading to Release Session Monitor Release 5.2 requires MySQL 8.0.34. For MySQL 8.0.34, it is required that you upgrade from a MySQL 5.7 GA release.

Upgrades from non-GA releases of MySQL 5.7 or later versions (earlier than 5.7.35) are not supported. In your current Session Monitor Server, ensure that the version of MySQL is 5.7.35 or higher. If it is not, upgrade to the latest GA release of 5.7 (5.7.35 or higher). For more information, see Upgrading MySQL section in the Session Monitor Upgrade Guide for your current Session Monitor version.

Temporarily Disabling External Authentication

For External Authentication enabled systems, it is recommended that you temporally disable External Authentication as after the upgrade to Session Monitor Release 5.2, the Apache Web Server is reverted to NGINX.

Perform the following tasks for Mediation Engine External Authentication:

  1. Log in to the Mediation Engine with the configured credentials.
  2. Disable the External authentication in admin → Settings → System Settings.
  3. Click Update , and log out from the Mediation Engine.
Perform the following tasks for Mediation Engine Connector:
  1. Log in to the Mediation Engine Connector with the configured credentials.
  2. Navigate to admin → Settings → External Authentication and disable 'External authentication' .
  3. Click Save, and log out from Mediation Engine Connector.

Note:

If the admin user is set up for External Authentication, set a local password for the admin user while disabling External Authentication.

Creating a Backup before Upgrading

If you are upgrading from Release 4.4 or Release 5.0 to Release 5.2, it is recommended that you create a backup of the Mediation Engine and Mediation Engine Connector, and Fraud Monitor before you begin the upgrade procedure.

Note:

Currently, there is no rollback option available from an upgrade.

Session Monitor enables you to back up the Configuration, Database, Block Storage and essential Session Monitor files of Session Monitor Servers by providing a Backup and Restore procedure.

For more information, see the Session Monitor Release 5.2 Backup and Restore Guide.

Note:

The process to upgrade Session Monitor Releases 4.4 or 5.0 to Release 5.2 involves the upgrade of the complete tech stack including upgrade of Oracle Linux, Python and MySQL. Release 5.1 to Release 5.2 is a normal upgrade using PSA Upgrade.

A Note if you Have Not Taken a Backup

Create Historical System Diagnostics with the Create savepoint and Include mysqldump check boxes enabled from the PSA Page. This is mandatory.

Download a copy of the Diagnostics created and save it in a safe location. These diagnostics are required to debug any issues in the future.

For more information, see the System Diagnostics section in the Session Monitor Release 5.2 Installation Guide

Note:

Creating the Savepoint is applicable only for the Mediation Engine. Also, enabling the Create savepoint and Include mysqldump check boxes is mandatory for taking Diagnostics.