System Management Services 1.4.1 man pages


sun.com \| docs.sun.com		How To Buy \| My Sun \| Worldwide Sites

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

poweroff(1m)

DESCRIPTION
OPTIONS
OPERANDS
EXTENDED DESCRIPTION
EXAMPLES
EXIT STATUS
ATTRIBUTES
SEE ALSO

SYNOPSIS

poweroff [-q] [-y|-n] [location]

poweroff -h

poweroff(1M) powers off the specified dual 48V power supply, fan tray, or board. If no arguments are specified and you have platform administrator privileges, the entire system, with the exception of the bulk power supplies, the fan trays, and the spare system controller (SC), powers off. If active domains are utilizing the component that is going to be powered off, a listing of those domains and an "Are you sure?" prompt is given by default.

Note – When you power off a bulk power supply poweroff trips the circuit breaker. In that case the poweron command alone can not restore power. You must manually flip the breaker back on and then run poweron.

If you do not have platform administrator privileges, the [location] command operand must be specified and the board must be assigned to a domain for which you have domain administrator or configurator privileges.

Note – This command has no effect on the position of the virtual keyswitch.

OPTIONS

The following options are supported:

-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.

OPERANDS

The following operands are supported:

location

Component location separated by a space. Multiple location forms are not permitted.

The following location forms are accepted:

Sun Fire 12K/E20K

SB(0...8)

IO(0...8)

CS(0|1)

FT(0...7)

PS(0...5)

EX (0...8)

SC(0|1) [Only the spare SC can be powered off.]

Sun Fire 15K /E25K

SB(0...17)

IO(0...17)

CS(0|1)

FT(0...7)

PS(0...5)

EX(0...17)

SC(0|1) [Only the spare SC can be powered off.]

EXTENDED DESCRIPTION

Group Privileges Required

You must have either platform administrator or domain administrator/configurator privileges to run this command.

If you have domain privileges, you must also specify the [location] operand, and the [location] must be a domain configuration unit (DCU) that is assigned to a domain for which you have domain privileges.

Refer to Chapter 2, "SMS Security Options and Administrative Privileges" in the System Management Services (SMS) 1.4.1 Administrator Guide for more information.

EXAMPLES

Example 1. Powering Off a Power Supply

In this example poweroff prompts you for a reply.

sc0:sms-user:> poweroff ps5

!!!WARNING!!!WARNING!!!WARNING!!!WARNING!!!WARNING!!!
!!!WARNING!!!WARNING!!!WARNING!!!WARNING!!!WARNING!!!

This will trip the breakers on PS at PS5, which must be turned on manually!
Are you sure you want to continue to power off this component? (yes/no)? y

Example 2. Powering Off a CPU Board at Expander Position 0

In this example poweroff forces the board off by suppressing any stdout messages and answering yes to all prompts.

sc0:sms-user:> poweroff -qy SB0

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