ACC MSI Installer Always Connects Using wss:// When MID Web Server Is Configured for Unsecured ws:// Connection - Support and Troubleshooting

ACC MSI Installer Always Connects Using wss:// When MID Web Server Is Configured for Unsecured ws:// Connection .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } .kb-wrapper { font-family: 'Lato', sans-serif; font-size: 12pt; line-height: 1.7; color: #000000; max-width: 100%; } .kb-wrapper h2 { font-family: 'Lato', sans-serif; font-size: 14pt; font-weight: 900; color: #032D42; border-bottom: 2px solid #e8fce4; padding-bottom: 4px; margin-top: 24px; margin-bottom: 10px; } .kb-wrapper p, .kb-wrapper li { font-family: 'Lato', sans-serif; font-size: 12pt; line-height: 1.7; margin: 6px 0; } .kb-wrapper ul, .kb-wrapper ol { padding-left: 24px; margin: 8px 0; } .kb-wrapper a { color: #032D42; } .kb-wrapper .callout-info { border-left: 4px solid #52B8FF; background: #e6f4ff; padding: 10px 14px; margin: 12px 0; border-radius: 0 4px 4px 0; } .kb-wrapper code { font-family: 'Courier New', monospace; font-size: 11pt; background: #e6f0f5; color: #032D42; border: 1px solid #b8cfd8; border-radius: 3px; padding: 1px 5px; } .kb-wrapper pre { background: #e6f0f5; color: #032D42; border: 1px solid #b8cfd8; border-radius: 4px; padding: 12px 16px; overflow-x: auto; font-family: 'Courier New', monospace; font-size: 11pt; line-height: 1.6; margin: 10px 0; } .kb-wrapper .link-disclaimer { font-family: 'Lato', sans-serif; font-size: 10pt; font-style: italic; color: #444; margin: 2px 0 10px 0; } .kb-wrapper .related-links-list { list-style: none; padding-left: 0; } .kb-wrapper .related-links-list li { margin-bottom: 4px; }

Issue After installing the Agent Client Collector (ACC) using the MSI installer with the MID Server Web Server and WebSocket endpoints configured to use an unsecured connection ( ws:// ), the ACC agent ignores the "Not Secured" setting and continues attempting to connect using a secured WebSocket endpoint ( wss:// ).

Symptoms The MID Server Web Server and WebSocket endpoints are configured with the "Secure Connection" option unchecked ( ws:// ). After installing ACC via the MSI installer GUI and providing the MID Web Server IP address, port, and API key, the ACC service starts but fails to connect. ACC log files show the agent attempting to connect to a wss:// endpoint instead of the expected ws:// endpoint. Facts The ACC MSI installer GUI accepts three parameters: MID Web Server Name/IP, MID Web Server Port, and MID Web Server API Key. When the installer constructs the ACC endpoint from these GUI inputs, it always produces a wss:// endpoint regardless of the MID Server's "Secure Connection" setting. Specifying an unsecured ( ws:// ) endpoint via the MSI installer GUI is not a supported feature. The MSI silent installation method supports a full endpoint value via the ACC_MID parameter, which allows the complete endpoint URL — including the ws:// or wss:// scheme — to be specified explicitly. Release All Versions

Cause The ACC MSI installer GUI does not support configuring an unsecured WebSocket connection. When the endpoint is constructed from the GUI inputs (IP, port, and API key), the installer always defaults to the wss:// scheme. There is no GUI option to override this behavior.

Resolution Use the MSI silent installation method to specify the full ACC endpoint, including the ws:// scheme, via the ACC_MID parameter. The silent install command allows complete control over the endpoint URL and is the supported method for configuring an unsecured WebSocket connection.

Run the following command from the command line, replacing the placeholder values with your environment's details:

msiexec /i /quiet /qn /norestart ACC_API_KEY= ACC_MID=ws:// : /ws/events ACC_ALLOW_LIST=False — Full path to the ACC MSI installer file. — The API key configured on the MID Server Web Server. — The IP address or hostname of the MID Server. — The WebSocket port configured on the MID Server Web Server. Note: When using wss:// (secured), replace the scheme in the ACC_MID value accordingly. The same silent installation syntax applies for both secured and unsecured endpoints.

Related Links Install the Agent Client Collector on a Windows machine manually