After configuring SSL on OneClick WebApp hangs at "Starting your application"

Products

• Network Observability
• Spectrum

Issue/Introduction

After installing Spectrum OneClick we configured SSL for HTTPS following the documentation.

After doing so the OneClick administration website works fine but launching WebApp fails. It hangs at the "Starting your application" message box.

There aren't clear errors found appearing in the $SPECROOT/webtomcat/logs/catalina.out when reproducing the issue.

Environment

All supported Network Observability DX NetOps Spectrum OneClick web server releases

Cause

Misconfigured $SPECROOT/webtomcat/bin/webswing-admin.properties and $SPECROOT/webtomcat/bin/webswing.config files.

Resolution

To resolve this issue take the following steps.

1. Stop the webtomcat web server services.
   • Run "ps -ef | grep webtomcat" to confirm all services for it are down.
2. Open the $SPECROOT/webtomcat/bin/webswing-admin.properties file for editing.
   • Add a section as follows to the bottom of the file.
   • Default values are shown. Ensure:
     • The trustore file path is set to the correct value.
     • The trustore.password is set to the correct value.

   • # set the file names of audit and webswing log files, only if you changed the default log file names in log4j2.xml
     #webswing.log.file.audit=audit.log
     #webswing.log.file.server=webswing.log
     webswing.server.websocket.truststore.type = JKS
     webswing.server.websocket.truststore = ../../custom/keystore/cacerts
     webswing.server.websocket.truststore.password = changeit
     webswing.server.websocket.hostnameVerifier.disabled = true

   • Save the changes to the file when done editing.
3. Open the $SPECROOT/webtomcat/bin/webswing.config file for editing.
   • Ensure the adminConsoleUrl scheme is set to https.
   • Save the changes to the file when done editing.
4. Start the webtomcat web server services.