Spectrum OneClick WebApp inaccessible even though WebTomcat is running

Products

• Spectrum
• Network Observability

Issue/Introduction

While WebTomcat runs and is on port 9443 as setup, it is not accessible, throwing the error:

Request processing failed. Please refer the tomcat log for more details.

      ..Not able to reach OneClick Webapp. Process might be stopped. Please start the Spectrum WebTomcat Process and re-launch

Environment

DX NetOps 21.2 or later Spectrum

Cause

Check for errors under all relevant logs:

$SPECROOT/webtomcat/logs/catalina.out
$SPECROOT/webtomcat/bin/logs/webswing.log

For example, problems such as the following may occur if an install or upgrade encountered issues with the following in the Webtomcat (catalina.out) log:

Exception in thread " tyrus-jdk-client-3" java.lang.IllegalStateException: java.io.FileNotFoundException: /home/CA/spectrum/webtomcat/webapps/admin/WEB-INF/lib/jakarta.ws.rs-api-2.1.6.jar (No such file or directory)

 

2022-03-29 21:51:23,957 main ERROR An exception occurred processing Appender R java.lang.IllegalStateException: java.io.FileNotFoundException: /home/CA/spectrum/webtomcat/webapps/spectrum/WEB-INF/lib/aopalliance-1.0.jar (No such file or directory)

 

Also check in the standard OneClick log (Spectrum Tomcat):

$SPECROOT/tomcat/logs/catalina.out (or stdout.log in Windows)

These will show what is causing the failure to launch. For example, if the certificate used by the OneClick server is expired or invalid, then the error will be shown in the Standard tomcat log as that is from where the WebApp (WebTomcat) is launched:

Mar 30, 2022 00:25:26.034 (https-jsse-nio-2052-exec-21) - IOException while connecting to webapp
javax.net.ssl.SSLException: Certificate Not Valid
        at sun.security.ssl.Alert.createSSLException(Alert.java:133)
...

Resolution

If the problem is missing files (such as aopalliance-1.0.jar shown in the above example), then copy the spectrum & admin web archive (*.war) files from another installation that is working to:

$SPECROOT/webtomcat/webapps/spectrum.war
$SPECROOT/webtomcat/webapps/admin.war

Then stop webtomcat and restart. Upon restart, the system will extract the working files from the above and create the spectrum & admin sub-directories under:

$SPECROOT/webtomcat/webapps

If the problem is a missing, invalid or expired certificate as per the error above, then create a new one to replace it in the keystore of the OneClick server and then restart WebTomcat.