member softstop command

The member softstop command stops one or all of the members that are running on a node into which you are logged. The command waits for all of the processes to finish running.

Usage notes

On a running member, the command refuses new service requests and quiesces already running services, then stops the services and the member.

This command can only be used on a member that is running and that has at least one HTTPServer or Fabric Receiver service running.

If the member is running and there are no HTTPServer or Fabric Receiver services running, this command stops the member immediately. If a member is running and there is at least one HTTPServer or Fabric Receiver service running, the command:

  1. Submits a quiesce request to the service
  2. Waits for the service to quiesce
  3. Stops the service
  4. Stops the member.

If a timeout is specified, the command either waits for the services to complete or for the timeout to expire, which ever comes first, then stops the services and the member. Processes that are still running when the timeout is reached are stopped at that time.

If your installation has at least two catalog members, and you stop all of your catalog members, you must restart at least two catalog members before the data grid is available. If you stop all of your catalog members except one, the data grid is still available.

This command also stops the heartbeat process, which periodically checks if members are still active. The heartbeat process stops when all members are stopped. The heartbeat process is started by the member start command.

Environment

  • Windows 2008
  • Linux®

Authorization

Administrative user

Syntax

execute member softstop <member type> [timeout (min)]

Option descriptions

member type
One of the four member types:
  • catalog
  • container
  • operational
  • informational
timeout (min)
The amount of time, in minutes, between when the command is entered and when the member is stopped. If no time is specified the command defaults to either 1 day (1440 minutes) or to the timeout defined by the SoftStopTimeout=<timeout in minutes> property set in the system properties file.

Examples

Example: Stopping a particular member after a specified wait time.
This command stops an operational member after a wait of 30 minutes if the operational member is running and has services which can be quiesced and stopped:
execute member softstop operational 30