↓ Skip to main content
Milan’s Blog
Milan’s Blog

HCL Connections Desktop Plug-ins for Windows - Maintenance Mode

·695 words·4 mins· loading · loading ·
Table of Contents

With the HCL Connections Desktop Plug-ins for Windows Version 26.08 update, we got a handy new feature.

First, the plug-in will alert users only once if it detects that HCL Connections is offline. Previously, users would get continuous alerts via pop-ups until HCL Connections was reachable again.

Second, we now have the ability to activate the “maintenance mode” for the HCL Connections Desktop Plug-ins, which will tell the plug-in not to alert the users at all.

Activate the Maintenance Mode
#

The HCL Connections Desktop Plug-in will activate the maintenance mode when it detects the 503 or 540 HTTP status code for an HTTP POST request method, which looks like the following:

# Result Protocol Host URL Body Caching Content-Type Process Comments Custom
223 503 HTTPS connections.domain.com /push/basic/comet/handshake 19 application/octet-stream lfmonitor:12376

Therefore, you have to modify the configuration of the web server the HCL Connections Desktop Plug-ins for Windows are accessing to generate the appropriate response.

Verify
#

The curl command can be very helpful during testing. For example:

curl -X POST -I https://connections.domain.com/push/basic/comet/handshake

Response:

HTTP/2 503
server: nginx/1.14.1
date: Mon, 14 Sep 2026 17:34:20 GMT
content-type: application/octet-stream
content-length: 19

After the appropriate HTTP response has been caught by the plug-ins, the following log messages will be generated in the HCL Connections Desktop Plug-ins for Windows, and it will enter “maintenance mode”:

[2026-09-15 08:00:32.141] [LFMonitor] [ 6888] [ info] LFT::cmd2: http-post=503
[2026-09-15 08:00:32.141] [LFMonitor] [ 6888] [debug] LFTransport::callCommand http error in the 500s, may need an ip stack reset. reset and retry. 
[2026-09-15 08:00:32.141] [LFMonitor] [ 6888] [debug] LFTransport::callCommanderrorcode: 503
[2026-09-15 08:00:32.141] [LFMonitor] [ 6888] [debug] LFTransport::callCommanderrorMsg: Service Unavailable
[2026-09-15 08:00:32.141] [LFMonitor] [ 6888] [debug] LFTransport::callCommandurl: basic/comet/connect
[2026-09-15 08:00:32.141] [LFMonitor] [ 6888] [debug] LFTransport::callCommandcommandxml[{"channel":"/meta/connect","connectionType":"long-polling","advice":{"timeout":100000},"id":"7","clientId":"2kk1m52k8903j1nbnknlg6pz6k"}]
[2026-09-15 08:00:32.141] [LFMonitor] [ 6888] [debug] LFTransport::callCommandheaders: 
[2026-09-15 08:00:32.141] [LFMonitor] [ 6888] [debug] Cache-Control: no-cache
[2026-09-15 08:00:32.141] [LFMonitor] [ 6888] [debug] Pragma: no-cache
[2026-09-15 08:00:32.141] [LFMonitor] [ 6888] [debug] 
[2026-09-15 08:00:32.141] [LFMonitor] [ 6888] [debug] Cookie: BAYEUX_BROWSER=ea761mioxnifn16f9mu29cwiy1aba;LtpaToken=X6rZN/P035pgji1k7hYkRTTEW26fALQ5IrSK7Mj5H4XsyhoJMfVHlNVaZ4oFG//0izsKvItCDuYgn4TQhPxc/zszb2jO61xGW83uYgtVNPW5PfdG2wEsGBnQBDmvdnhGWRvoZixrZV+g5Uj733OlohgXovEoNrq4UPahFLRiByhT7SrwifbtzArpBR5eYThNDWhi
[2026-09-15 08:00:32.141] [LFMonitor] [ 6888] [debug] Accept-Language: en
[2026-09-15 08:00:32.141] [LFMonitor] [ 6888] [debug] Content-Type: application/json;charset=UTF-8
[2026-09-15 08:00:32.141] [LFMonitor] [ 6888] [debug] Authorization: Basic  
[2026-09-15 08:00:32.141] [LFMonitor] [ 6888] [debug] LFTransport::resetSession resetting HTTPSession 
[2026-09-15 08:00:32.141] [LFMonitor] [ 6888] [ info] LFT::cmd2: 503
[2026-09-15 08:00:32.141] [LFMonitor] [ 6888] [ info] LFT::cmd2: https://connections.domain.com/push/basic/comet/connect
[2026-09-15 08:00:32.142] [LFMonitor] [ 6888] [ info] LFTransport::sendRequestExsend timeout set to: 130 seconds
[2026-09-15 08:00:32.142] [LFMonitor] [ 6888] [ info] LFT::cmd2: http-post=503
[2026-09-15 08:00:32.142] [LFMonitor] [ 6888] [debug] LFTransport::callCommand http error in the 500s, already retried so just return the error
[2026-09-15 08:00:32.142] [LFMonitor] [ 6888] [debug] LFTransport::callCommanderrorcode: 503
[2026-09-15 08:00:32.142] [LFMonitor] [ 6888] [debug] LFTransport::callCommanderrorMsg: Service Unavailable
[2026-09-15 08:00:32.142] [LFMonitor] [ 6888] [debug] LFTransport::callCommandurl: basic/comet/connect
[2026-09-15 08:00:32.142] [LFMonitor] [ 6888] [debug] LFTransport::callCommandcommandxml[{"channel":"/meta/connect","connectionType":"long-polling","advice":{"timeout":100000},"id":"7","clientId":"2kk1m52k8903j1nbnknlg6pz6k"}]
[2026-09-15 08:00:32.142] [LFMonitor] [ 6888] [debug] LFTransport::callCommandheaders: 
[2026-09-15 08:00:32.142] [LFMonitor] [ 6888] [debug] Cache-Control: no-cache
[2026-09-15 08:00:32.142] [LFMonitor] [ 6888] [debug] Pragma: no-cache
[2026-09-15 08:00:32.142] [LFMonitor] [ 6888] [debug] 
[2026-09-15 08:00:32.142] [LFMonitor] [ 6888] [debug] Cookie: BAYEUX_BROWSER=ea761mioxnifn16f9mu29cwiy1aba;LtpaToken=X6rZN/P035pgji1k7hYkRTTEW26fALQ5IrSK7Mj5H4XsyhoJMfVHlNVaZ4oFG//0izsKvItCDuYgn4TQhPxc/zszb2jO61xGW83uYgtVNPW5PfdG2wEsGBnQBDmvdnhGWRvoZixrZV+g5Uj733OlohgXovEoNrq4UPahFLRiByhT7SrwifbtzArpBR5eYThNDWhi
[2026-09-15 08:00:32.142] [LFMonitor] [ 6888] [debug] Accept-Language: en
[2026-09-15 08:00:32.142] [LFMonitor] [ 6888] [debug] Content-Type: application/json;charset=UTF-8
[2026-09-15 08:00:32.142] [LFMonitor] [ 6888] [debug] Authorization: Basic  
[2026-09-15 08:00:32.142] [LFMonitor] [ 6888] [ info] LFT::cmd2: 503
[2026-09-15 08:00:32.150] [LFMonitor] [ 6888] [debug] Fatal error at file appE, line 1, char 1
[2026-09-15 08:00:32.150] [LFMonitor] [ 6888] [debug]   Message: invalid document structure
[2026-09-15 08:00:32.153] [LFMonitor] [ 6888] [debug] LFBayeuxServer::Connect (503) 
[2026-09-15 08:00:32.153] [LFMonitor] [ 6888] [debug] CBayeuxMon::mainThread error 503 from Connect for server My Drive on WYDucks64
[2026-09-15 08:00:32.154] [LFMonitor] [ 6888] [ info] CBayeuxMon::handleBayeuxErrors 503/540 error received, possible maintenance window.  Increasing polling timer.  error: 503 serverid: 1
[2026-09-15 08:00:32.154] [LFMonitor] [ 6888] [debug] CSyncMon::increasePollingTimer for server (1) now set to 60 seconds
[2026-09-15 08:00:32.155] [LFMonitor] [ 9372] [debug] SDDriveConflictData::getActionConflictCount:  count is  0
[2026-09-15 08:00:32.155] [LFMonitor] [11152] [ info] ActionSet::oldestActions: Found 0 actions ready to process
[2026-09-15 08:00:32.155] [LFMonitor] [11152] [ info] ActionSet::oldestActions: Found 0 actions ready to process
[2026-09-15 08:00:32.155] [LFMonitor] [ 8160] [debug] SDDriveConflictData::getActionConflictCount:  count is  0
[2026-09-15 08:00:32.156] [LFMonitor] [ 6888] [debug] CBayeuxMon::handleBayeuxErrors server My Drive on WYDucks64 is unavailable. We've already warned user, don't popup again

As long as the web server generates the HTTP response specified above, the users will not be notified of the plug-ins’ inability to access HCL Connections applications.