Index Index for
Section 8
Index Alphabetical
listing for C
Bottom of page Bottom of
page		 

caa_stop(8)


NAME

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


SYNOPSIS

  /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  Forces termination of the indicated application resources and all
      application resources dependent on the specified resources.  This
      option is useful to stop all application resources when the caa_stop
      command fails because of application resources dependent on the
      specified resource or if the application is in the "UNKNOWN" state
      because of an unsuccessful stop entry point execution. This option
      makes caa_stop ignore any errors that are reported by the stop entry
      point of an action script.

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


DESCRIPTION

  The caa_stop command sets the application resource target state to OFFLINE
  and attempts to stop specified registered application resources.  The
  caa_stop command causes the stop entry point in the resource's action
  script to be executed. If the stop fails, CAA marks the resource as
  "UNKNOWN". You must run caa_stop or caa_stop -f on a resource in this state
  to mark its state as "OFFLINE" before you can restart it. If a resource is
  marked as "UNKNOWN" 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.	 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.


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 Index for
Section 8
Index Alphabetical
listing for C
Top of page Top of
page