Unable to enable Spectrum Data source within NetOps Portal after upgrading to 24.3.13

Products

• Network Observability

Issue/Introduction

After upgrading DX NetOps Spectrum from version 23.3.9 to 24.3.13, the Spectrum Data Source cannot be enabled within the NetOps Portal. During startup, the Spectrum OneClick Tomcat server fails to initialize correctly. The following error shows up within NetOps portal

The Tomcat logs (stdout.log or catalina.out) show errors related to the NetOps Portal integration, including a ClassNotFoundException and a NullPointerException. Key errors in the log include:

nested exception is java.lang.ClassNotFoundException: com.ca.im.netqos.integration.deploy.NetqosAxis2WebserviceDeployer

and

java.lang.NullPointerException: Cannot invoke "com.ca.im.netqos.integration.NetqosIntegrationBeanManager.getProductSync2WS()" because the return value of "com.ca.im.netqos.integration.NetqosIntegrationBeanManager.getInstance()" is null

 

Environment

DX NetOps Spectrum 24.3.9

Cause

The issue is caused by the presence of multiple or incorrectly named configuration files within the Tomcat webapps directory for the Spectrum/NetOps Portal integration. During startup, Tomcat attempts to load the configuration from this location, but the presence of old, backup, or misspelled files (e.g., netqos-integration-application-config.xm instead of .xml) causes the context to fail to load, leading to the exceptions.

Resolution

To resolve this issue, you must clean up the configuration directory to ensure only the single, correct file is present.

1. Stop the Spectrum Tomcat service.
2. Navigate to the following directory on the OneClick server:
   <SPECROOT>/tomcat/webapps/spectrum/WEB-INF/netqos/config/container/
3. Inspect the contents of this directory. Look for multiple files with similar names, specifically:
   • netqos-integration-application-config.xml
   • Files with old timestamps that may be backups.
   • Files with incorrect extensions, such as netqos-integration-application-config.xm.
4. Move any old or incorrectly named files out of this directory to a temporary backup location.
5. Ensure that only one file, the correct and most recent one, is present and is named exactly netqos-integration-application-config.xml.
6. Start the Spectrum Tomcat service. The server should now initialize correctly.