What's New in This Guide

This section introduces the documentation updates for release 25.1.2xx.

Release 25.1.204- G33152-07, March 2026

General Updates

Updated the release number to 25.1.204 in the entire document.
Updated the image tag details in the following sections:
- Pushing the Images to Customer Docker Registry
- Pushing the NRF Images to OCI Docker Registry

Installation Updates

Updated the supported CNE version in the CNE Requirement section.
Updated the supported Kubernetes version in the Software Requirements section.

Upgrade, Rollback, and Uninstall Updates

Updated the upgrade paths in the Supported Upgrade Paths section.
Updated the rollback paths in the Supported Rollback Paths section.

Fault Recovery Updates

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

Release 25.1.203- G33152-06, October 2025

General Updates

Updated the release number to 25.1.204 in the entire document.
Updated the image tag details in the following sections:
- Pushing the Images to Customer Docker Registry
- Pushing the NRF Images to OCI Docker Registry

Installation Updates

Added the following sections in the Postinstallation Tasks section:
Added the Alert Configuration section in the Postupgrade Tasks section.
Added the global.ipv6HostValidation parameter in the Global Parameters section.
Modified the description of the following parameters in the NRF Cache Data Microservice (nrfcachedata) section:
- nrfcachedata.subscriptionCorePoolSize
- nrfcachedata.subscriptionMaxPoolSize
- nrfcachedata.subscrCondCorePoolSize
- nrfcachedata.subscrCondMaxPoolSize

Upgrade, Rollback, and Uninstall Updates

Updated the upgrade paths in the Supported Upgrade Paths section.
Updated the rollback paths in the Supported Rollback Paths section.

Fault Recovery Updates

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

Release 25.1.202- G33152-05, October 2025

General Updates

Updated the release number to 25.1.204 in the entire document.
Updated the image tag details in the following sections:
- Pushing the Images to Customer Docker Registry
- Pushing the NRF Images to OCI Docker Registry

Installation Updates

Updated the NRF Services section with the following:
- <helm-release-name>-nfregistration - modified the value of minimum and maximum CPU/pod from 2 to 4.
- <helm-release-name>-nfdiscovery- modified the value of minimum and maximum memory/pod from 3 to 5.
- <helm-release-name>-nrfcachedata- modified the value of minimum and maximum memory/pod from 3 to 4.
- <helm-release-name>-ingressgateway-modified the value of minimum and maximum memory/pod from 4 to 5.
Updated the cnDBTier Services section with the following:
- ndbmysqld- modified the value of minimum and maximum memory/pod from 11 to 20.
- ndbappmysqld- modified the value of minimum and maximum CPU/pod from 2 to 8.
Updated the Service Mesh Sidecar section with the following:
- Modified the minimum and maximum CPU values for the ndbappmysqld service from 2 to 4.
- Updated the values of the following for ndbapp.annotations sidecar parameter from 2 to 4:
  - sidecar.istio.io/proxyCPU: "4"
  - sidecar.istio.io/proxyCPULimit: "4"
Added the newly supported ASM version 1.21.6 in the Configuring NRF to Support ASM section.
Added the ingressgateway.maxInMemorySize parameter in the Ingress Gateway Microservice section.
Added the egressgateway.maxInMemorySize parameter in the Egress Gateway Microservice section.
Added the nfsubscription.maxInMemorySize parameter in the NF Subscription Microservice (nfsubscription) section.
Added the nrfauditor.jetty.maxInMemorySize parameter in the NRFAuditor Microservice (nrfauditor) section.
Added the following parameters in the NF Discovery Microservice (nfdiscovery) section.
- nfdiscovery.jetty.maxInMemorySize
- nfdiscovery.undertow.maxConcurrentStream
- nfdiscovery.undertow.initialWindowSize
Updated the default value for nfdiscovery.jetty.maxConnectionsPerDestination and nfdiscovery.jetty.maxConnectionsPerIp parameters from 4 to 10 in the NF Discovery Microservice (nfdiscovery) section.
Added the nrfconfiguration.jetty.maxInMemorySize parameter in the NRF Configuration Microservice (nrfconfiguration) section.
Added the following parameters in the NRF Cache Data Microservice (nrfcachedata) section:
- nrfcachedata.cacheMaxAllowedWorkers
- nrfcachedata.cacheNfTypesPerWorker
- nrfcachedata.discCorePoolSize
- nrfcachedata.discMaxPoolSize
- nrfcachedata.discQueueCapacity
- nrfcachedata.maxInMemorySize
- nrfcachedata.nfInstanceSyncCorePoolSize
- nrfcachedata.nfInstanceSyncMaxPoolSize
- nrfcachedata.nfInstanceSyncQueueCapacity
- nrfcachedata.nfListCorePoolSize
- nrfcachedata.nfListMaxPoolSize
- nrfcachedata.nfListQueueCapacity
- nrfcachedata.nfProfileCorePoolSize
- nrfcachedata.nfProfileMaxPoolSize
- nrfcachedata.nfProfileQueueCapacity
- nrfcachedata.subscriptionCorePoolSize
- nrfcachedata.subscriptionMaxPoolSize
- nrfcachedata.subscriptionQueueCapacity
- nrfcachedata.subscrCondCorePoolSize
- nrfcachedata.subscrCondMaxPoolSize
- nrfcachedata.subscrCondQueueCapacity
- nrfcachedata.subscriptionSyncCorePoolSize
- nrfcachedata.subscriptionSyncMaxPoolSize
- nrfcachedata.subscriptionSyncQueueCapacity
- nrfcachedata.subscrRealtimeCorePoolSize
- nrfcachedata.subscrRealtimeMaxPoolSize
- nrfcachedata.subscrRealtimeQueueCapacity
Removed the following parameters in the Ingress Gateway Microservice section:
- ingressgateway.congestionConfigMode
- ingressgateway.congestionConfig.levels.name
- ingressgateway.congestionConfig.levels.value
- ingressgateway.congestionConfig.levels.resources.name
- ingressgateway.congestionConfig.levels.resources.abatement
- ingressgateway.congestionConfig.levels.resources.onset
- ingressgateway.congestionConfig.refreshInterval

Upgrade, Rollback, and Uninstall Updates

Updated the upgrade paths in the Supported Upgrade Paths section.
Updated the rollback paths in the Supported Rollback Paths section.

Fault Recovery Updates

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

Release 25.1.200- G33152-03, August 2025

Installation Updates

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

Release 25.1.200- G33152-02, July 2025

Installation Updates

Added a note in the following parameters to indicate that they become read-only while performing an upgrade and are configurable via REST API:

global.siteNameToNrfInstanceIdMapping in the Global Parameters section.
Added the note for the following parameters in the Day Zero Configuration section:
- dayZeroConfiguration.hplmnList
- dayZeroConfiguration.ocnrfHost
- dayZeroConfiguration.ocnrfPort
- dayZeroConfiguration.ocnrfScheme
Added the note for the following parameters in the Ingress Gateway Microservice section:
- ingressgateway.errorCodeProfiles[i].errorTitle
- ingressgateway.errorCodeProfiles[i].errorCause
- ingressgateway.errorCodeProfiles[i].errorDescription
- ingressgateway.errorCodeProfiles[i].errorCode
- ingressgateway.errorCodeProfiles[i].name
- ingressgateway.errorCodeProfiles
- ingressgateway.congestionConfigMode
- ingressgateway.congestionConfig.levels.name
- ingressgateway.congestionConfig.levels.value
- ingressgateway.congestionConfig.levels.resources.name
- ingressgateway.congestionConfig.levels.resources.abatement
- ingressgateway.congestionConfig.levels.resources.onset
- ingressgateway.congestionConfig.refreshInterval

Release 25.1.200- G33152-01, July 2025

General Updates

Updated the Table 1-1 table with the release information in the Oracle Error Correction Policy section.
Updated the release number to 25.1.204 in the entire document.
Updated the preinstalled and additional software versions in the Software Requirements section.
Updated the image tag details in the following sections:
- Pushing the Images to Customer Docker Registry
- Pushing the NRF Images to OCI Docker Registry
Added a note in the Creating Private Keys and Certificate section to mention the openssl (version 3.1+) is not supported to generate the keys and certificates.
Updated the description in the Debug Tool Container section to mention that this tool is used for troubleshooting issues only in lab environment and not in production environment.

Installation Updates

Updated the versions for the following appValidate parameters in the Global Parameters section:
- global.appValidate.minViablePath to 24.3.0
- global.appValidate.minKubernetesVersion to 1.29.1
- global.appValidate.minDbTierVersion to 24.3.0
Modified the port number for the traffic.sidecar.istio.io/excludeInboundPorts: "8081" annotation in the db-monitor-svc.podAnnotations in the Service Mesh Sidecar section.
Added the traffic.sidecar.istio.io/excludeInboundPorts: "8081" annotations for the following cnDBTier services in the Service Mesh Sidecar section:
- mgm.annotations
- ndb.annotations
- api.annotations
- ndbapp.annotations
- db-replication-svc.podAnnotations
Added the following parameters in the cnDBTier Requirement section.
- db-replication-svc.initiatebackupBeforeGeoRecoveryRestore
- global.aditionalndbconfigurations.ndb.MaxNoOfConcurrentScans
- global.api.max_binlog_size
Removed the global.additionalndbconfigurations.mysqld.ndb_allow_copying_alter_table parameter from the cnDBTier Requirement section.
Modified the CPU and Memory requirements for the Backup Manager Service (db-backup-manager-svc) in the cnDBTier Services section.
Updated the cnDBTier Sidecars section to indicate that the db-infra-monitor-svc sidecar container is mandatory for Replication service- Leader.
Added the following parameters in the Ingress Gateway Microservice section:
- ingressgateway.jettyMaxUsage
- ingressgateway.messageCopy.keybasedkafkaProducer
- ingressgateway.messageCopy.requestTimeout
- ingressgateway.serverDefaultSettingsMaxConcurrentStream
- ingressgateway.serverDefaultSettingsInitialWindowSize
- ingressgateway.serverDefaultWindowUpdateRatio
- ingressgateway.congestionConfigMode
- ingressgateway.congestionConfig.levels.name
- ingressgateway.congestionConfig.levels.value
- ingressgateway.congestionConfig.levels.resources.name
- ingressgateway.congestionConfig.levels.resources.abatement
- ingressgateway.congestionConfig.levels.resources.onset
- ingressgateway.congestionConfig.refreshInterval
- ingressgateway.overloadControlLocalDiscardEnabled
Updated the default value of the k8NameSpace parameters in the Ingress Gateway Microservice section is changed from ingress-ns to changens:
- ingressgateway.service.ssl.privateKey.k8NameSpace
- ingressgateway.service.ssl.certificate.k8NameSpace
- ingressgateway.service.ssl.caBundle.k8NameSpace
- ingressgateway.service.ssl.keyStorePassword.k8NameSpace
- ingressgateway.service.ssl.trustStorePassword.k8NameSpace
Added the following parameters in the Egress Gateway Microservice section:
- egressgateway.jettyMaxUsage
- egressgateway.messageCopy.keybasedkafkaProducer
- egressgateway.messageCopy.requestTimeout
Added the following jetty parameters for the NRF microservices:
- nfregistration.jetty.enableMetrics and nfregistration.jetty.maxStreamId in the NF Registration Microservice (nfregistration) section.
- nfsubscription.jetty.enableMetrics and nfsubscription.jetty.maxStreamId in the NF Subscription Microservice (nfsubscription) section.
- nrfauditor.jetty.enableMetrics and nrfauditor.jetty.maxStreamId in the NRFAuditor Microservice (nrfauditor) section.
- nfdiscovery.jetty.enableMetrics and nfdiscovery.jetty.maxStreamId in the NF Discovery Microservice (nfdiscovery) section.
- nfaccesstoken.jetty.enableMetrics and nfaccesstoken.jetty.maxStreamId in the NF Access Token Microservice(nfaccesstoken) section.
- nrfconfiguration.jetty.enableMetrics and nrfconfiguration.jetty.maxStreamId in the NRF Configuration Microservice (nrfconfiguration) section.
- nrfartisan.jetty.enableMetrics and nrfartisan.jetty.maxStreamId in the NRF Artisan Microservice (nrfartisan) section.
- nrfcachedata.jetty.enableMetrics and nrfcachedata.jetty.maxStreamId in the NRF Cache Data Microservice (nrfcachedata) section.
Added the localityIndDiscResponse attribute to the deprecatedListparameter in the following sections:
Added a note for During HPA, a traffic loss is expected while scale-in or scale-out of replicas in a deployment for the following parameters:
- ingressgateway.resources.target.averageCpuUtil in the Ingress Gateway Microservice
- egressgateway.resources.target.averageCpuUtil in the Egress Gateway Microservice
- nfregistration.resources.target.averageCpuUtil in the NF Registration Microservice (nfregistration)
- nfsubscription.resources.target.averageCpuUtil in the NF Subscription Microservice (nfsubscription)
- nfdiscovery.resources.target.averageCpuUtil in the NF Discovery Microservice (nfdiscovery)
- nfaccesstoken.resources.target.averageCpuUtil in the NF Access Token Microservice(nfaccesstoken)
- nrfconfiguration.resources.target.averageCpuUtil in the NRF Configuration Microservice (nrfconfiguration)
- nrfartisan.resources.target.averageCpuUtil in the NRF Artisan Microservice (nrfartisan)
- nrfcachedata.resources.target.averageCpuUtil in the NRF Cache Data Microservice (nrfcachedata)
- alternateroute.resources.target.averageCpuUtil in the Alternate Route Microservice (alternate-route)

Upgrade, Rollback, and Uninstall Updates

Updated the upgrade paths in the Supported Upgrade Paths section.
Updated the rollback paths in the Supported Rollback Paths section.

Fault Recovery Updates

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