power(1M)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES
NAME
- power- control power
SYNOPSIS
-
power
power [-sb list] [ -cb 0|1] [ -csb csb_list] [ -p p_list]
power -off [-f] [-all] [-sb sb_list] [-csb csb_list] [-p p_list] [-cb 0|1] [-d|-q]
power -off -B [-f] [-d|-q]
power -off -ps ps_list [-d| -q] (Service Providers Only)
power -on [-all] [-sb sb_list] [-csb csb_list] [-p p_list] [-d|-q]
power -m
power -m margin_list -sb sb_list [-d| -q] (Service Providers Only)
power -m margin_list -s -sb sb_list [-d| -q] (Service Providers Only)
power -m margin_list [-d|-q] (Service Providers Only)
power -m margin_list -s [-d|-q] (Service Providers Only)
power -v [-all] [-sb sb_list] [-csb csb_list] [-p p_list] [-ps ps_list] [-d|-q]
DESCRIPTION
-
5.0VDC and 3.3VDC in the first column are the nominal voltage for each power supply. VDC means voltage direct current. In the centerplane listing, 5.0VDC HK is repeated twice and 3.3VDC Vdd is repeated three times, indicating that the voltage 5.0VDC HK is measured at two different locations and 3.3VDC Vdd is measured at three.
In the system board listing, the value of Vdd Core depends on the type of processor installed. This value can be between 2.5 VDC and 3.7 VDC, inclusive. JTAG accesses an analog-to-digital converter to read the resistor on the processor module to determine the actual value.
-
HK means housekeeping power. This power is on whenever the 48-volt power is being supplied to the board.
-
Vdd is a common abbreviation for +3.3 VDC power.
-
Vcc is a common abbreviation for +5.0 VDC power.
-
The values in the second column are the actual voltage readings provided by the analog-to-digital converter accessed through JTAG.
The power command enables you to view and control certain aspects of the Sun Enterprise 10000 system's power supplies and I/O cabinets. You can use it to power on and off the power supplies of individual boards or I/O cabinets, and to view or set their voltage margins for over-voltage and under-voltage monitoring.
When used with no options, power displays the status of all 48-volt power supplies, I/O cabinet power supplies, control board and centerplane support board power supplies, and all the individual system board power supplies. See EXAMPLES, below.
The power status of the centerplane support boards and the system boards is displayed as follows:
Good 48V Bulk Power Supplies: 0 2 3 4
Number of Good 48V Bulk Power Supplies: 4 (no redundancy)
Required 48V Power Supplies for 8 System Boards: 4
Number of Good Peripheral Cabinet Power Supplies: 0
Centerplane Support Board Average Voltages (V):
CSB# 5VDC Vcc HK 3.3VDC Vdd HK 3.3VDC Vdd Core
---- ----------------- ------------- -------------------------
0 5.047 5.037 3.501 3.311 3.301 3.297
1 5.017 5.017 3.491 3.303 3.302 3.302
System Board Average Voltages (V):
3.3VDC 5VDC 3.3VDC VDC 5VDC
SB# Vdd Vcc HK Vdd HK Vdd Core Vcc
--- ------- ------- -------- ---------- --------
0 3.301 5.086 3.407 2.601 5.008
1 3.300 5.022 3.423 2.601 5.013
2 3.300 5.015 3.439 2.607 5.010
3 3.301 5.035 3.434 2.599 5.013
4 3.290 5.015 3.423 1.897 5.005
7 3.301 5.052 3.418 2.604 5.003
8 3.296 5.059 3.429 2.596 5.000
9 3.302 5.025 3.412 2.594 5.008
Control Board Average Voltages (V):
5VDC 5VDC 3.3VDC 5VDC Vcc 5VDC
CB# Vcc Vcc HK Vdd HK Peripheral Vcc Fans
--- -------- -------- --------- ---------- ---------
0 5.113 5.049 3.420 5.194 5.091
|
where:
Note -
When housekeeping power is applied to the machine, the power supplies on the control boards are turned on automatically. The system boards and centerplane support boards are powered on following the execution of the power command. You cannot power off a system board within a domain that is a member of an InterDomain Network (IDN); you must first use domain_unlink(1M) to unlink such a domain. Use power -f to force a power off even if the board is part of an IDN; however, it can cause a cluster arbstop. You cannot power off the entire Sun Enterprise 10000 host cabinet if there is an IDN.
OPTIONS
- -sb sb_list
-
Display, turn on, turn off or validate power to the power supplies for the specified system boards. sb_list represents a space-separated list of integers, 0 to 15, inclusive, that refer to system board numbers. This option is also used for setting margins; see -m.
Note -When -sb is specified, the power command does not control housekeeping power on the system board. Also, you cannot power off the power supply of a system board that is part of a domain that is running the operating system.
- -cb 0|1
-
Turn off, display status of, or validate power to the power supplies for the specified control board, either 0 (rear) or 1 (front). Note that an active control board can turn off only a non-active control board for removal; the power command does not turn them both off. After the secondary control board has been powered off, do not attempt to use the power command to obtain the status of the control board; the registers cannot be read. Visually inspect the board LEDs before removing it from the system.
- -csb csb_list
-
Turn on, turn off, or validate power to the power supplies for the specified centerplane support boards, where csb_list is a space-separated list of integers, each either 0 (rear) or 1 (front).
Note -When -csb is specified, the power command does not control housekeeping power on the centerplane support board.
- -p p_list
-
Turn on, turn off, or validate power to the power supplies for the specified remotely controlled AC sequencer and its attached peripherals. p_list represents a space-separated list of integers, 0 to 4, inclusive, that refer to the switches (remote power control units) on the host that control the power distribution units for the peripherals. For more information, service providers can see the Sun Enterprise 10000 System Overview, a printed document that is part of the service document set.
- -all
-
Turn on, turn off, or validate power to all system boards, including centerplane support boards. If you specify -all with -sb, -csb or both, -all takes precedence.
- -d
-
(Debug Mode) Display verbose trace messages. -d and -q are mutually exclusive.
- -on
-
Turn on the system boards, including centerplane support boards, that belong to the domain specified by the SUNW_HOSTNAME environment variable. See also the options -sb, -csb and -all.
power -on turns on the specified board's power supplies, then queries the system to determine whether it has a sufficient amount of power. If so, those power supplies remain on; if not, power turns them off again and displays a message.
- -off or -f -off
-
Turn off the individual power supplies of the centerplane support boards and the system boards that belong to the domain specified by the SUNW_HOSTNAME environment variable. See also the options -sb, -csb, -cb, -p, -ps, and -all.
power -off turns off the specified board's power supplies, but only if affected domains are not running the operating system. If an affected domain is running the operating system, power displays a message to that effect and does not turn off the power. This process gives you the opportunity to gracefully shut down the domain before turning off its power. To immediately turn off power to the domain, overriding this protective feature, use -f-off.
- -off -B
-
Turn off power to the entire Sun Enterprise 10000 host cabinet and remotely controlled I/O cabinets. To restore power you must manually turn on the switches (up to four per cabinet) on the AC input modules that feed the 48-volt power supplies.
- -ps ps_list
-
Display, turn off (service providers only), or validate power to the specified 48-volt power supplies, where ps_list is one or more integers that represent the 48-volt power supplies -0 to 7, inclusive - to be validated or disabled.
Note -If you want to turn off all bulk power supplies, use the -off -B option explained above.
The Sun Enterprise 10000 dual power grid provides up to 16 bulk power supplies. The power supplies are divided into two grids, where each grid contains up to 8 power supplies. The power supplies in the primary grid are associated with power supplies in the secondary grid. For example, a relationship exists between power supplies 0 and 8, 1 and 9, and 2 and 10. If you turn off a single power supply using the power command, both the specified power supply and its associated power supply are turned off. All bulk power supplies can be turned off by powering off power supplies 0 through 7.
The command power -off -ps ps_list displays the following message:
WARNING: This system requires x 48V power supplies for a current load of y system boards (at N+1 redundancy). You are disabling z out of w 48V power supplies. This system will be able to normally operate a load of u system boards (including N+1 redundancy). Continue? (y/n)
where
x is the number of required power supplies
y is the number of system boards in the system
z is the number of power supplies to be powered off
w is the number of power supplies in the cabinet
u is the number of system boards that will be supported after power to the specified system boards is turned off
Warning: Powering off too many 48-volt power supplies may crash the system. Use the information displayed in the warning message and the chart below to determine whether turning off the specified power supplies is safe.
1 sys bd needs 4 ps 9 sys bds need 7 ps 2 sys bds need 4 ps 10 sys bds need 7 ps 3 sys bds need 5 ps 11 sys bds need 7 ps 4 sys bds need 5 ps 12 sys bds need 7 ps 5 sys bds need 5 ps 13 sys bds need 8 ps 6 sys bds need 6 ps 14 sys bds need 8 ps 7 sys bds need 6 ps 15 sys bds need 8 ps 8 sys bds need 6 ps 16 sys bds need 8 ps
- -q
-
(Quiet Mode) Inhibit any traffic to standard out. -q and -d are mutually exclusive.
- -v
-
(Validate Mode) Inspect the individual power supplies of system boards and centerplane support boards that belong to the domain specified by the SUNW_HOSTNAME environment variable to determine whether they are currently enabled.
The -v option is intended for use only by scripts. It generates a 0 exit code if all the target devices are powered up. Note that -v merely inspects the power control bits; it does not check voltages.
You can use -v with -sb or -csb, or with -p to specify the devices to be validated.
- -m
-
Display the current margin values saved in the ssp_resource(4) file.
- -m margin_list -s -sb sb_list
-
For use by service providers only.
- -m margin_list -sb sb_list
-
For use by service providers only.
The power -m margin_list -s sb | csb command sets, in the ssp_resource(4) file, the values specified in margin_list for all system boards (sb) . If -s is also specified, the change takes place immediately. Otherwise, the change takes effect when the boards are next powered on. Note that no hyphen is required before sb if -s is used.
Warning: A power supply margin more than +/- 5 percent might cause damage to the hardware. Note that margins cannot be set for Vcore values of system boards.
In both cases (power -s and power -sb), specify margin_list as a space-separated list of elements in one of the following forms:
supply.+margin
supply.margin (same as +)
supply.-margin
where margin is an integer between 1 and 5, inclusive, that represents the percentage of margin the supply voltage should be adjusted from nominal, and supply is a keyword Vcc, Vdd or Vcore that represent system board voltages as follows:
Vcc, 5 volts
Vdd, 3.3 volts
Note that the two forms of this command use margin levels differently. An immediate margin adjusts the current power level by the specified margin percentage. An automatic margin adjusts the nominal voltages by the specified margin percentage.
See the SYNOPSIS line, above, for acceptable option combinations.
EXAMPLES
Example 1 Applying Power
Apply power to power supplies on system boards 0 and 2.
power -on -sb 0 2 |
Example 2 Turning Off the Power Supplies
Turn off power supplies to all system boards in the domain specified by the SUNW_HOSTNAME environment variable.
power -off |
Example 3 Changing the Margin Voltage Value
Change the margin voltage value for all system boards as follows: increase Vcc by 2 percent, decrease Vdd by 2 percent. Note that this change in margins takes effect immediately.
power -m Vcc.+2 Vdd.-2 -s sb |
Example 4 Increasing Target Values
Increment by 3 percent the target values of Vcc, and Vdd supplies on system boards 5, 6 and 7. The change occurs when the system boards are next powered on.
power -m Vcc.+3 Vdd.+3 -sb 5 6 7 |
Example 5 Applying Power to Peripherals
Apply power to the peripherals remotely controlled by remote power control units (or switches) 2 and 3 on the host.
power -p 2 3 -on |
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES
- © 2010, Oracle Corporation and/or its affiliates