setkeyswitch(1M) changes the position of the virtual keyswitch to the specified value. setkeyswitch is responsible for powering on or powering down boards and bringing up a domain. See the OPERANDS section for more information.

If the domain specified contains a board in the automatic system recovery (ASR) blacklist file, an error message is displayed and setkeyswitch continues.

The state of each virtual keyswitch is maintained between power cycles of the system controller (SC) or physical power cycling of the power supplies by the pcd(1M). Use showkeyswitch to display the current position of a virtual keyswitch.

The following options are supported.

-d domain_id

ID for a domain. Valid domain_ids are 'A'...'R' and are case insensitive.

-d domain_tag

Name assigned to a domain using addtag(1M).

-h

Help. Displays usage descriptions. Note – Use alone. Any option specified in addition to -h is ignored.

-n

Automatically answers "no" to all prompts. Prompts are displayed unless used with the -q option.

-q

Quiet. Suppresses all messages to stdout including prompts.

When used alone, -q defaults to the -n option for all prompts.

When used with either the -y or the -n option, -q suppresses all user prompts and automatically answers with either 'y' or 'n' based on the option chosen.

-y

Automatically answers "yes" to all prompts. Prompts are displayed unless used with the -q option.

The following operands are supported:

on

From the off or standby position, on powers on all boards assigned to the domain (if not already powered on). Then the domain is brought up.

From the diag position, on is nothing more than a position change, but upon the next reboot of the domain, post is not invoked with verbosity and the diag level is set to its default value.

From the secure position, on restores write permission to the domain.

standby

From the off position, standby powers on all boards assigned to the domain (if not already powered on).

From the on, diag, or secure position, standby optionally causes a confirmation prompt and the domain is gracefully shut down. The boards remain fully powered.

off

From the on, diag, or secure position, off optionally causes a confirmation prompt and all boards are put into low-power mode.

From the standby position, off puts all boards into low-power mode.

diag

From the off or standby position, diag powers on all boards assigned to the domain (if not already powered on). Then the domain is brought up just as in the on position, except that post is invoked with the verbosity and diag levels set to at least their defaults.

From the on position, diag results in nothing more than a position change, but upon the next reboot of the domain, post is invoked with the verbosity and diag levels set to at least their defaults.

From the secure position, diag restores write permission to the domain and upon the next reboot, post is invoked with the verbosity and diag levels set to at least their defaults.

secure

From the off or standby position, secure powers on all boards assigned to the domain (if not already powered on). Then the domain is brought up just as in the on position, except that the secure position removes write permission to the domain, for example, flashupdates, and resets will not work.

From the on position, secure removes write permission to the domain (as described above).

From the diag position, secure removes write permission to the domain (as described above) and on the next reboot of the domain, post is invoked with the verbosity and diag levels set to at least their defaults.

Group Privileges Required

The following exit values are returned:

0

Successful completion

>0

An error occurred.

The following file is used by this command.

/etc/opt/SUNWSMS/config/asr/blacklist

List of components excluded by esmd.

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

addtag(1m), esmd(1m), flashupdate(1m), pcd(1m), reset(1m), showkeyswitch(1m)