setfailover(1M)

NAME | SYNOPSIS | CAUTION | DESCRIPTION | OPTIONS | EXIT STATUS | ATTRIBUTES | FILES | SEE ALSO

NAME

setfailover- modify the automatic failover state for the SSP or control board

SYNOPSIS

setfailover [-t cb] on| off| force
setfailover -m [memory_threshold]
setfailover -d [disk_space_threshold]

CAUTION

Be sure that both the main and the spare SSP are synchronized before forcing a failover. To synchronize both SSPs, use the setdatasync(1M) command.

DESCRIPTION

setfailover enables you to set the target of the automatic failover to either the SSP or control board, turn automatic failover either on or off, or force an automatic failover. The default target for the automatic failover is the SSP.

You can also use setfailover to query or change the virtual memory and disk space threshold parameters, which are used by the fod daemon in determining whether to initiate an SSP failover.

setfailover must be run on the main SSP.

OPTIONS

The following options are supported:

force

Forces automatic failover to either an available spare SSP or control board if the -t cb option is specified.

If the -t cb option is specified, the JTAG interface is moved to the spare control board, but not the system clock. The system clock is moved if there are no active domains.

off

Disables automatic failover for either the SSP or the control board if the -t cb option is specified. Automatic failover remains disabled until it is enabled using the on option.

on

Enables automatic failover on systems in which the failover was previously disabled due to operator request or system failure.

setfailover checks the connection states before enabling failover. If any failed connections exist, failover is not enabled.

-t cb

Targets the control board for the automatic failover.

-m [memory_threshold]

Sets the virtual memory threshold in the ssp_resource file, where memory_threshold is the updated value in Kbytes. If you specify only the -m option, the current virtual memory threshold stored in the ssp_resource file is displayed.

-d [disk_space_threshold]

Sets the disk space threshold in the ssp_resource file, where disk_space_threshold is the updated value in Kbytes. If you specify only the -d option, the current disk space threshold stored in the ssp_resource file is displayed.

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

FILES

The following file is supported:

$SSPVAR/.ssp_private/ssp_resource

The SSP resource file

SEE ALSO

fod(1M), setdatasync(1M), showfailover(1M), ssp_resource(4)

Sun Enterprise 10000 SSP User Guide

SSP 3.5  Last Revised 11 Aug 2000

NAME | SYNOPSIS | CAUTION | DESCRIPTION | OPTIONS | EXIT STATUS | ATTRIBUTES | FILES | SEE ALSO