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

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.
  - Tag a Pricing Repository
    Tag a pricing repository before updating My MATRIXX. A subversion tag marks a version of a directory in Subversion and allows you to recreate a build or environment at any time by referring to the tag name. A pricing repository version is a snapshot that records the current state of the pricing repository.
  - Upgrade My MATRIXX
    Follow this procedure to upgrade My MATRIXX and your pricing domains.
  - Validate the Price Plan
    When you validate the price plan in My MATRIXX, you are checking all the files in your local workspace that you have changed and any files updated in your workspace others may have changed. During pricing validation, My MATRIXX checks that pricing items are correctly defined (with required values) and checks the pricing schema against the schema definitions of the running engine (or MATRIXX configuration file) that it points to.
  - Compile a Production Pricing ZIP File
    The production ZIP file contains pricing files that are based on the files in the master data directory and that use the latest revisions of the pricing files checked into SVN. It does not contain any changed files in any user's local workspace if they have not been checked in.
  - Update Domain Names
    If you are upgrading from a pre-5200 version, your domain names can only contain alphanumeric characters, dashes (-), and underscores (_). No other special characters are allowed. If your domain names contain any restricted characters, you can update your domain names through My MATRIXX or using SVN commands.
- 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

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.

Important: If you are performing a major or minor upgrade, there may be data changes that impact your pricing plan and pricing domains. See the discussion about data changes in Release Notes for a list of these changes before upgrading the My MATRIXX software.