Managing Maintenance Mode

Manage maintenance mode for your application using the Webscale Control Panel

Maintenance mode provides the ability to temporarily replace your application with a simple microsite in order to perform maintenance or otherwise make changes to your site. A microsite displays to inform users that the site is in maintenance mode and temporarily unavailable.

Microsites are standalone websites that display for your application. A microsite package file (also known as a microsite file) contains the files for one or more microsites. There are five microsites that can display for standard usages, including maintenance mode. For more information about microsites, see Working with Microsites.

Maintenance Web Controls are Web Controls that run during maintenance mode. Through them, Webscale executes a set of pre-defined actions. Depending on configuration, there may be conditions that must be met before the actions can execute.

There is a default maintenance Web Control that manages the microsite that displays during maintenance mode. You can optionally add, edit, and delete maintenance Web Controls.

The Maintenance web controls page enables you to define the one-page microsites that Webscale will serve by selecting the microsite files that contain these standard microsites. It also enables you to access maintenance Web Controls.

Topics

Start and stop maintenance mode

You can place your application in and out of maintenance mode through the Webscale Control Panel.

To start maintenance mode

  1. Click the three vertical dots menu icon on the upper-right corner of the application box and select Start maintenance.

    Select Start Maintenance

    -or-

    On your application page, click the Actions menu icon and select Start maintenance.

    Select Start Maintenance
  2. In the confirmation box, click Ok.

    Start maintenance mode

  3. Click Ok. A maintenance mode page displays for site users.

    Default maintenance page

To stop maintenance mode

  1. Click the three vertical dots menu icon on the upper right corner of the application box and select Stop maintenance.

    Select Stop Maintenance

    -or-

    On your application page, click the Actions menu icon and select Stop maintenance.

    Select Stop Maintenance
  2. In the confirmation box, click Ok.

    Stop maintenance mode

  3. Click Ok. The maintenance mode page no longer displays.

Automatically start and stop maintenance mode

When using Managed Deployments, you can configure any applications associated with a cluster to automatically enter and exit maintenance mode during deployments of that cluster. Do this by checking the Enable maintenance during deployments checkbox during cluster setup. In the event of a deployment failure, the application(s) will remain in maintenance mode.

Standard microsites

Following are the files names and usage of the standard microsites, which are all one-page microsites.

  • captcha.html: Displays for user challenges
  • index.html: Displays in lieu of all standard microsite files except for captcha.html
  • maintenance.html: Displays when your application is in maintenance mode
  • queued-reject.html: Displays when Webscale rejects a deferred proxy request because the proxy request queue is full
  • timeout.html: Displays when a request times out

For more information about standard microsites, see Standard microsites in Working with Microsites.

General usages

A maintenance Web Control designates and serves the maintenance mode microsite unless no maintenance Web Controls exist.

There is also a microsite package file that is selected on the Maintenance web controls page and associated with it. The microsites that this file contains determine the pages that automatically display for rejected queued proxy requests and timeouts. If there is a request Web Control with the Challenge user action, it uses the captcha microsite for the file. If the microsite file does not include a captcha.html file, the default Webscale captcha displays.

If there are no maintenance Web Controls, Webscale uses a microsite from the microsite file selected on the page as the maintenance mode page.

For more information on captcha microsites, see Captcha pages in Working with Microsites. For more information on creating a request Web Control with the Challenge User action, see Protecting Your Site with a Captcha.

Access the Maintenance web controls page

After you access the Maintenance web controls page, you can work with the microsite file associated with the page and maintenance Web Controls.

To access the Maintenance web controls page

  1. Click the three vertical dots menu icon on the upper-right corner of the application box and select Edit.

    Select edit application

    -or-

    On your application page, click the Actions menu icon and select Edit.

    Select edit application
  2. On the sidebar menu, click Maintenance. The Maintenance web controls page displays.

    Access Maintenance web controls page

Default microsite file

Webscale provides a microsite default file that contains the standard microsite files. (Though the microsite file names are different for this default microsite file, the same microsite displays for maintenance mode, rejected queued requests, and timeouts.)

Initially, the default file is selected for the Maintenance web controls page and default maintenance Web Control. You can replace the default microsite file with another uploaded microsite file. The microsite files for the page and maintenance Web Control can be different.

Replace the associated microsite file

You can replace the microsite file selected for the Maintenance web controls page, which might be the default microsite file, with a new uploaded file. The new file can contain microsites that are specific to each condition and customized for your business. For instance, the timeout microsite could include wording referencing a timeout and your branding.

A microsite file might have only one HTML file. If it is named index.html and located at the root directory of the package file, the single file will display for both rejected queued proxy requests and timeouts. If you use it for a maintenance Web Control to serve as the maintenance mode page, or there are no maintenance Web Controls, the index file microsite will function as the maintenance mode page.

To replace a microsite file

  1. In the Maintenance web controls page, select the new microsite file from the Microsite drop-down menu.

    Select microsite file
  2. To preview a microsite that the microsite file contains:
    a. Click Preview.
    b. In the preview dialog box, select the microsite from the microsite file drop-down menu.

    Preview microsite file

    c. Click Close to return to the Maintenance web controls page.

  3. Click Apply.

    Apply replacement microsite file

Maintenance Web Controls

Web Controls consist of configured rule sets that match individual request conditions. Based on the conditions, Web Controls automatically execute a set of pre-defined actions. When one or more specified conditions are met, Webscale applies all configured actions to the request.

The maintenance Web Controls only operate during maintenance mode. Just as with other types of Web Controls, you can edit conditions and actions and add and delete these Web Controls.

If you have more than one maintenance mode web control, they behave the same way that multiple request web controls do. This includes the order in which actions execute.

The primary purpose of maintenance Web Controls is to serve the maintenance mode page during maintenance mode.

For more information on creating Web Control conditions and actions, see Creating Web Controls. For information on working with more than one Web Control, see Managing Web Controls.

Default maintenance Web Control

The default maintenance Web Control has the following pre-configured actions.

  • Set response header: Response header will be set to: Pragma: no-cache

  • Set response header: Response header will be set to: Cache-Control: private, no-cache

  • Serve (final): Request will be served with microsite resource Default Microsite with a status code of 503 specified at path maintenance.html

    Default maintenance Web Control

Until you change these settings or delete the default maintenance Web Control, whenever you put your site into maintenance mode, Webscale executes the above actions in the following way.

  • Sends responses with headers that instruct browsers to not cache the maintenance mode page
  • Displays the maintenance mode page from the specified microsite file with the HTTP 503 status code (service unavailable). As the final action, these steps will always take place after all other maintenance Web Controls actions run.

For more information on HTTP request headers and status codes, see HTTP Headers and Status Codes.

Edit maintenance Web Controls

When you edit a maintenance Web Control, you can modify its name, descriptions, and its conditions and actions. You can also add new conditions and actions.

You can choose for Webscale to display a different maintenance mode page than the default one when editing the maintenance Web Control that serves this page.

To edit a maintenance Web Control

  1. In the Maintenance web controls page, click the icon for the maintenance Web Control.

    Select maintenance Web Control
  2. Click the Edit icon.

    Click the Edit icon
  3. In the sections for configuring maintenance Web Controls that display under the Edit maintenance web control heading, optionally, replace the name and description of the maintenance Web Control.

    Edit maintenance web controls sections
  4. To add a condition:
    a. Select click Add a condition.
    b. In the condition drop-down menu, select a condition. The settings for the condition display.

    Edit maintenance web controls sections

    c. Configure the condition, using your setting information.
    d. Click Done.

    Add maintenance Web Control condition

    e. Click the Done button that is located to the right of the Edit maintenance web control heading.

    Click Done

    f. Click Apply.

    Click Apply
  5. To edit a condition:
    a. Click the Edit icon for the condition.

    Click Edit

    b. Modify the setting.
    c. Click Done.

    Click Done

    d. Click the Done button that is located to the right of the Edit maintenance web control heading.

    Click Done

    e. Click Apply.

    Click Apply
  6. To delete a condition:
    a. Click the X icon for the condition. The condition entry no longer displays.

    Click x icon to delete

    b. Click the Done button that is located to the right of the Edit maintenance web control heading.

    Click Done

    c. Click Apply.

    Click Apply
  7. To add an action:
    a. Click Add action.
    b. In the Type drop-down menu, select an action. The settings for the action display.

    Select action

    c. Configure the action, using your setting information.
    d. Click Done.

    Click Done

    e. Click the Done button that is located to the right of the Edit maintenance web control heading.

    Click Done

    f. Click Apply.

    Click Apply
  8. To edit an action:
    a. Click the Edit icon for the action.

    Click Edit

    b. Modify the setting.
    c. Click Done.

    Click Done

    d. Click the Done button that is located to the right of the Edit maintenance web control heading.

    Click Done

    e. Click Apply.

    Click Done
  9. To delete an action:
    a. Click the X icon for the action. The action entry no longer displays.

    Delete maintenance web controls action

    b. Click the Done button that is located to the right of the Edit maintenance web control heading.

    Click Done

    c. Click Apply.

    Click Apply
  10. When you have finished editing the maintenance Web Control, click the Done button that is located to the right of the Edit maintenance web control heading.

    Click Done
  11. Select the Enabled checkbox to enable the maintenance Web Control if it is not already enabled.

  12. Click Apply.

    Click Apply

Add maintenance Web Controls

You might want to create a maintenance Web Control to configure a series of conditions and actions to occur in addition to preventing site usage and displaying the maintenance mode page.

For instance, a new maintenance Web Control condition could provide site access for specific internal users.

To add a maintenance Web Control

  1. In the Maintenance web controls page, click Add a maintenance control.
  2. Enter a name for the maintenance Web Control.
  3. Optionally, enter a description.
  4. To add a condition:
    a. Click Add a condition.
    b. In the condition drop-down menu, select a condition. The settings for the condition display.
    c. Configure the condition, using your setting information.
    d. Click Done.
  5. To add an action:
    a. Click Add action.
    b. In the Type drop-down menu, select an action. The settings for the action display.
    c. Configure the action, using your setting information.
    d. Click Done.
  6. When you have finished configuring the maintenance Web Control, click the Done button that is located to the right of the Edit maintenance web control heading.
  7. Select the Enabled checkbox.
  8. Click Apply.

Delete maintenance Web Controls

If you delete all maintenance Web Controls, Webscale will use the maintenance.html file for the microsite file that is selected on the Maintenance web controls page. Or, if there is no maintenance.html file, it will use the index.html file.

To delete a maintenance Web Control

  1. In the Maintenance web controls page, click the icon for the maintenance Web Control to delete.
  2. Click the X icon for the maintenance Web Control.
  3. In the confirmation box, click Ok.
  4. Click Apply. The maintenance Web Control no longer displays.

Further reading

Have questions not answered here? Please Contact Support to get more help.


Last modified October 10, 2021