 |
Index for
Section 1 |
|
 |
Alphabetical
listing for C |
|
 |
Bottom of
page |
|
caa_stat(1)
NAME
caa_stat - Provides status on Cluster Application Availability (CAA)
resources within a cluster.
SYNOPSIS
/usr/bin/caa_stat [resource_name [...]] [-v] [-l] [-q] [-c cluster_member]
/usr/bin/caa_stat [resource_name [...]] -t [-v] [-q] [-c cluster_member]
/usr/bin/caa_stat -p [resource_name [...]] [-q]
/usr/bin/caa_stat [-a] resource_name -g
/usr/bin/caa_stat [-a] resource_name -r [-c cluster_member]
/usr/bin/caa_stat -f [resource_name [...]] [-q] [-c cluster_member]
PARAMETER
[resource_name [...]]
Name(s) of one or more resources as specified in their resource
profiles. If you do not specify a resource_name but do specify an
option, the caa_stat command displays the status pertaining to that
option for all resources. If you specify neither a resource_name nor an
option, the caa_stat command displays status for all registered
resources.
OPTIONS
-v Displays extended information about the status of resources. Extra
attributes shown include RESTART_COUNT, and FAILURE_COUNT. The
RESTART_COUNT attribute shows the number of restarts of the application
that have been attempted since it was started. The FAILURE_COUNT
attribute shows how many failures have occured during the last
FAILURE_THRESHOLD seconds.
The attribute FAILOVER_STATUS shows the time at which an application
resource started waiting to relocate due to a cluster member failure if
the resource has a FAILOVER_DELAY value greater than 0. It is not
displayed otherwise.
-l Displays the status in a list (non-tabular) format. This is the default
format.
-t Displays the status in tabular format.
-p [resource_name [...]]
Displays the status of the in-memory profile for the specified
resources. If no resources are specified the status of the in-memory
profile for all registered resources is displayed. If a resource is not
registered, its status is not displayed.
-a resource_name
Used with the -g or -r option to check if the specified resource is
registered or running under CAA. Specify the name of the resource as
listed in its resource profile.
-f Displays all information about the resource including extended
information (-v) and the in-memory profile (-p).
-g Returns 0 (zero) if the specified resource is registered with CAA;
returns 1 if it is not. This option only works if a single resource is
specified with the -a option.
-r Returns 0 (zero) if the specified resource is running under CAA;
returns 1 if it is not. This option only works if a single resource is
specified with the -a option.
-q Runs the caa_stat command in quiet mode; no messages are displayed on
the console.
-c [cluster_member]
Displays information about resources on the specified cluster member.
DESCRIPTION
The caa_stat command provides status on CAA resources clusterwide.
Resources are either ONLINE or OFFLINE as shown in the STATE attribute. An
application resource in the ONLINE state is running successfully on a
cluster member. This cluster member is shown with the state.
The TARGET value shows the state to which CAA tries to set the resource.
If the TARGET value is ONLINE and a cluster member fails, CAA will try to
restart the application on another member if possible. If there is a
condition forcing a resource STATE to be OFFLINE (such as a required
resource that is OFFLINE) the TARGET value remains ONLINE and CAA will
attempt to start the application resource once the condition is rectified.
An ONLINE state for a network resource means that the resource has not
failed. The state of network resources is shown for all cluster members.
If a tape or media changer resource is ONLINE the cluster member has a
direct path through the SCSI bus to the device. If a tape or media changer
resource is OFFLINE, there is no direct path to the device either because
the device does not have direct access to that SCSI bus, or the device has
failed. The state of a tape or changer resource is updated only when an
application that requires that resource is started. This can cause the
actual state of the device to be different from the state reported.
A TARGET value for a all non-application resources shoud be ONLINE unless
the the resource has a failure count higher than the failure threshold, in
which case the TARGET is changed to OFFLINE. The resource is then treated
as if its STATE were OFFLINE by CAA. If the STATE is ONLINE and the TARGET
is OFFLINE you can reset the target value to ONLINE using caa_start.
The verbose status -v gives extra information that may be useful,
especially for troubleshooting. The RESTART_COUNT value shows how many
times an application resource has been restarted on a single cluster
member. The maximum number of restarts before CAA stops restarting the
application is equal to RESTART_ATTEMPTS. FAILURE_COUNT shows the number
of times a resource has failed within the FAILURE_INTERVAL defined in the
resource profile. The maximum number of failues before CAA stops
restarting the application is equal to FAILURE_THRESHOLD.
If a cluster member goes down and applications are waiting to be relocated
due to the profile FAILOVER_DELAY attribute, the verbose status also shows
the FAILOVER_STATUS field. It is not shown at any other time. The
FAILOVER_STATUS field shows the member the application failed on and how
much time is left waiting for that member to restart before restarting on
another member.
EXAMPLES
The following example reports status on all CAA resources in the cluster:
# caa_stat
NAME=dhcp
TYPE=application
TARGET=ONLINE
STATE=ONLINE on polishham
NAME=named
TYPE=application
TARGET=ONLINE
STATE=ONLINE on provolone
NAME=clock
TYPE=application
TARGET=OFFLINE
STATE=OFFLINE
NAME=tape1
TYPE=tape
TARGET=OFFLINE on polishham
TARGET=OFFLINE on provolone
TARGET=OFFLINE on peppicelli
STATE=OFFLINE on polishham
STATE=OFFLINE on provolone
STATE=OFFLINE on peppicelli
The following example reports status on all CAA resources in the cluster
presented in a table format:
# caa_stat -t
Name Type Target State Host
--------------------------------------------------------
dhcp application ONLINE ONLINE polishham
named application ONLINE ONLINE provolone
clock application OFFLINE OFFLINE
tape1 tape OFFLINE polishham
tape1 tape OFFLINE provolone
tape1 tape OFFLINE peppicelli
The following example shows the behavior of a caa_stat command with a
resource specified.
# caa_stat dhcp
NAME=dhcp
TYPE=application
TARGET=ONLINE
STATE=ONLINE on polishham
The following example shows the behavior of the caa_stat -v command
# caa_stat -v
NAME=dhcp
TYPE=application
RESTART_ATTEMPTS=3
RESTART_COUNT=1
FAILURE_THRESHOLD=5
FAILURE_COUNT=0
TARGET=ONLINE
STATE=ONLINE on provolone
NAME=ln0
TYPE=network
DESCRIPTION=Network1
SUBNET=16.69.224.135
FAILURE_THRESHOLD=0
FAILURE_COUNT=0 on polishham
FAILURE_COUNT=0 on provolone
FAILURE_COUNT=0 on peppicelli
TARGET=ONLINE on polishham
TARGET=ONLINE on provolone
TARGET=OFFLINE on peppicelli
STATE=ONLINE on polishham
STATE=ONLINE on provolone
STATE=OFFLINE on peppicelli
The following example shows the behavior of the caa_stat -t -v command
# caa_stat -t -v
Name Type R/RT F/FT Target State Host
-------------------------------------------------------------------------
dhcp application 0/30 0/0 OFFLINE OFFLINE
clock application 0/30 0/0 ONLINE ONLINE provolone
tape1 tape 0/3 OFFLINE OFFLINE polishham
tape1 tape 0/3 OFFLINE OFFLINE provolone
tape1 tape 0/3 OFFLINE OFFLINE peppicelli
The following example reports status on all CAA resources with full
information on the resource displayed:
# caa_stat -f
NAME=dhcp
TYPE=application
ACTION_SCRIPT=dhcp.scr
ACTIVE_PLACEMENT=0
AUTO_START=0
CHECK_INTERVAL=5
RESTART_ATTEMPTS=1
RESTART_COUNT=0
DESCRIPTION=xclock application
FAILOVER_DELAY=0
FAILURE_INTERVAL=12
HOSTING_MEMBERS=skydiving
OPTIONAL_RESOURCES=
PLACEMENT=favored
REQUIRED_RESOURCES=
SCRIPT_TIMEOUT=60
FAILURE_THRESHOLD=2
FAILURE_COUNT=0
TARGET=ONLINE
STATE=ONLINE on polishham
NAME=ln0
TYPE=network
DESCRIPTION=Network1
FAILURE_INTERVAL=0
SUBNET=16.69.224.135
FAILURE_COUNT=0 on polishham
FAILURE_COUNT=0 on provolone
FAILURE_COUNT=0 on pepicelli
STATE=ONLINE on polishham
STATE=ONLINE on provolone
STATE=OFFLINE on pepicelli
TARGET=ONLINE on polishham
TARGET=ONLINE on provolone
TARGET=OFFLINE on pepicelli
The following example shows the behavior of the caa_stat -p command with a
resource specified.
# caa_stat -p dhcp
NAME=dhcp
TYPE=application
ACTION_SCRIPT=dhcp.scr
ACTIVE_PLACEMENT=0
AUTO_START=1
CHECK_INTERVAL=5
DESCRIPTION=dhcp daemon
FAILOVER_DELAY=30
FAILURE_INTERVAL=20
FAILURE_THRESHOLD=5
HOSTING_MEMBERS=
OPTIONAL_RESOURCES=
PLACEMENT=balanced
REQUIRED_RESOURCES=
RESTART_ATTEMPTS=3
SCRIPT_TIMEOUT=60
The following example shows the behavior of a caa_stat -a command, both
with both the -g and -r options.
# caa_stat -a dhcp -g ; echo $?
0
# caa_stat -a dhcp -r ; echo $?
0
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:
The CAA daemon is not running.
SEE ALSO
Commands: caa_profile(8), caa_register(8), caa_relocate(8), caa_start(8),
caa_stop(8), caa_unregister(8)
Daemon: caad(8)
File: caa(4)
TruCluster Server Cluster Administration
|
Index for
Section 1 |
|
|
Alphabetical
listing for C |
|
 |
Top of
page |
|