What's New in This Guide

This section introduces the documentation updates for release 24.2.x.

Release 24.2.6- F99450-08, October 2025

General Updates

Installation Updates

Upgrade, Rollback, and Uninstall Updates

Fault Recovery Updates

There are no changes made for this section in this release.

Release 24.2.5- F99450-07, August 2025

General Updates

Added the global.additionalndbconfigurations.mysqld.ndb_allow_copying_alter_table parameter in the cnDBTier Requirement section.

Release 24.2.5- F99450-06, July 2025

General Updates

Upgrade, Rollback, and Uninstall Updates

Release 24.2.4- F99450-05, April 2025

General Updates

Upgrade, Rollback, and Uninstall Updates

Release 24.2.3- F99450-04, January 2025

General Updates

Upgrade, Rollback, and Uninstall Updates

  • Updated the upgrade path in the Supported Upgrade Paths section.
  • Updated the rollback path in the Supported Rollback Paths section.
  • Updated the Uninstalling NRF Using Helm section to remove the --purge command as it is not supported in Helm3.
  • Modified the Uninstalling NRF chapter to rearrange the sections in the correct sequence.
  • Updated the Upgrade Tasks section with the following:
    • Added a note for not to exit from the Helm upgrade command manually.
    • Removed the note in step 3 of upgrade procedure.
    • Updated the example in step 8a for upgrading NRF using Helm chart.
    • Updated the sample output in step 9 for checking the status of the upgrade.
    • Added step 10 to check the upgrade history.
  • Added step 9 in the Preupgrade Tasks section to validate that there are no Database backup is running during NRF upgrade.
  • Added a note in the Upgrade Tasks section to check if there are no database backup is in progress during the NRF upgrade.
  • Added a note about the traffic failure in the Upgrade Strategy section.
  • Added a note about NRF to accept the 3GPP compliant value for NfSetId attribute in the Upgrading NRF section.

Fault Recovery Updates

Release 24.2.2- F99450-03, October 2024

General Updates

  • Updated the release number to 24.2.6 in the entire document.
  • Updated the image tag details in the following sections:
  • Updated the following parameters in the cnDBTier Requirement section:
    • The recommended value of global.ndb.datamemory parameter is changed from 1GB to 2GB.
    • The recommended value of global.additionalndbconfigurations.ndb.MaxNoOfExecutionThreads parameter is changed from 5 to 6.
  • Added the following parameters in the cnDBTier Requirement section:
    • global.additionalndbconfigurations.mysqld.ndb_batch_size
    • global.additionalndbconfigurations.mysqld.ndb_blob_write_batch_bytes
  • Updated the resource requirements for cnDBTier services in the cnDBTier Services section.

Upgrade, Rollback, and Uninstall Updates

  • Updated the upgrade path in the Supported Upgrade Paths section.
  • Updated the rollback path in the Supported Rollback Paths section.
  • Added a note in the Upgrading NRF section to modify the value of global.additionalndbconfigurations.ndb.HeartbeatIntervalDbDb parameter to 1250 while performing cnDBTier upgrade.
  • Added a note in the Upgrade Strategy section to perform in-service upgrade in maintenance window.
Fault Recovery Updates
  • Added the NRF site which is under recovery is receiving the traffic, perform the controlled shutdown procedure to isolate the site in the Prerequisites section.
  • Added Post Fault Recovery section with the procedure to recover NRF traffic after fault recovery.
  • Updated the Graceful Shutdown of NRF Deployment section with the NRF behavior after fault recovery using controlled shutdown feature.

Release 24.2.1- F99450-02, September 2024

General Updates

Upgrade, Rollback, and Uninstall Updates

Release 24.2.0- F99450-01, July 2024

General Updates

Installation Updates

  • Updated the CPU and Memory resource requirements in the cnDBTier Services section for db-monitor-svc service.
  • Updated the Memory resource requirements in the cnDBTier Services section for ndbappmysqld service.
  • Added a reference to see the cnDBTier yaml files for customizing cnDBTier parameters in the cnDBTier Requirement section.
  • Updated the JSON path of the following parameters in the cnDBTier Requirement section:
    • global.additionalndbconfigurations.ndb.NoOfFragmentLogFiles
    • global.additionalndbconfigurations.ndb.MaxNoOfExecutionThreads
    • global.additionalndbconfigurations.replmysqld.ndb_eventbuffer_max_alloc
    • global.additionalndbconfigurations.appmysqld.ndb_eventbuffer_max_alloc
  • Updated the versions for the following appValidate parameters in the Global Parameters section:
    • global.appValidate.minViablePath to 24.1.0.
    • global.appValidate.minKubernetesVersion to 1.27.5.
    • global.appValidate.minDbTierVersion to 23.4.0.
  • Updated the following sections for the Support for TLS 1.3 feature:
  • Added global.overrideReplicationCheck parameter in the Global Parameters section to check whether the NFProfiles from the remote site must be considered for service requests when the replication channel status is down.
  • Added the following parameters in the Ingress Gateway Microservice section:
    • Added the ingressgateway.service.port.http parameter to indicate the HTTP port used for deployment.
    • Added the following parameters for the Support for TLS 1.3 feature:
      • ingressgateway.clientDisabledExtension
      • ingressgateway.serverDisabledExtension
      • ingressgateway.tlsNamedGroups
      • ingressgateway.clientSignatureSchemes
      • ingressgateway.service.ssl.tlsVersion
    • Updated the range details of the ingressgateway.messageCopy.security.tlsVersion parameter with TLSv1.3 for the Support for TLS 1.3 feature.
  • Added the following parameters in the Egress Gateway Microservice section:
    • Added the egressgateway.rollingUpdate.maxSurge to indicate the maximum surge that occurs at Egress Gateway pods during upgrade.
    • Added the following parameters for the Support for TLS 1.3 feature:
      • egressgateway.clientDisabledExtension
      • egressgateway.serverDisabledExtension
      • egressgateway.tlsNamedGroups
      • egressgateway.service.ssl.tlsVersion
      • egressgateway.clientSignatureSchemes
    • Updated the range details with TLSv1.3 for the egressgateway.messageCopy.security.tlsVersion parameter.
  • Added the following parameters in the NF Registration Microservice (nfregistration) section:
    • Added the nfregistration.global.overrideReplicationCheck parameter as a reference to the global parameter.
    • Added the nfregistration.service.port.http parameter to indicate the HTTP port used for deployment.
    • Added the following jetty parameters:
      • nfregistration.jetty.connectionFailureThreshold
      • nfregistration.jetty.connectionTimeout
      • nfregistration.jetty.dnsRefreshDelay
      • nfregistration.jetty.idleTimeout
      • nfregistration.jetty.maxConcurrentPushedStreams
      • nfregistration.jetty.maxConnectionsPerDestination
      • nfregistration.jetty.maxConnectionsPerIp
      • nfregistration.jetty.maxRequestsQueuedPerDestination
      • nfregistration.jetty.pingDelay
  • Added the following parameters in the NF Subscription Microservice (nfsubscription) section:
    • Added the nfsubscription.service.port.http parameter to indicate the HTTP port used for deployment.
    • Added the following jetty parameters:
      • nfsubscription.jetty.connectionFailureThreshold
      • nfsubscription.jetty.connectionTimeout
      • nfsubscription.jetty.dnsRefreshDelay
      • nfsubscription.jetty.idleTimeout
      • nfsubscription.jetty.maxConcurrentPushedStreams
      • nfsubscription.jetty.maxConnectionsPerDestination
      • nfsubscription.jetty.maxConnectionsPerIp
      • nfsubscription.jetty.maxRequestsQueuedPerDestination
      • nfsubscription.jetty.pingDelay
  • Added the following parameters in the NRFAuditor Microservice (nrfauditor) section:
    • Added the nrfauditor.service.port.http parameter to indicate the HTTP port used for deployment.
    • Added the following jetty parameters:
      • nrfauditor.jetty.connectionFailureThreshold
      • nrfauditor.jetty.connectionTimeout
      • nrfauditor.jetty.dnsRefreshDelay
      • nrfauditor.jetty.idleTimeout
      • nrfauditor.jetty.maxConcurrentPushedStreams
      • nrfauditor.jetty.maxConnectionsPerDestination
      • nrfauditor.jetty.maxConnectionsPerIp
      • nrfauditor.jetty.maxRequestsQueuedPerDestination
      • nrfauditor.jetty.pingDelay
  • Added the following parameters in the NF Discovery Microservice (nfdiscovery) section:
    • Added the nfdiscovery.global.overrideReplicationCheck parameter as a reference to the global parameter.
    • Added the nfdiscovery.service.port.http parameter to indicate the HTTP port used for deployment.
    • Added the nfdiscovery.encodeDiscQueryObjectMode parameter to send the discovery request query parameters in a defined format.
    • Added the following jetty parameters:
      • nfdiscovery.jetty.connectionFailureThreshold
      • nfdiscovery.jetty.connectionTimeout
      • nfdiscovery.jetty.dnsRefreshDelay
      • nfdiscovery.jetty.idleTimeout
      • nfdiscovery.jetty.maxConcurrentPushedStreams
      • nfdiscovery.jetty.maxConnectionsPerDestination
      • nfdiscovery.jetty.maxConnectionsPerIp
      • nfdiscovery.jetty.maxRequestsQueuedPerDestination
      • nfdiscovery.jetty.pingDelay
  • Added the following parameters in the NF Access Token Microservice(nfaccesstoken) section:
    • Added the nfaccesstoken.global.overrideReplicationCheck parameter as a reference to the global parameter.
    • Added the nfaccesstoken.service.port.http parameter to indicate the HTTP port used for deployment.
    • Added the following jetty parameters:
      • nfaccesstoken.jetty.connectionFailureThreshold
      • nfaccesstoken.jetty.connectionTimeout
      • nfaccesstoken.jetty.dnsRefreshDelay
      • nfaccesstoken.jetty.idleTimeout
      • nfaccesstoken.jetty.maxConcurrentPushedStreams
      • nfaccesstoken.jetty.maxConnectionsPerDestination
      • nfaccesstoken.jetty.maxConnectionsPerIp
      • nfaccesstoken.jetty.maxRequestsQueuedPerDestination
      • nfaccesstoken.jetty.pingDelay
  • Added the following parameters in the NRF Configuration Microservice (nrfconfiguration) section:
    • Added the nrfconfiguration.service.port.http parameter to indicate the HTTP port used for deployment.
    • Added the following jetty parameters:
      • nrfconfiguration.jetty.connectionFailureThreshold
      • nrfconfiguration.jetty.connectionTimeout
      • nrfconfiguration.jetty.dnsRefreshDelay
      • nrfconfiguration.jetty.idleTimeout
      • nrfconfiguration.jetty.maxConcurrentPushedStreams
      • nrfconfiguration.jetty.maxConnectionsPerDestination
      • nrfconfiguration.jetty.maxConnectionsPerIp
      • nrfconfiguration.jetty.maxRequestsQueuedPerDestination
      • nrfconfiguration.jetty.pingDelay
  • Added the following parameters in the NRF Artisan Microservice (nrfartisan) section:
    • Added the nrfartisan.global.overrideReplicationCheck parameter as a reference to the global parameter.
    • Added the nrfartisan.service.port.http parameter to indicate the HTTP port used for deployment.
    • Added the following jetty parameters:
      • nrfartisan.jetty.connectionFailureThreshold
      • nrfartisan.jetty.connectionTimeout
      • nrfartisan.jetty.dnsRefreshDelay
      • nrfartisan.jetty.idleTimeout
      • nrfartisan.jetty.maxConcurrentPushedStreams
      • nrfartisan.jetty.maxConnectionsPerDestination
      • nrfartisan.jetty.maxConnectionsPerIp
      • nrfartisan.jetty.maxRequestsQueuedPerDestination
      • nrfartisan.jetty.pingDelay
  • Added the following parameters in the NRF Cache Data Microservice (nrfcachedata) section:
    • Added the nrfcachedata.global.overrideReplicationCheck parameter as a reference to the global parameter.
    • Added the nrfcachedata.service.port.http parameter to indicate the HTTP port used for deployment.
    • Added the following jetty parameters:
      • nrfcachedata.jetty.connectionFailureThreshold
      • nrfcachedata.jetty.connectionTimeout
      • nrfcachedata.jetty.dnsRefreshDelay
      • nrfcachedata.jetty.idleTimeout
      • nrfcachedata.jetty.maxConcurrentPushedStreams
      • nrfcachedata.jetty.maxConnectionsPerDestination
      • nrfcachedata.jetty.maxConnectionsPerIp
      • nrfcachedata.jetty.maxRequestsQueuedPerDestination
      • nrfcachedata.jetty.pingDelay
  • Added the following parameters in the App Info Microservice (appinfo) section:
    • appinfo.nodeSelector.nodeSelectorEnabled
    • appinfo.nodeSelector.nodeSelectorKey
    • appinfo.nodeSelector.nodeSelectorValue
  • Added the following parameters in the Alternate Route Microservice (alternate-route) section:
    • alternate-route.rollingUpdate.maxUnavailable
    • alternate-route.rollingUpdate.maxSurge
    • alternate-route.service.customExtension.annotations
    • alternate-route.service.customExtension.labels
  • Added the following parameters in the Perf Info Microservice (perf-info) section:
    • perf-info.overloadManager.calculationInterval
    • perf-info.overloadManager.ajacentLevelDuration
  • Updated the name of the following messageCopy parameters in the document from message-copy to messageCopy in the Ingress Gateway Microservice section.
    • ingressgateway.messageCopy.enabled
    • ingressgateway.messageCopy.copyPayload
    • ingressgateway.messageCopy.topicName
    • ingressgateway.messageCopy.ackRequired
    • ingressgateway.messageCopy.retryOnFailure
    • ingressgateway.messageCopy.security.enabled
    • ingressgateway.messageCopy.security.protocol
    • ingressgateway.messageCopy.security.tlsVersion
    • ingressgateway.messageCopy.security.saslConfiguration.username
    • ingressgateway.messageCopy.security.saslConfiguration.password
    • ingressgateway.messageCopy.security.saslConfiguration.k8SecretName
    • ingressgateway.messageCopy.security.saslConfiguration.k8NameSpace
    • ingressgateway.messageCopy.security.saslConfiguration.fileName
  • Updated the name of the following messageCopy parameters in the document from message-copy to messageCopy in the Egress Gateway Microservice section.
    • egressgateway.messageCopy.enabled
    • egressgateway.messageCopy.copyPayload
    • egressgateway.messageCopy.topicName
    • egressgateway.messageCopy.ackRequired
    • egressgateway.messageCopy.retryOnFailure
    • egressgateway.messageCopy.security.enabled
    • egressgateway.messageCopy.security.protocol
    • egressgateway.messageCopy.security.tlsVersion
    • egressgateway.messageCopy.security.saslConfiguration.username
    • egressgateway.messageCopy.security.saslConfiguration.password
    • egressgateway.messageCopy.security.saslConfiguration.k8SecretName
    • egressgateway.messageCopy.security.saslConfiguration.k8NameSpace
    • egressgateway.messageCopy.security.saslConfiguration.fileName.ccaHeaderValidation
  • Added the extraContainers parameter in the document to control the usage of extra container when DEBUG tool is ENABLED in the following sections:

Upgrade, Rollback, and Uninstall Updates

  • Updated the upgrade path in the Supported Upgrade Paths section.
  • Updated the rollback path in the Supported Rollback Paths section.
  • Added a note in the Upgrading NRF section to refer the cnDBTier section for allocating the cnDBTier resources before upgrading NRF.
  • Added a note in the Upgrading NRF section to mention that in the georeplicated NRF deployments, the difference between the NRF release versions for all the georedundant sites cannot be more than 1.