Portal is unavailable after upgrading to 25.4.6

Products

• Network Observability

Issue/Introduction

Upgraded Portal from 25.4.5 to 25.4.6

Although services are running , the Portal is not reachable

PCService.log and SSOService.log files do not show any updates

wrapper.log shows the following error

INFO   | jvm 1    | 2026/03/25 10:55:51 | java.lang.ExceptionInInitializerError

INFO   | jvm 1    | 2026/03/25 10:55:51 | Caused by:

INFO   | jvm 1    | 2026/03/25 10:55:51 | org.apache.logging.log4j.core.config.ConfigurationException: No type attribute provided for component appender

Cause

The upgrade to DX NetOps 25.4.6 includes an update of the log4j2 library to version 2.25.0+. This newer version requires all appenders defined in the appenders list to be explicitly declared, otherwise the Portal fails to initialize with a ConfigurationException: No type attribute provided for component appender.

Resolution

 

• Access the Portal Server: Log in to the DX NetOps Portal server.
• cd to /opt/CA/PerformanceCenter/PC/resources
• Check the Portal log4j2.properties for missing appenders line entries.  Run this in your terminal (replacing log4j2.properties with the path to your file):
  Bash

  comm -13 <(grep -E "^[ \t]*appenders[ \t]*=" log4j2.properties | cut -d= -f2- | tr ',' '\n' | tr -d ' \r\\' | sort -u) <(grep -E "^[ \t]*appender\." log4j2.properties | cut -d. -f2 | sort -u)

  This will output any entries missing from the appenders line.
• Edit PC Configuration: Open /opt/CA/PerformanceCenter/PC/resources/log4j2.properties (or your specific install path).
• Modify PC Appenders: Locate the line starting with appenders = and update it as follows if any found:
  • From: appenders = A1, application-timesize
  • To: appenders = A1, application-timesize, <missing appender(s) in comma separated list

                    For example, if the "comm -13 ..." line above returns "kafka-logs", update the "appenders" line to say:

                   appenders = A1, application-timesize, kafka-logs

 

• cd /opt/ca/PerformanceCenter/sso/resources
• Check the Portal log4j2.properties for missing appenders line entries.  Run this in your terminal (replacing log4j2.properties with the path to your file):
  Bash

  comm -13 <(grep -E "^[ \t]*appenders[ \t]*=" log4j2.properties | cut -d= -f2- | tr ',' '\n' | tr -d ' \r\\' | sort -u) <(grep -E "^[ \t]*appender\." log4j2.properties | cut -d. -f2 | sort -u)

• Edit SSO Configuration: Open /opt/CA/PerformanceCenter/sso/resources/log4j2.properties if any found
• Modify SSO Appenders: Locate the line starting with appenders = and update it:
  • From: appenders = A1, application-timesize
  • To: appenders = A1, application-timesize, <missing appender(s) in comma separated list>

                    For example, if the "comm -13 ..." line above returns "kafka-logs", update the "appenders" line to say:

                   appenders = A1, application-timesize, kafka-logs

 

• Restart Services: Restart the DX NetOps Portal services (except mysql) to apply the changes.