Home
MATRIXX Digital Commerce Upgrade
Upgrade Pre-Deployment Tasks
Perform the following tasks before upgrading MATRIXX Digital Commerce.

Welcome
Release Notes
Architecture Overview
MATRIXX Cloud Native Installation and Configuration
MATRIXX Cloud Native Integration
Implementing MATRIXX in a Cloud
Installation and Configuration
MATRIXX Digital Commerce Upgrade
- About Upgrading MATRIXX Digital Commerce
  MATRIXX Digital Commerce Upgrade describes how to upgrade the MATRIXX Digital Commerce software to version 5226. During this process, you upgrade these important MATRIXX Digital Commerce components: MATRIXX Engines in multiple sub-domains, Traffic Routing Agent, Network Enabler, and MATRIXX Gateways and Web apps, including the REST Services (RS) Gateway and MY MATRIXX.
- Upgrade Paths
  Several MATRIXX Digital Commerce upgrade scenarios are tested and supported for this release.
- Upgrade Overview
  Upgrading MATRIXX Digital Commerce has several stages.
- Upgrade Pre-Deployment Tasks
  Perform the following tasks before upgrading MATRIXX Digital Commerce.
  - Upgrade Prerequisites
    The upgrade procedure assumes that you are upgrading a functioning MATRIXX Digital Commerce implementation and have completed all the installation prerequisites, such as creating the mtx and matrixxsw users, and the SSH security keys on the host servers. The user performing the upgrade must have sudo permission for users mtx, tra, and matrixxsw.
  - Distribute the RPM Files to Each MATRIXX Server
    After downloading the MATRIXX Digital Commerce software RPM files from the distribution site, copy them to all servers on which they will be installed.
  - Add Management VS to TRA-PROCs (Pre-5100 Deployments)
    This step applies to any pre-5100 deployments. The target engine will make requests to other engines in the chain using VS cluster control and VS SNMP. These virtual servers use the Management VIP. For every engine in your environment, add a management VS to all TRA-PROCs.
  - Update the Engine Configuration on a Staging Server
    Perform this task on a staging server to update your create_config.info file to the latest version of the MATRIXX Digital Commerce software. You must use an updated create_config.info file to configure your upgraded MATRIXX Engines.
  - Backing Up the MATRIXX Configuration Files
    Perform this task to back up your old MATRIXX Digital Commerce configuration files so that they are available in case you need to roll back the upgrade. Also, some of these configuration files replace configuration files deployed during the upgrade process. Your subscriber data is automatically backed up separately.
  - Validating Database Checkpoints
    Before upgrading, run the validateCheckpoint.jar program. The validateCheckpoint.jar program analyzes a MATRIXX checkpoint, detects any errors in the database, and produces a validation report listing internal database statistics and any errors found.
- Upgrading My MATRIXX
  You can use the following procedures to upgrade your pricing plan from an older version of My MATRIXX to the latest version.
- Upgrading MATRIXX Gateways and Web Apps
  To upgrade MATRIXX Digital Commerce you first need to upgrade and configure each of the MATRIXX Gateways and Web Apps. During the upgrade process, the upgraded services that communicate with the MATRIXX Engines are pinned to the schema version you are upgrading from. After all of the services and their sub-domains have been upgraded, you reconfigure the MATRIXX Gateways and Web Apps to use the new schema version by unpinning them from the previous version.
- Upgrade the MATRIXX Engine Chain
  You can follow the procedure below to upgrade an engine chain for a single sub-domain to the latest version of MATRIXX Digital Commerce.
- Upgrading the TRA-RT-(SI/DR) HA Pair
  Follow this procedure to install the Traffic Routing Agent (TRA) software for TRA servers configured as a TRA-RT-(SI/DR) disaster-recovery and sub-domain routing agent HA Pair. If your MATRIXX implementation uses the MATRIXX Network Enabler, use the instructions in the discussion about upgrading the Network Enabler in related links instead of this upgrade task.
- Unpinning Schema Versions
  After upgrading all subdomain chains and TRA-RT-(SI/DR) remove the schema version pinning in all of the MATRIXX Gateways and Web apps. See the steps for unpinning at the end of the procedures in the related links.
- Upgrading the Service Provider Schema
  Upgrading the service provider schema involves a subset of the steps to perform a full MATRIXX Digital Commerce upgrade.
- Performing Ancillary Upgrade Tasks
  The tasks below are not mandatory and do not apply to all MATRIXX Digital Commerce implementations.
MATRIXX Security
MATRIXX Engine Administration
MATRIXX Web App Administration
MATRIXX Engine Integration
Call Control Framework Integration
MATRIXX Diameter Integration
MATRIXX 5G Integration
MATRIXX Monitoring and Logging
Pricing and Rating
MATRIXX Pay Now
MATRIXX Policy
MATRIXX Event Streaming
Subscriber Management
Subscriber Management (SubMan) API
MATRIXX Business API SDK
My MATRIXX Help
MATRIXX Backoffice Customer Tool Help
Third-Party Licenses
Glossary

Upgrade Pre-Deployment Tasks

Perform the following tasks before upgrading MATRIXX Digital Commerce.

The upgrade process involves installing RPM files and configuring components in a specific sequence. Therefore, MATRIXX recommends that you review all pre-deployment tasks and upgrade procedures before starting. Use a multi-windowing environment, so you can open sessions concurrently on multiple servers.