Webapp fails to load after upgrading spectrum due to antivirus block

Products

• Network Observability
• Spectrum

Issue/Introduction

The OneClick WebApp page fails to load after upgrading Spectrum from version 24․3․x to version 25․4․x․​​​​​‌‍

webtomcat/logs/stdout.log

ERROR [Webswing Process Handler] (SwingProcessImpl.java:196)
Uncaught exception.
ERROR [Webswing Process Handler] (SwingProcessImpl.java:196)
java.lang.Exception: Unexpected error.
at main.Main.init(Main.java:144)
at main.Main.main(Main.java:43)
Caused by: java.lang.ClassNotFoundException: org.webswing.SwingMain
at java.base/java.net.URLClassLoader.findClass(Unknown Source)
at java.base/java.lang.ClassLoader.loadClass(Unknown Source)
at main.Main.init(Main.java:134)

Environment

Spectrum 25.4.x

Cause

• Spectrum version 25․2․4+ upgrades the embedded Webswing framework from 25․1․4 to 25․2․4, introducing webswing-app-launcher-25․2․4․jar containing the org․webswing․SwingMain entry point class․
• Local antivirus security software flags this new JAR file as malicious, continuously deleting or blocking it, which prevents Webswing from loading sessions or generating required runtime deployment files․

Resolution

1․ CONFIGURE ANTIVIRUS EXCLUSIONS: Configure the local security or antivirus software to allow the file webswing-app-launcher-25․2․4․jar and exclude Spectrum directories from real-time scanning rule flags․

EXPECTED: The antivirus software stops deleting or blocking the framework JAR file․

2. Delete $SPECROOT/webtomcat/webapps/spectrum folder

3. Restart Spectrum webtomcat which will rebuild the complete spectrum folder (including webswing-app-launcher-25․2․4․jar from spectrum.war)