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 OCSM 5.1 requires MySQL 8.0. For MySQL 8.0, it is required that you upgrade from a MySQL 5.7 GA release.

Upgrades from non-GA releases of MySQL 5.7 or Older Versions (earlier than 5.7.35) are not supported. In your current OCSM 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 OCSM version.

Temporarily Disabling External Authentication

For External Authentication enabled systems, it is recommended that you temporally disable External Authentication as after the upgrade to OCSM 5.1, 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 MEC with the configured credentials.
  2. Navigate to admin → Settings → External Authentication and disable 'External authentication' .
  3. Click Save, and log out from MEC.

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

It is recommended that you create a backup of the Mediation Engine (ME) and Mediation Engine Connector (MEC), and Fraud Monitor (FM) before you begin the upgrade procedure.

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

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

Note:

The process to upgrade Session Monitor Releases 4.4 or 5.0 to Release 5.1 is a lengthy process involving the upgrade of the complete tech stack including upgrade of Oracle Linux, Python and MySQL.

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.1 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.