Maintenance Mode

Overview 

Administrators may set the server into maintenance mode when undergoing or anticipating heavy maintenance on a server. Once enabled, the server login screen changes to notify any incoming users. 

Maintenance mode affects the server by:

• Blocking non-admin users from logging in.
• Blocking Worker Queue Loaders from allocating new threads (Enterprise Module).
• Ensures any running Jobs continue running until completion and prevents new Scheduled Jobs from starting.
• Assigning all servers as a Job Server pauses jobs like cleaning up old lock jobs, key rotation Flow steps, internal jobs marked for only Job Servers, Assignment escalation jobs, and scheduled jobs.

Administrators may access their maintenance mode settings from the Portal Settings.

Maintenance Mode in Clustered Environments

Maintenance Mode is not cluster-aware. It must be toggled on individually for each node.

Maintenance Mode Dashboard

Administrators can oversee all ongoing processes during maintenance mode throughout the entire server by checking the Maintenance Mode Dashboard. 

The Maintenance Mode Dashboard is located under System  > Administration > System Tools > Maintenance Mode. It contains the following sections:

Toggling Maintenance Mode

Administrators may enter/exit maintenance mode via one of two methods:

• Internally, by accessing the Maintenance Mode Dashboard.
• Externally, by changing its setting in the Setting.XML or by adding an Environment Variable.

Internal

1. Log in to the instance as an administrator account.
2. Open the Studio and navigate to System  > Administration > System Tools > Maintenance Mode to view the Maintenance Mode Dashboard.
3. Select the Turn on Maintenance Mode button at the top right of the dashboard. Select YES on the confirmation popup to enter maintenance mode.
   
   A global popup will appear at the top right of the window, notifying all users that the server will go into maintenance mode in five minutes.
4. Once initiated, the banner text changes globally to reflect the maintenance mode change.
   
5. Log out of the server to return back to the login screen. Notice the banner warning users about maintenance mode.
   
6. Log back into the instance as an administrator.
7. Return to the Maintenance Mode Dashboard. Select the Turn Off Maintenance Mode button and YES in the confirmation popup.
8. A global popup will appear at the top right of the window, stating that the server is leaving maintenance mode. Upon refreshing the browser tab, the change occurs.

External

1. Open the server's settings.xml file.
2. Locate the <MaintenanceMode> setting and change its value to either True to turn on maintenance mode or False to turn off maintenance mode. For that reason, it is set to False by default.
3. Refresh the browser tab to enter maintenance mode.

Use the following environment variable if hosted on a containerized environment.

1. Use DECISIONS_MAINTENANCEMODE=true variable to enter into the Maintenance Mode and restart the container.