System Management Services 1.2 man pages


	www.sun.com	docs.sun.com \| \| \|

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

System Administration

showfailover(1m)

DESCRIPTION
OPTIONS
EXTENDED DESCRIPTION
EXAMPLES
EXIT STATUS
ATTRIBUTES
SEE ALSO

NAME

showfailover - manage or display system controller (SC) failover status

SYNOPSIS

showfailover [-r] [-v]

showfailover -h

showfailover(1M) provides the ability to monitor the state of the SC failover mechanism. This command displays the current status of the failover mechanisms. If you do not specify a -r option, then the following information is displayed:

SC Failover: state

The failover mechanisms can be in one of three states: ACTIVE, DISABLED, and FAILED. See the EXTENDED DESCRIPTION below.

OPTIONS

The following options are supported.

-h: Help. Displays usage descriptions. Note – Use alone. Any option specified in addition to -h is ignored.
-r: Displays the SC's role as either MAIN, SPARE or UNKNOWN.
-v: Verbose. Displays all available command information.

EXTENDED DESCRIPTION

The failover mechanism states are described as follows:

ACTIVE

Identifies the failover mechanism as being enabled and functioning normally.

DISABLED

Identifies that the failover mechanism has been disabled due to the occurrence of a failover or an operator request (for example, setfailover off).

FAILED

Identifies that the failover mechanism has detected a failure that prevents a failover from being possible.

In addition, showfailover displays the state of each of the network interface links monitored by the failover processes. The display format is:

network i/f device name: [GOOD|FAILED]

A failure string is returned describing the failure condition. Each failure string has a code associated with it. The following codes and associated failure strings are defined:

String	Explanation
None	No Failure.
M-SC/S-SC EXT NET	The main and spare SC's external network interfaces have failed.
S-SC CONSOLE BUS	A fault has been detected on the spare SC's console bus path.
S-SC LOC CLK	The spare SC's local clock has failed.
S-SC CLK NOT PHASE LOCKED	The spare SC's clock is not phase locked with the main SC.
S-SC DISK FULL	The spare SC's system is full.
S-SC IS DOWN	The spare SC is down and unresponsive.
S-SC MEM EXHAUSTED	The spare SC's memory/swap space has been exhausted.
S-SC SMS DAEMON	At least one SMS daemon could not be started/restarted on the spare SC.
No CSBS Powered on	At least one CSB must be powered on.

Group Privileges Required

You must have platform administrator, platform operator, or platform service privileges to run this command.

Refer to Chapter 2 in the System Management Services (SMS) 1.2 Administrator Guide for the Sun Fire 15K/12K Systems for more information.

EXAMPLES

Example 1. Failover Status Shows Everything is OK

sc0:sms-user:> showfailover 
SC Failover: ACTIVE 
hme0: GOOD 
hme1: GOOD 
hme2: GOOD

Example 2. The Spare SC System is Full

sc0:sms-user:> showfailover 
SC Failover: FAILED 
S-SC DISK FULL 
hme0: GOOD 
hme1: GOOD 
hme2: GOOD

Example 3. Displays the SC Role

sc0:sms-user:>  showfailover -r  
SC: SPARE

EXIT STATUS

The following exit values are returned:

0: Successful completion
>0: An error occurred.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

Attribute Types	Attribute Values
Availability	SUNWSMSop