Enabling maintenance mode in Admin Center

You can use the Explore tool to enable maintenance mode for a server or host. Enable maintenance mode before you perform diagnostic tests, maintenance, or tuning on a server joined to a collective or on a host registered to a collective. Maintenance mode can prevent the disruption of client requests by routing client traffic targeted for a server that is in maintenance mode to another server. Enabling maintenance mode is a persistent change; a server or host remains in maintenance mode until the mode is disabled.

About this task

The following steps describe how to enable or disable maintenance mode:

For more information about maintenance mode, see Entering maintenance mode for Liberty collectives.

Procedure

  • Enable maintenance mode for a server or host.
    1. Open the Explore tool on Servers or Hosts.
      1. From the Toolbox, select Explore Explore icon.
      2. From the Dashboard, select the Servers or Hosts panel.
    2. When viewing Servers or Hosts, select Actions Actions icon for a resource for a resource and then select Enable Maintenance Mode from the popup dialog.

      Or, select Actions Actions icon > one_or_more_servers_or_hosts > Enable Maintenance Mode. For example, to enable maintenance mode on two hosts:

      1. When viewing Hosts, select Actions Actions icon.
      2. Select two registered hosts that are not in maintenance mode.
      3. Select the More button.
      4. Select the Enable Maintenance Mode button.
      Select the Enable Maintenance Mode button in the Explore tool Hosts view

      Enabling maintenance mode on a server might require additional selections:

      • If an Enable maintenance mode prompt is displayed, select whether to break affinity with active sessions and then select Enable. By default, a web server continues to send requests with affinity to a server in maintenance mode. Selecting the Break affinity with active sessions toggle causes requests with affinity to a server to be routed to other servers.
      • If a server has an enabled scaling policy Auto scaling icon and a Maintenance mode cannot be enabled prompt is displayed, select Force or Cancel. When a scaling member is placed into maintenance mode, the scaling controller starts another server to replace the scaling member that is in maintenance mode if another server is needed to meet the scaling policy minimum or to meet current workload demand. If the scaling controller cannot find a server to replace the scaling member, the Maintenance mode cannot be enabled prompt is displayed. Selecting Force enables maintenance mode for the scaling member without starting alternate servers, which can break auto scaling policies. Selecting Cancel does not enable maintenance mode for the scaling member.

        When the maintenance mode is enabled on a scaling member, the scaling policy is disabled automatically:

        After maintenance mode is enabled, the auto scaling policy is disabled for the scaling member

      When maintenance mode is enabled on a host, the product attempts to place all servers on the host into maintenance mode, with the host entering maintenance mode regardless of whether its servers do. After a host is in maintenance mode, a scaling controller cannot provision new servers on the host.

  • Disable maintenance mode for a server or host.

    When viewing Servers or Hosts in the Explore tool, select Actions Actions icon for a resource for a resource in maintenance mode and then select Disable Maintenance Mode from the popup dialog.

    Or, select Actions Actions icon > one_or_more_servers_or_hosts > Disable Maintenance Mode.