Home
MATRIXX Digital Commerce Upgrade
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.

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.
- 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.
  - Install, Configure, and Start the TRA-RT-(SI/DR) HA Pair
    Follow this procedure to install and configure the Traffic Routing Agent (TRA) servers configured as a TRA-RT-(SI/DR) disaster-recovery and sub-domain routing agent HA pair.
- 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

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.

Before upgrading the TRA-RT-(SI/DR) software, note these prerequisites:

If you have not already done so, set up SSH password-less login between TRA servers. For details, see the discussion about creating an SSH key for the tra user in Installation and Configuration.
The required hardware and operating system must be installed on each TRA server. For the list of software required, see this discussion about system requirements in Installation and Configuration. For operating system installation instructions, see your hardware vendor documentation for details.
The required open source software must be installed in accordance with third-party specifications. For details see the discussion about third-party software requirements in Installation and Configuration.
You must have created the matrixxsw user on each TRA server. For details, see the discussion about creating MATRIXX users in Installation and Configuration. You do not need to create the mtx user on the TRA servers.
The administrator performing the installation must have sudo su permissions and ssh access to all Traffic Routing Agent servers in the environment. For details see the discussion about creating MATRIXX users in Installation and Configuration.
For the local hosts, and for each IP/VIP you will be generating in /opt/tra/conf/tra_config_network_topology.xml and /opt/tra/conf/tra_confg.xml, add the fully qualified domain name (FQDN) in the /etc/hosts file on the TRA servers, or configure it in your DNS server.