Quiesce servers or services for maintenance windows

To remove a server or service from the Load Balancer configuration for any reason (updates, upgrades, service, etc.), you can use the dscontrol(or cbrcontrol) manager quiesce command. You cannot use quiesce in the Site Selector component.

About this task

The quiesce subcommand allows existing connections to complete without being severed and disallows any new connections to a server or service. You can quiesce servers on a scheduled time to perform upgrades or general maintenance. The daily option specifies to quiesce the server at a time that you specify.

When you want to bring down a particular service on a server, like HTTP, you can quiesce individual daemons. If you have added server1 to port 80 and port 22 of a cluster, for example, the usual quiesce command will stop forwarding traffic to server1 on port 80 and port 22. This option allows you to stop traffic only on port 80 if you need to stop that particular service.

Tip: You can use similar steps for quiescing the server for the CBR component.

Procedure

  • Quiesce a server or individual service daemon immediately.
    1. Quiesce a server.
      Use the following command:
      dscontrol manager quiesce server
      The following is an example of using the option to quiesce server 9.40.25.67:
      dscontrol manager quiesce 9.40.25.67
    2. Quiesce a service.
      Use the following command:
      dscontrol manager quiesce cluster@port@server
      The following is an example of using the option to quiesce the HTTP service on server 9.40.25.67, which is on cluster1:
      dscontrol manager quiesce cluster1@80@9.40.25.67
      If you use this command in conjunction with a command to quiesce a server, the commands will act together. For example:
      • If you quiesce server1 with the dscontrol manager quiesce server command, you can unquiesce a specific service by using the following command:
        dscontrol manager unquiesce cluster@port@server
        This command will unquiesce that particular port for service, but all other ports will remained quiesced.
      • If you quiesce an individual service by using the dscontrol manager quiesce cluster@port@server command, you will unquiesce all services on the server if you use the following command:
        dscontrol manager unquiesce server
        This will ignore settings that you have configured for individual services.
  • Quiesce a server on a daily schedule.
    Use the following command:
    dscontrol manager quiesce server daily start_hour end_hour
    Note:
    • Start hour and end hour are values from 0 to 24. For example, (1 2) indicates to quiesce the server from 1:00 AM to 2:00 AM. (12 13) indicates to quiesce the server from 12:00 PM to 1:00 PM, which is 1 hour.
    • Specify (-1 -1) to disable the daily quiesce for a particular server.
    The following is an example of using the daily option to quiesce server 9.40.25.67 from 2:00 AM to 5:00 AM:
    dscontrol manager quiesce 9.40.25.67 daily 2 5