Home
MATRIXX Cloud Native Installation and Configuration
Upgrading Kubernetes
Upgrade Kubernetes by upgrading the cluster where the standby MATRIXX Engine, is running, and then upgrading the cluster where the active MATRIXX Engine is running.

Welcome
Release Notes
Architecture Overview
MATRIXX Cloud Native Installation and Configuration
- About MATRIXX Cloud Native Installation and Upgrade
  MATRIXX Cloud Native Installation and Upgrade describes the tasks required to install MATRIXX Digital Commerce components as containers, using Docker and Kubernetes.
- MATRIXX Docker Images and Supporting Files
  The MATRIXX Digital Commerce software for Docker and Kubernetes is delivered in Docker images. The Helm chart and base configuration files are delivered in TAR archives.
- Installing MATRIXX Digital Commerce
  A containerized MATRIXX Digital Commerce deployment consists of containers running in pods in a multi-node Kubernetes cluster, requiring MATRIXX Digital Commerce Docker images and MATRIXX Engine and Traffic Routing Agent custom resource definitions and controllers.
- Obtain and Host Docker Images
  Obtain the Docker images, utility scripts, and YAML manifest files from MATRIXX, and host the Docker images in a registry so that they can be retrieved and instantiated as containers by Kubernetes.
- Installing and Configuring Helm
  Helm provides a mechanism for deploying Kubernetes manifest files in a controlled manner, and facilitates application upgrade, scaling, and where necessary, rollback. To use the MATRIXX Helm chart, install the Helm software, create a chart repository, and load the MATRIXX Helm chart and sub-charts into your repository.
- Required Helm Role Access Permissions
  The user account that deploys MATRIXX Digital Commerce has specific Helm role requirements.
- Installing MATRIXX Digital Commerce in the Kubernetes Cluster
  Installing cloud native MATRIXX Digital Commerce involves adjusting and rebuilding the MATRIXX Engine sideloader Docker image, then installing with Helm.
- Configuring MATRIXX Digital Commerce Using Helm
  Configure MATRIXX Digital Commerce by adding values for properties from the MATRIXX Helm chart to the values.yaml file. The MATRIXX Helm chart includes component sub-charts in a hierarchy of reusable components.
- Using the MATRIXX Helm Chart
  MATRIXX Digital Commerce is delivered as multiple Docker images that can be deployed in different configurations.
- MATRIXX Cloud Native Reference Architecture
  A MATRIXX Digital Commerce reference configuration runs in Kubernetes clusters in a private or public cloud.
- EKS Reference Architecture
- Enabling MEF Publishing in Kubernetes
  An SSH key, used for password-less SSH login, is required to enable MATRIXX Event File (MEF) publishing in Kubernetes. A secret holds the SSH private key, and the key is specified in Helm values. The SSH key allows administrators to write to a target directory in a secure manner without having to enter a passphrase.
- Debugging and Failure Recovery
  The MATRIXX Engine controller and MATRIXX Engine manager pods create, configure, and start the MATRIXX Engine(s) in a deployment.
- Obtain Version Information from Kubernetes
  You can obtain version and build information for the MATRIXX Engine, while running, with Kubernetes commands.
- Upgrading Kubernetes
  Upgrade Kubernetes by upgrading the cluster where the standby MATRIXX Engine, is running, and then upgrading the cluster where the active MATRIXX Engine is running.
- Upgrading Cloud Native MATRIXX Digital Commerce
  Upgrading or reconfiguring a Cloud Native MATRIXX Digital Commerce installation involves obtaining and hosting the Docker images and Helm charts, preparing configuration, generating new pricing information, and finally upgrading the deployment.
- Control Scripts for Containerized Installations
- Uninstall MATRIXX Engine with Helm
  Use the helm uninstall command to uninstall MATRIXX Engine components installed from the Helm chart.
MATRIXX Cloud Native Integration
Implementing MATRIXX in a Cloud
Installation and Configuration
MATRIXX Digital Commerce Upgrade
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 Kubernetes

Upgrade Kubernetes by upgrading the cluster where the standby MATRIXX Engine, is running, and then upgrading the cluster where the active MATRIXX Engine is running.

Note: Before upgrading, refer to Kubernetes documentation for specific information about upgrade paths. In some cases, minor versions can not be skipped.

The following is the high-level process for upgrading Kubernetes:

(Optional) Create and validate a checkpoint on the active engine.
Stop the standby MATRIXX Engine including any TRA-RT/DR instances or MATRIXX Gateways and web apps in the cluster.
Upgrade the control plane nodes for the standby engine cluster. For more information see the discussion about upgrading kubeadm clusters in Kubernetes documentation.
Upgrade the worker nodes.
Start any processes that were stopped in step 2.
Switch from the Kubernetes cluster for the standby engine to the cluster for the active engine.

Repeat these steps for any other Kubernetes clusters that need to be upgraded.