showfailover(1M) (Sun Enterprise 10000 SSP 3.5 Reference Manual)

Sun Enterprise 10000 SSP 3.5 Reference Manual

showfailover(1M)

NAME

showfailover- display the failover status of the SSP and control board

SYNOPSIS

showfailover

-r

DESCRIPTION

showfailover displays the current failover status for the SSP and control board. See the EXTENDED DESCRIPTION section for details on the status information displayed.

OPTIONS

The following option is supported:

-r: Identifies the role of the SSP, either the MAIN, SPARE, or UNKNOWN. There is a short time period following SSP startup when the SSP cannot communicate with the control boards. In this case, the SSP role cannot be determined and is considered UNKNOWN.

EXTENDED DESCRIPTION

If you do not specify an option with the showfailover command, the following information is displayed:

Failover state -- Status of the SSP and control board failover, which is one of the following:
- Active -- Indicates that automatic failover is enabled and functioning normally.
- Disabled -- Indicates that automatic failover has been disabled by operator request or by a failure condition that prevents a failover from occurring.
- Failed -- Indicates a failover occurred. After a failover, the status is considered as failed until you re-enable failover using the setfailover(1M) command. You must manually re-enable failover, even after you have fixed all connections and they are identified as GOOD in the failover connection map (described below) .
Failover connection map -- Status of the control board connection links monitored by the failover daemon (fod). The status of the connection links is either GOOD, which means the connection is operating properly, or FAILED, which means the connection is not working.
SSP/CB Host Information -- Names of the SSPs, control boards, and control board that manages the JTAG interface and the system clock.

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 TYPE	ATTRIBUTE VALUE
Architecture	All
Availability	SUNWuessp
Stability	Evolving
MT-Level	Safe

EXAMPLES

Example 1 Failover Status

In the following example, the spare SSP has failed, and SSP failover is disabled.

ssp% showfailover
Failover State:
     SSP Failover:   Disabled
     CB Failover:    Active
Failover Connection Map:
     Main SSP to Spare SSP thru Main Hub:     FAILED
     Main SSP to Spare SSP thru Spare Hub:    FAILED
     Main SSP to Primary Control Board:       GOOD
     Main SSP to Spare Control Board:         GOOD
     Spare SSP to Main SSP thru Main Hub:     FAILED
     Spare SSP to Main SSP thru Spare Hub:    FAILED
     Spare SSP to Primary Control Board:      FAILED
     Spare SSP to Spare Control Board:        FAILED
SSP/CB Host Information
     Main SSP:                                xf12-ssp
     Spare SSP:                               xf12-ssp2
     Primary Control Board (JTAG source):     xf12-cb1
     Spare Control Board:                     xf12-cb0
     System Clock source:                     xf12-cb1

Example 2 SSP Role

ssp% showfailover -r
SPARE