What's New in This Guide

This section lists the documentation updates for Release 25.1.2xx in Oracle Communications Network Analytics Data Director Installation, Upgrade, and Fault Recovery Guide.

Release 25.1.200 - G32789-02, August 2025

Updated steps for Migration of Kafka to Kraft Mode in Post Upgrade Task.

Release 25.1.200 - G32789-01, July 2025

General Updates:
- Updated the release number to 25.1.200 in the entire document.
- Updated the software details in Software Requirements section.
- Updated the Environment Setup Requirements details.
- Added 'kraft-controller' service and removed 'zookeeper' service from the list of services in the Resource Requirements section.
Installation Updates:
- Updated the docker images and version details in Pushing the Images to Customer and OCI Registry section.
- Update the note in Creating OCNADD Namespace section.
- Updated the overview, list of services, and the procedure for Configuring SSL or TLS Certificates.
- Removed the "Kubectl HNS Installation" section from the Pre-Installation Tasks.
- Updated the versions and code snippets in the procedure for Installing OCNADD Package.
- Updated the default parameters listed for Model 1 and Model 2 in the OCNADD Deployment Models section.
- Updated the Customize Configuration Parameters section with the details of Updating the OCNADD Kafka Deployment Mode and the step to Enable the specific Aggregation service.
- Performed the following updates to the parameters listed in the following sections:
  - Added or Updated the details of the following parameters in the Global Parameters section:
    - ocnaddscpaggregation.enabled
    - ocnaddnrfaggregation.enabled
    - ocnaddseppaggregation.enabled
    - ocnaddbsfaggregation.enabled
    - ocnaddpcfaggregation.enabled
    - kafka.kraftEnabled
    - kafka.spawnKraftController
    - kafka.migrationBroker
    - kafka.kraftBroker
    - kafka.finalizeMigration
    - kafka.removeZookeeper
    - kafka.occmZookeeperClientUUID
    - kafka.occmZookeeperServerUUID
    - cnlb.consumeradapter.enable
    - cnlb.ingressadapter.enable
    - cnlb.ocnaddredundancyagent.enable
    - cnlb.ocnaddredundancyagent.network
    - cnlb.ocnaddredundancyagent.externalIP
    - cnlb.kafkabroker.enable
    - cnlb.kafkabroker.networks
    - cnlb.kafkabroker.networks_extip
  - Removed the following non-supported parameters from the Global Parameters section:
    - ocnaddaggregation.enabled
    - ocnadduirouter.enabled
    - env.admin.OCNADD_EGW_UPGRADE_ENABLE
    - initContainers.image
    - image.ocnaddadminsvc.name
    - image.ocnaddconsumeradapter.name
    - image.ocnaddaggregation.name
    - image.ocnaddalarm.name
    - image.ocnaddconfiguration.name
    - image.ocnaddegressgateway.name
    - image.ocnaddfilter.name
    - image.ocnaddhealthmonitoring.name
    - image.ocnadduirouter.name
    - image.ocnaddbackuprestore.name
    - image.ocnadd_kafka_healthclient.name
    - image.ocnadd_jmx_exporter.name
    - image.ocnaddgui.name
    - image.ocnaddredundancyagent.name
    - cluster.egwGroupLatencyMessageCountMax
    - admin.OCNADD_UPGRADE_WG_NS
  - Added or Updated the details of the following parameters in the Aggregation Service Parameters section:
    - DD_METADATA_MAP_CACHE_EXPIRY_TIME_MS
    - DD_METADATA_MAP_CACHE_SCHEDULER_TIME_MS
    - MESSAGE_REORDERING_INCOMPLETE_TRANSACTION_METRICS_ENABLE
    - OCNADD_KAFKA_BOOTSTRAP_SERVER_SSL
    - OCNADD_KAFKA_SASL_MECHANISM
    - OCNADD_KAFKA_SECURITY_PROTOCOL_SASL
    - OCNADD_KAFKA_SECURITY_PROTOCOL_SSL
    - ocnaddbsfaggregation.maxReplicas
    - ocnaddbsfaggregation.minReplicas
    - ocnaddnonoracleaggregation.maxReplicas
    - ocnaddnonoracleaggregation.minReplicas
    - ocnaddnrfaggregation.maxReplicas
    - ocnaddnrfaggregation.minReplicas
    - ocnaddpcfaggregation.resources.limit.cpu
    - ocnaddpcfaggregation.resources.limit.ephemeralstorage
    - ocnaddpcfaggregation.resources.limit.memory
    - ocnaddscpaggregation.minReplicas
    - ocnaddseppaggregation.maxReplicas
    - ocnaddseppaggregation.minReplicas
    - SRC_FEED_METADATA_CLEAN_DELAY_SEC
    - SRC_FEED_METADATA_CLEAN_PERIOD_SEC
    - SRC_FEED_METADATA_HISTORY_LENGTH
    - TOTAL_FORWARDED_MESSAGE_METRICS_ENABLE
  - Removed the following parameters from the Aggregation Service Parameters section:
    - KAFKA_BOOTSTRAP_SERVER
    - KAFKA_PRODUCER_SASL_MECHANISM
    - KAFKA_PRODUCER_SECURITY_PROTOCOL
    - KAFKA_PRODUCER_SSL_PROTOCOL
    - METADATA_CLEAN_DELAY_SEC
    - METADATA_CLEAN_PERIOD_SEC
    - METADATA_HISTORY_LENGTH
    - OCNADD_METRICS_CPU_THRESHOLD
    - OCNADD_METRICS_MEM_THRESHOLD
  - Added or Updated the details of the following parameters in the Configuration Service Parameters section:
    - ADAPTER_DEFAULT_INGRESS_ACKS
    - ADAPTER_DEFAULT_INGRESS_LIMIT
    - ADAPTER_DEFAULT_INGRESS_PARTITIONS
    - ADAPTER_DEFAULT_INGRESS_REPLICATION_FACTOR
    - ADAPTER_DEFAULT_INGRESS_RETENTION_MS
    - ADAPTER_DEFAULT_INGRESS_RETRY
    - ADAPTER_DEFAULT_INGRESS_TOPIC
    - ADMIN_RESPONSE_TIMEOUT_MS
    - ADMIN_RETRY_DELAY_MS
    - CONFIG_NOTIFICATION_RETRY_DELAY
    - CONFIG_NOTIFICATION_RETRY_MAXATTEMPT
    - CONFIG_NOTIFICATION_SCHEDULER_INITIAL_DELAY_MS
    - CONFIG_NOTIFICATION_SCHEDULER_PERIOD_MS
    - CONFIGURATION_FILTER_METHODS
    - EXPORT_CONFIG_PURGE_TIMER_HR
    - EXPORT_PURGE_SCHEDULER_DELAY_MS
    - OCNADD_CONFIG_FILTER_NOTIF_DELAY_SEC
    - OCNADD_CONFIG_TIMEOUT_CONNECT
    - OCNADD_CONFIG_TIMEOUT_READ_IDLE
    - OCNADD_CONFIG_TIMEOUT_SSL_HANDSHAKE
    - OCNADD_CONFIGURATION_LIVENESS_DELAY
    - OCNADD_CONFIGURATION_LIVENESS_FAILURE
    - OCNADD_CONFIGURATION_LIVENESS_PERIOD_SECONDS
    - OCNADD_CONFIGURATION_LIVENESS_TIMEOUT
    - resources.limits.cpu
    - resources.limits.ephemeralstorage
    - resources.limits.memory
    - resources.requests.cpu
    - resources.requests.ephemeralstorage
    - resources.requests.memory
    - SITE_REDUNDANCY_RESPONSE_TIMEOUT
    - SITE_REDUNDANCY_RETRY
    - SITE_REDUNDANCY_RETRY_DELAY
  - Removed the following parameters from the Configuration Service Parameters section:
    - ADMIN_FETCH_TIMEOUT
    - ADMIN_RETRY_DELAY
    - FEED_NOTIFICATION_RETRY_DELAY
    - FEED_NOTIFICATION_RETRY_MAXATTEMPT
    - INGRESS_NOTIFICATION_RETRY_DELAY
    - INGRESS_NOTIFICATION_RETRY_MAXATTEMPT
  - Added or Updated the details of the following parameters in the Health Monitoring and Alarm Service Parameters section:
    - resources.limits.cpu
    - resources.limits.memory
    - resources.limits.ephemeralstorage
    - resources.requests.cpu
    - resources.requests.memory
    - resources.requests.ephemeralstorage
  - Added or Updated the details of the following parameters in the Admin Service Parameters section:
    - ADAPTER_ASYNC_ENDPOINT_RETRY_SCH_FXD_DELAY
    - ADAPTER_DEFAULT_INGRESS_ACKS
    - ADAPTER_DEFAULT_INGRESS_LIMIT
    - ADAPTER_DEFAULT_INGRESS_PARTITIONS
    - ADAPTER_DEFAULT_INGRESS_REPLICATION_FACTOR
    - ADAPTER_DEFAULT_INGRESS_RETENTION_MS
    - ADAPTER_DEFAULT_INGRESS_RETRY
    - ADAPTER_DEFAULT_INGRESS_TOPIC
    - ADAPTER_KAFKA_AUTOCOMMIT_INT_CONFIG
    - ADAPTER_KAFKA_ENABLE_AUTO_COMMIT
    - ADAPTER_KAFKA_FETCH_MIN_BYTES
    - ADAPTER_KAFKA_MAX_METADATA_AGE
    - ADAPTER_KAFKA_SOURCE_TOPIC
    - ADAPTER_KAFKA_TOPIC_CHECK_INITIAL_DELAY
    - ADAPTER_TCP_CLIENT_CHANNEL_TIMEOUT
    - ADAPTER_TCP_CLIENT_KEEPALIVE_COUNT
    - ADAPTER_TCP_CLIENT_KEEPALIVE_IDLE
    - ADAPTER_TCP_CLIENT_KEEPALIVE_INT
    - ADAPTER_TCP_CLIENT_POOL_MAX
    - ADAPTER_TCP_CLIENT_SSL_HANDSHAKE
    - ADAPTER_TCP_CONNECT_MAX_RETRY_DELAY_MS
    - ADAPTER_TCP_CONNECT_RETRY_MS
    - ADAPTER_TCP_CONNECT_TIMEOUT
    - ADMIN_FETCH_TIMEOUT
    - ADMIN_RESPONSE_TIMEOUT_MS
    - ADMIN_RETRY_DELAY
    - ALARM_CLIENT_RETRY_COUNT
    - CONFIG_NOTIFICATION_RETRY_DELAY
    - CONFIG_NOTIFICATION_RETRY_MAXATTEMPT
    - CONFIG_NOTIFICATION_SCHEDULER_INITIAL_DELAY_MS
    - CONFIG_NOTIFICATION_SCHEDULER_PERIOD_MS
    - CONFIGURATION_FILTER_METHODS
    - consumeradapter.resources.limits.cpu
    - consumeradapter.resources.limits.ephemeralstorage
    - consumeradapter.resources.limits.memory
    - consumeradapter.resources.requests.cpu
    - consumeradapter.resources.requests.ephemeralstorage
    - consumeradapter.resources.requests.memory
    - EGRESS_CHANNEL_TIMEOUT_SEC
    - EGRESS_HTTP_CLIENT_MAX_CONCURRENT_HTTP_CONN
    - EGRESS_HTTP_CLIENT_SHUTDOWN_QUIET_PERIOD_SEC
    - EGRESS_HTTP_CLIENT_SHUTDOWN_TIMEOUT_SEC
    - EGRESS_HTTP_FOLLOW_REDIRECTS
    - EGRESS_HTTP_MAX_CONCURR_REQ_PER_HTTP_CONN
    - EGRESS_KEEPALIVE_COUNT
    - EGRESS_KEEPALIVE_IDLE
    - EGRESS_KEEPALIVE_INT
    - EGRESS_MAX_CONNECTION_POOL_IDLE
    - EGRESS_RESPONSE_IDLE_TIMEOUT_SEC
    - EGRESS_RESPONSE_TIMEOUT_SEC
    - EGRESS_SSL_CLIENT_AUTH
    - EGRESS_TRUSTSTORE_ENABLED
    - ENABLE_KAFKA_RECORD_TIMESTAMP_PROCESSING
    - EXPORT_CONFIG_PURGE_TIMER_HR
    - EXPORT_PURGE_SCHEDULER_DELAY_MS
    - FEED_NOTIFICATION_RETRY_DELAY
    - FEED_NOTIFICATION_RETRY_MAXATTEMPT
    - INGRESS_NOTIFICATION_RETRY_DELAY
    - INGRESS_NOTIFICATION_RETRY_MAXATTEMPT
    - HTTP_ENABLE_SUBSCRIBE_API_ASYNC_PROCESSING
    - KAFKA_TOPIC_SEGMENT_MS
    - MAX_CONSECUTIVE_ERRORS_ALLOWED
    - MAX_CONSECUTIVE_SUCCESS_REQ_ALLOWED
    - OCNADD_ADAPTER_CONFIG_RETRY_DELAY
    - OCNADD_ADAPTER_CONFIG_RETRY_DELETE_SUBS_REQ_ATTEMPT
    - OCNADD_ADAPTER_CONFIG_RETRY_DELETE_SUBS_REQ_DELAY
    - OCNADD_ADAPTER_HEALTH_HB_TIMER
    - OCNADD_ADAPTER_HEALTH_RETRY_COUNT
    - OCNADD_ADAPTER_HEALTH_RETRY_DELAY
    - OCNADD_ADAPTER_MAX_REPLICAS_HTTP2
    - OCNADD_ADAPTER_MIN_REPLICAS_HTTP2
    - OCNADD_ADAPTER_MIN_REPLICAS_TCP
    - OCNADD_ADMIN_PORT
    - OCNADD_ADMINSVC_HEALTH_HB_TIMER
    - OCNADD_ADMINSVC_HEALTH_RETRY_COUNT
    - OCNADD_ADMINSVC_HEALTH_RETRY_DELAY
    - OCNADD_CONFIGURATION_LIVENESS_DELAY
    - OCNADD_CONFIGURATION_LIVENESS_FAILURE
    - OCNADD_CONFIGURATION_LIVENESS_PERIOD_SECONDS
    - OCNADD_CONFIGURATION_LIVENESS_TIMEOUT
    - OCNADD_CONFIG_FILTER_NOTIF_DELAY_SEC
    - OCNADD_CONFIG_TIMEOUT_CONNECT
    - OCNADD_CONFIG_TIMEOUT_READ_IDLE
    - OCNADD_CONFIG_TIMEOUT_SSL_HANDSHAKE
    - OCNADD_CONSUMER_ADAPTER_PORT
    - OCNADD_INTERNAL_CLIENT_SSL_HANDSHAKE_TIMEOUT
    - OCNADD_INTERNAL_CLIENT_SSL_PROTOCOL
    - OCNADD_INTERNAL_CLIENT_SSL_PROTOCOLS
    - OCNADD_KAFKA_SSL_PROTOCOL
    - OCNADD_SSL_CIPHERS
    - resources.limits.cpu
    - resources.limits.ephemeralstorage
    - resources.limits.memory
    - resources.requests.cpu
    - resources.requests.ephemeralstorage
    - resources.requests.memory
    - SO_SEND_BUF_BYTES_HTTP
    - STREAM_THREAD_DELAY_MS
    - SYNTHETIC_SEQ_ACK_CACHE_CLEAN_DELAY_SEC
    - SYNTHETIC_SEQ_ACK_CACHE_CLEAN_PERIOD_SEC
    - SYNTHETIC_STREAM_ID_CACHE_CLEAN_DELAY_SEC
    - SYNTHETIC_STREAM_ID_CACHE_CLEAN_PERIOD_SEC
    - SYNTHETIC_STREAM_ID_TRANSACTION_MGMT_TIMER_MILLI
    - TCP_CONN_INSPECTOR_ENABLED
    - TCP_CONN_INSPECTOR_FIXED_DELAY
    - TCP_CONN_INSPECTOR_INI_DELAY
    - TCP_SEQ_ACK_CONNECTION_MGMT_TIMER_MILLI
    - TCP_STREAM_RESTART_INTERVAL_MS
  - Removed the following parameters from the Admin Service Parameters section:
    - OCNADD_ADAPTER_LOG_LEVEL_NETTY
    - OCNADD_ADAPTER_LOG_LEVEL
    - OCNADD_ADAPTER_MIN_REPLICAS
    - OCNADD_ADAPTER_MAX_REPLICAS
    - ADAPTER_WEBCLIENT_TYPE
    - OCNADD_ADAPTER_USE_TS
    - OCNADD_ADAPTER_SERVER_SSL
    - EGRESS_MAX_CONNECTION_POOL_COUNT
    - EGRESS_SSL_CLOSE_NOTIFY_FLUSH_TIMEOUT
    - EGRESS_SSL_CLOSE_NOTIFY_READ_TIMEOUT
    - EGRESS_CLIENT_MAX_INMEMORY
    - EGRESS_JETTY_MAX_CONNECTION_PER_DESTINATION
    - EGRESS_JETTY_MAX_REQUEST_PER_DESTINATION
    - EGRESS_JETTY_CLIENT_IDLE_TIMEOUT
    - EGRESS_JETTY_CLIENT_CONNECT_BLOCKING
    - EGRESS_JETTY_CLIENT_CONNECT_TIMEOUT
    - EGRESS_JETTY_CLIENT_STREAM_IDLE_TIMEOUT
    - EGRESS_JETTY_CLIENT_MAX_CONCURR_PUSHED_STREAM
    - ADAPTER_TCP_CLIENT_MSG_RETRY_MAX_ATTEMPTS
    - ADAPTER_TCP_CLIENT_MSG_RETRY_DELAY
    - ENABLE_ADAPTER_LATENCY_METRICS
    - ENABLE_L3L4_COUNTER_METRICS
    - OCNADD_EGRESS_NETWORK_KEY
    - OCNADD_EGRESS_NETWORK_TYPE
    - ADAPTER_LOG_LEVEL_ROOT
    - ADAPTER_PREVIOUS_KAFKA_THREAD_TCP
    - CONFIG_SVC_DATASTREAM_OFFSET_RETRY
    - ADAPTER_KAFKA_CONSUMERGROUP_RETRY_DELAY_SEC
    - ADAPTER_KAFKA_CONSUMERGROUP_RETRY_COUNT
  - Added or Updated the details of the following parameters in the Storage Adapter Service Parameters section:
    - EVENT_DELETE_BATCH_SIZE
    - KAFKA_BATCH_SIZE
    - OCNADD_INTERNAL_CLIENT_SSL_HANDSHAKE_TIMEOUT
    - OCNADD_INTERNAL_CLIENT_SSL_PROTOCOL
    - OCNADD_INTERNAL_CLIENT_SSL_PROTOCOLS
    - STORAGE_ADAPTER_EVENT_ENABLED
    - STORAGE_ADAPTER_KAFKA_CONSUMER_POLL_MS
    - STORAGE_ADAPTER_KAFKA_FETCH_MAX_WAIT_MS
    - STORAGE_ADAPTER_KAFKA_FETCH_MIN_BYTES
    - STORAGE_ADAPTER_KAFKA_HEARTBEAT_INTERVAL_MS
    - STORAGE_ADAPTER_KAFKA_MAX_PARTITION_FETCH_BYTES
    - STORAGE_ADAPTER_KAFKA_MAX_POLL_INTERVAL_MS
    - STORAGE_ADAPTER_KAFKA_MAX_POLL_RECORDS
    - STORAGE_ADAPTER_KAFKA_NUM_THREADS_CONFIG
    - STORAGE_ADAPTER_KAFKA_OFFSET_CONFIG
    - STORAGE_ADAPTER_KAFKA_SESSION_TIME_OUT
    - STORAGE_ADAPTER_METRICS_ENABLED
  - Removed the following parameters from the Storage Adapter Service Parameters section:
    - BATCH_SIZE
    - CONSUMER_POLL_MS
    - FETCH_MAX_WAIT_MS
    - HEARTBEAT_INTERVAL_MS
    - KAFKA_FETCH_MIN_BYTES
    - KAFKA_MAX_PARTITIONS_FETCH_BYTES
    - KAFKA_NUMBER_THREADS_CONFIG
    - KAFKA_OFFSET_CONFIG
    - MAX_POLL_INTERVAL_MS
    - MAX_POLL_RECORDS
    - SESSION_TIME_OUT
  - Added or Updated the details of the following parameters in the Filter Service Parameters section:
    - KAFKA_DESCRIBE_TOPIC_TIMEOUT_MS
    - minReplicas
    - OCNADD_CONFIG_RETRY_COUNT
    - OCNADD_CONFIG_RETRY_DELAY_MS
    - OCNADD_FILTER_HEALTH_HB_TIMER
    - OCNADD_FILTER_HEALTH_RETRY_COUNT
    - OCNADD_FILTER_HEALTH_RETRY_DELAY
    - OCNADD_FILTER_HEALTH_SVC_TYPE
    - OCNADD_FILTER_KAFKA_TOPIC_INITIAL_DELAY
    - OCNADD_FILTER_KAFKA_TOPIC_RETRY_THRESHOLD
    - OCNADD_FILTER_LIVENESS_DELAY
    - OCNADD_FILTER_LIVENESS_FAILURE
    - OCNADD_FILTER_LIVENESS_PERIOD_SECONDS
    - OCNADD_FILTER_LIVENESS_TIMEOUT
    - OCNADD_FILTER_MAX_REPLICA
    - OCNADD_KAFKA_JAAS_SECRET_KEY
    - OCNADD_KAFKA_JASS_SECRET_NAME
    - OCNADD_KAFKA_SASL_JAAS_MODULE
    - OCNADD_KAFKA_SASL_MECHANISM
    - OCNADD_KAFKA_SECURITY_PROTOCOL_SASL
    - OCNADD_KAFKA_SECURITY_PROTOCOL_SSL
    - OCNADD_KAFKA_SSL_PROTOCOL
  - Removed the following parameters from the Filter Service Parameters section:
    - KAFKA_PRODUCER_SASL_MECHANISM
    - KAFKA_PRODUCER_SECURITY_PROTOCOL
    - KAFKA_SOCKET_BYTES_BUFFER_PORTION
Upgrade, Rollback, and Uninstall Updates:
- Updated the Supported Upgrade Paths.
- Updated the steps in Preupgrade Tasks.
- Updated the steps and scenarios in Upgrade Tasks.
- Added the details of "Migration of Kafka to Kraft Mode" in Post Upgrade Task.
- Updated the procedure and scenarios for Rolling Back OCNADD.