Index for Section 8

Alphabetical listing for C

Bottom of page

caa_stop(8)
NAME
  caa_stop - Stops a Cluster Application Availability (CAA) application
  resource

SYNOPSIS
  /usr/sbin/caa_stop resource_name [...] [-q]

  /usr/sbin/caa_stop resource_name  [-f] [-q]

  /usr/sbin/caa_stop -c cluster_member [...] [-q]

  /usr/sbin/caa_stop -all [-q]

PARAMETER
  resource_name [...]
      Name(s) (as specified in a resource profile) of one or more resources
      to be stopped.

OPTIONS
  -c cluster_member [...]
      Specifies one or more active cluster members on which to stop all
      application resources.

  -all
      Stops all application resources on all active cluster members.

  -f  (reserved for future use)

  -q  Runs the caa_stop command in quiet mode; no messages are displayed on
      the console.

DESCRIPTION
  The caa_stop command stops the indicated application resources that are
  running in a cluster. It calls the stop entry point in the resource's
  action script.  If the stop fails, CAA marks the resource as "Suspended".
  You must run caa_stop on a suspended resource to mark its state as
  "Stopped" before you can restart it. The stop entry point of an application
  resource's action script is not called when a suspended resource is
  stopped. If a resource is marked as "Suspended" investigate why the stop
  entry point of the action script is failing.

  The caa_stop command displays progress on the command line. If there are
  troubles stopping an application, feedback will be displayed.	 If the CAA
  daemon is busy and cannot process the caa_stop request immediately, a
  message to this effect is displayed and the request is queued for
  processing once the daemon is free.  These messages also appear as events
  in the EVM event management system.

  You must have root privilege to use this command.

  After a registered resource is started, you must use the caa_stop command
  to end execution of the specified resource in the cluster environment.  You
  must not stop the resource independently of CAA.

EXAMPLES
   1.  The following example stops an application resource:
	    /usr/sbin/caa_stop xclock
	    Trying to stop `xclock` on `provolone`
	    Successfully stopped `xclock` on `provolone`

   2.  The following example stops all resources on the specified cluster
       member:
	    /usr/sbin/caa_stop -c provolone
	    Trying to stop `xclock` on `provolone`
	    Successfully stopped `xclock` on `provolone`
	    Trying to stop `calc` on `provolone`
	    Successfully stopped `calc` on `provolone`

EXIT VALUES
  The following exit values are returned:

  0   Successful completion

  non-zero
      A failure has occurred.

      A corresponding text message will be given for the following error
      conditions:

      No root privilege.

      CAA daemon is not running.

      Application is not running.

      Stop action script is not found.

SEE ALSO
  Commands: caa_profile(8), caa_register(8), caa_relocate(8), caa_start(8),
  caa_stat(1), caa_unregister(8)

  Daemon:  caad(8)

  File:	 caa(4)

  TruCluster Server Cluster Administration

Index for Section 8

Alphabetical listing for C

Top of page