 |
|
|
| System Administration | poweroff(1m) |
| | poweroff - control power off |
SYNOPSIS
| | poweroff [-q] [-y|-n] [location] |
| |
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. |
| |
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.
|
| |
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 15K, Sun Fire 12K
SB(0...17), SB(0...8)
IO(0...17), IO(0...8)
CS(0|1), CS(0|1)
FT(0...7), FT(0...7)
PS(0...5), PS(0...5)
EX(0...17), EX (0...8)
SC(0|1), SC(0|1) [Only the spare SC can be powered off.]
|
| |
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 Administrator Guide for more information.
|
|
| | 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
|
|
|
| |
The following exit values are returned:
-
0
- Successful completion.
- >0
- An error occurred.
|
| |
See attributes(5) for descriptions of the following attributes.
| Attribute Types | Attribute Values |
| Availability | SUNWSMSop |
|
| SMS 1.4 | Go To Top | Last Changed 19 September 2003 |
Company Info
|
Contact
|
Copyright 2003 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, CA 95054 USA. All rights reserved.
|
