20.57. kb-00056: Troubleshooting Portal WebSockets¶
20.57.1. Knowledge Base Article: kb-00056¶
Occasionally the RackN Portal will have connectivity issues due to the self-signed certificates expiring.
When the socket loses connection, a megaphone icon button on the top left will flash red and say “Unable to access DRP”
Clicking this icon will yield the error code and status.
See additional information for a list of error codes.
The most common and hard to troubleshoot issue is the 1006 - CLOSE_ABNORMAL error. This usually happens when the browser does not show the accept certificate page when the websocket is getting TLS errors.
The easiest fix is to completely close and re-open the browser so the accept certificate dialog can be shown.
20.57.4. Additional Information¶
List of RFC6455 Web Socket status codes, most of which are never seen or are not used:
CLOSE_NORMAL- Normal closure
CLOSE_GOING_AWAY- Server goes down or webpage is navigated away from
CLOSE_PROTOCOL_ERROR- Endpoint terminates connection due to protocol error
CLOSE_UNSUPPORTED- DRP or UX sends unsupported data (binary instead of text)
CLOSED_NO_STATUS- Should never get this, it means no status code was provided
CLOSE_ABNORMAL- Socket closed without a close control frame - likely due to TLS errors
Unsupported payload- Sending non-UTC-8 data
Policy violation- Should never get this, it means the message violates policy
CLOSE_TOO_LARGE- Happens when a message is too long, the portal should automatically reconnect
Mandatory extension- Not implemented
Server error- Server crashed
Service restart- Server is restarting
Try again later- Not implemented
Bad gateway- Not implemented
TLS handshake fail- Server certificate cannot be verified
220.127.116.11. See Also¶
This document applies to all versions of Digital Rebar and RackN Portal v1.18+
ux, portal, websocket, socket, tls, certificate, browser, faq, abnormal, close_abnormal, close
18.104.22.168. Revision Information¶
KB Article : kb-00056 initial release: Wed Jan 27 11:32:17 CST 2021 updated release: Wed Jan 27 11:32:17 CST 2021