Error "Failed to connect websocket" in Spectrum OneClick

Products

• Network Observability
• Spectrum

Issue/Introduction

When you install a new OneClick server, the web application fails to connect․​​​‌​‍The system successfully listens on the designated port, but the interface remains inaccessible

ERROR MESSAGE: "Failed to connect websocket to server [ws://[IPAddress]:9443/spectrum]! Failed to connect to websocket"

SYMPTOMS:

• Web application does not load

• Websocket connection failures appear in the catalina․out log

CONTEXT: Occurs after a new server installation with HTTPS configured․

IMPACT: Users cannot access the OneClick web interface․

Environment

Spectrum  
OneClick HTTPS Port 8443 and Port 9443 enabled

Cause

The websocket URL in the properties file is configured for HTTP (ws) while the server is configured for HTTPS, causing the connection to be rejected

Resolution

PREREQUISITES:

• Administrator access to the OneClick server file system

STEPS:

Step 1․ UPDATE WEBSWING PROPERTIES

Path: $SPECROOT/webtomcat/bin/webswing.properties

Update the websocket URL to use secure websockets (wss) instead of standard websockets (ws)․

Change from: webswing․server․websocketUrl = ws://[IPAddress]:9443/spectrum Change to: webswing․server․websocketUrl = wss://[IPAddress]:9443/spectrum

EXPECTED: The URL accurately reflects the HTTPS configuration․ NOTE: Ensure the IP address matches your specific server configuration․

 

VERIFY SUCCESS:

• Web application connects successfully

• No websocket errors appear in the catalina․out log