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.

Intended Audience

This information is intended for administrators responsible for upgrading MATRIXX Digital Commerce.

About MATRIXX Upgrades

The upgrade process tasks depend on the type of upgrade you are performing. MATRIXX Digital Commerce uses these upgrade categories:

  • Major — In major upgrades one or both of the first two digits of the release level are incremented, for example, 4623 to 4712, or 4753 to 5012. Schema and architecture changes are normal for major releases.
  • Minor — In minor upgrades the third digit of the release level are incremented, for example, 4613 to 4623. Schema changes are probable in minor releases.
  • Maintenance — Only the fourth digit of the release level is incremented, for example, 5020 to 5021. There are no schema changes between maintenance releases.

Upgrading Without Processing Interruptions

Upgrades that include schema changes to the MATRIXX Engine are performed online, that is, while the MATRIXX Engine continues to process network traffic.

You do this by upgrading an engine while the rest of the engine chain continues to process network data and queue realtime transactions. The database schema and APIs are upgraded by the standby engine while the active engine processes network data normally. You then make the upgraded standby engine active, and upgrade the other engines in the chain. And because MDC traffic is always backward-compatible, this process is invisible to the applications communicating with the MATRIXX Engine.

About the MATRIXX Schema Versions

An engine with an older system schema version does not start if an active engine with a higher version is already running. The MATRIXX Digital Commerce schema version is an unsigned 16-bit number that represents a snapshot in time of a specific collection of MDCs. There are two schema versions, one for base MDCs and one for service provider custom MDCs. These schema versions are incremented each time one or more MDCs have changed. The MDC header also contains a schema version for the MDC fields. One schema version contains the highest schema version of any MATRIXX field in the MDC, and the other stores the highest schema version of any Service Provider field in the MDC.

Conventions

This guide uses the following conventions.

Bold Identifies items whose names are predefined by the system, such as user interface controls.
Italics Identifies variables that are parameters whose actual names or values are to be supplied by the user.
Monospace Identifies file names and directories, data value examples, code examples, blocks of code, references to code snippets inline, system messages, and commands supplied by the user.

Documentation Feedback

MATRIXX Software strives to provide concise, complete, and accurate product documentation and welcomes all feedback. If you have any comments, corrections, or suggestions for improvement, please send them to [email protected].

Support

MATRIXX Software works with you to plan, configure, implement and integrate a MATRIXX Engine installation into your data center. Technical support services include:
  • Discovery and sizing services.
  • Installation and configuration services.
  • Data migration and update services for pricing and subscribers.

For more information about MATRIXX services, please contact us.