Performing controlled failover of SIP applications

You can take an active application out of the loop via a controlled failover.

SipContainerMBean is used to initiate a server quiesce through wsadmin (command line interface). This MBean is used to set the container’s weight to 0, which prevents new messages from being routed it.

WebSphere Application Server PMI is used to monitor the server’s active sessions. The remaining active sessions can be watched by enabling a counter on the server being quiesced. The server can be shut down once the number of active sessions reaches an acceptable level. A script can be written to monitor active sessions and shut down the server when an acceptable threshold is achieved.

Overview

Quiescing a single server

1. On an ND machine, start the wsadmin utility:

   1. Go to <nd_installation_path>/bin

   2. Run the command: ./setupCmdLine.sh

   3. Run the command: ./wsadmin.sh

   4. Verify that received: wsadmin>

2. Run the command: set scBean [$AdminControl queryNames type=SipContainerMBean,process=<server name>,*]

3. Run the command: $AdminControl invoke $scBean quiesce true

From the admin console, command line or scripts Use the following commands to stop application servers from the admin console, command line or scripts:

• Stop: Quiesces the application server. The sessions will failover to another server. It is important to manually quiesce the server on shutdown.

• Immediate Stop: Stops the server, but bypasses the normal server quiesce process that supports in-flight requests to complete before shutting down the entire server process. This shutdown mode is faster than the normal server stop processing, but some application clients can receive exceptions.

• Terminate: Deletes the application server process. Use this if immediate stop fails to stop the server.