Data Changes

Data changes made in version 5290 of the MATRIXX software include changes to configuration that might have impacts on systems running earlier versions of the MATRIXX software. Read through all items to find those that apply to you.

Platform

Platform includes the following changes:
  • The max-missed-heartbeat-count and missed-heartbeat-above-water-count parameters were added for Traffic Routing Agent (TRA) heartbeat configuration.
  • Support for sideloaded images, sideloaded image overrides, configmap, and remote URL handling was removed from Helm.
  • The following third-party software was updated to the indicated versions:
    • vert.x: 4.5.7
    • PyMongo: 4.8
    • Spring Boot: 3.2.8
    • Spring Framework: 6.1.12
    • Spring Security: 6.2.6
    • Apache Camel: 4.6.0
    • Apache Commons Lang 3: 3.17
    • Apache Commons Pool 2: 2.12.0
    • Apache Mina Core: 2.2.3
    • Commons Codec: 1.17.1
  • The Red Hat Universal Base Image (UBI) that cloud native MATRIXX images are based on was upgraded to Red Hat Universal Base Image 8 (UBI8). All containers require Linux kernel v4 or higher on worker nodes.
  • The following scripts have been consolidated into print_mtx_version.py (and therefore removed):
    • print_mtx_jar_version.py
    • print_mtx_schema_version.py

    For more information, see the discussion about print_mtx_version.py in MATRIXX Administration.

  • The default process control settings have been changed to prevent the dirty page synchronization (mtx_sync_dpages) process from running.
  • The txnEventSequenceIdFamily Prometheus metric is renamed to txnEventSequenceId so that it matches with the SNMP MIB name for the same stats.
  • The MATRIXX Engine system health check can be enabled and disabled with the engine.operatorV2.engineHealthChecker.enabled property. The default value is true.
  • Event Repository administration scripts now require version 4.8 of the PyMongo driver. Refer to the MongoDB product documentation for instructions on installing PyMongo. For more information see the discussion about Event Repository system requirements in MATRIXX Integration.
  • Documentation was added for the third-party software requirement of MongoDB version 7.0. For more information, see the discussion about event repository system requirements in MATRIXX Integration.
  • A security.certificate.volumeMountPath property is added to the MATRIXX Helm chart for specification of a directory in an application container where a volume with a TLS secret is mounted.

Pricing, Policy, and Rating

Pricing, Policy, and Rating include the following changes:
  • When a normalizer is set up to use parameters, if parameters are not set during the PurchaseOffer request, the default parameter from the catalog item is used.
  • MtxRequiredBalanceInfo now includes the ExpireOnConsumption value that is set in the RequiredBalance.

Application Integration

Application Integration includes the following changes:
  • Default SBA Gateway NRF heartbeat messages now include a PathItem of /nfStatus=REGISTERED.

Network Integration

Network Integration includes the following changes:

  • The LDAP Gateway configuration now includes the paramLdap and paramMdc parameters for the reqMap and rspMap properties. For more information about defining LDAP Gateway properties, see MATRIXX Call Control Framework Integration.
  • The default network-enabler.affinity configuration now ensures that Network Enabler pods each run on their own node. For more information, see the discussion about Network Enablers in secondary networks in MATRIXX Installation and Upgrade.
  • A new mtxtimestamp.utcstring field value mapper is available to convert timestamps to UTC in network responses if needed. For more information about mapping post processing, see MATRIXX 5G Integration.
  • A new gateway.yaml property, gateway.shutdownDelaySeconds, specifies the duration that SBA Gateway shutdown is delayed to allow in-flight requests to be handled. The default value is 10. If Kafka Write to Disk is enabled, a new property gateway.external.kafka.logger.shutdownLoggingGraceSeconds can be used to specify a delay to accommodate any pending records to be written to disk before SBA Gateway shutdown. The default value is 5.

    For more information, see the discussion about shutdown behavior in MATRIXX 5G Integration.