![](../graphics/a.gif) |
|
|
System Administration | disablecomponent(1m) |
| disablecomponent - add the specified component
to the specified blacklist file |
SYNOPSIS
| disablecomponent [-d domain_indicator] [-i "reason" ] location ... |
|
disablecomponent(1M) adds a component to the domain or platform blacklist, making it ineligible for booting.
The blacklist is an internal file that lists components that POST cannot use at boot time. POST reads the blacklist file(s) before preparing the system for booting, and passes along to OpenBoot PROM a list of only those components that have been successfully tested; those on the blacklist are excluded. SMS supports three blacklists: one for domain boards, one for platform boards, and the internal automatic system recovery (ASR) blacklist.
disablecomponent, when used without any option, edits the platform blacklist file.
disablecomponent cannot be used on the ASR blacklist file; only enablecomponent(1M) can be used to write to the ASR blacklist file.
For more information on the use and editing of platform and domain blacklists refer to Chapter 6, "Domain Control," in the System Management Services (SMS) 1.4 Administrator Guide.
|
|
The following options are supported:
- -d domain_indicator
- Specifies the domain using one of the following:
domain_id - ID for a domain. Valid domain_ids are A-R and are not case sensitive.
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.
- -i"reason"
- Short, descriptive explanation for adding a component to the domain blacklist. Must be enclosed in either single or double quotation marks, or be a single word.
|
|
The following operands are supported:
-
location
- List of component locations, separated by forward slashes and comprised of the following:
board_loc/proc/bank/logical_bank
board_loc/proc/bank/all_dimms_on_that_bank
board_loc/proc/all_banks_on_that_proc
board_loc/all_banks_on_that_board
board_loc/proc
board_loc/procs
board_loc/cassette
board_loc/bus
board_loc/paroli_link
-
- Multiple location arguments are permitted, separated by a space.
The location forms are optional and are used to specify particular components on boards in specific locations.
For example, the location SB5/P0/B1/L1 indicates
Logical Bank 1 of Bank 1 on Processor 0 at SB5.
The SB0/PP1 location indicates Processor Pair 1 at SB0.
The CS0/ABUS location indicates address bus 0 on the centerplane.
The EX11/DBUS1 location indicates data bus 1 at expander 11.
The following board_loc 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)
EX(0...17), EX(0...8)
-
- Processor locations indicate single processors or processor pairs.
There are four possible processors on a CPU/memory board. Processor pairs on that board are procs 0 and 1, and procs 2 and 3.
Note If you blacklist a single CPU/mem processor in a processor pair, neither processor is used. The MaxCPU has two processors, procs 0 and 1, and only one proc pair (PP0). Using PP1 for this board causes disablecomponent to exit and display an error message.
The following proc forms are accepted:
P(0...3) PP(0|1)
The following bank forms are accepted:
B(0|1)
The following logical_bank forms are accepted:
L(0|1)
The following all_dimms_on_that_bank forms are accepted:
D
The following all_banks_on_that_proc forms are accepted:
B
The following all_banks_on_that_board forms are accepted:
B
The following paroli_link forms are accepted:
PAR(0|1)
-
- The hsPCI assemblies contain hot-swappable cassettes.
The following hsPCI forms are accepted:
C(3|5)V(0|1)
-
- The hsPCI+ assemblies contain hot-swappable cassettes.
The following hsPCI+ forms are accepted:
C3V(0|1|2) and C5V0
-
- There are three bus locations: address, data, and response.
The following bus forms are accepted:
ABUS|DBUS|RBUS (0|1)
|
|
Group Privileges Required
|
You must have platform administrator, domain administrator, or domain configurator privileges to run this command. If you have platform privileges, you can run this command for the platform components only. If you have domain privileges you can run this command only on the domain for which you have 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. Adding CSB 0 and Processor 2 on System Board 1 to the Domain A Blacklist
|
|
sc0:sms-user:> disablecomponent -dA CS0 SB1/P2
|
|
Example 2. Adding the Logical Bank 0 of Bank 0 on Processor 0 on System Board 0 to the Domain A Blacklist
|
|
sc0:sms-user:> disablecomponent -dA SB0/P0/B0/L0
|
|
Example 3. Adding All DIMMs on Bank 0 of Processor 1 on System Board 3 to the Domain A Blacklist
|
|
sc0:sms-user:> disablecomponent -dA SB3/P1/B0/D
|
|
Example 4. Adding All Banks on Processor 0 on System Board 1 to the Domain B Blacklist
|
|
sc0:sms-user:> disablecomponent -dB SB1/P0/B
|
|
Example 5. Adding All Banks on System Board 0 to the Domain D Blacklist
|
|
sc0:sms-user:> disablecomponent -dD SB0/B
|
|
Example 6. Adding Processor Pair 1 on System Board 3 to the Platform Blacklist
|
|
sc0:sms-user:> disablecomponent SB3/PP1
|
|
Example 7. Adding the hsPCI Cassette in the 5V slot 0 of IO Board 6 to the Domain A Blacklist
|
|
sc0:sms-user:> disablecomponent -dA IO6/C5V0
|
|
Example 8. Adding Paroli Link 0 on wPCi Board 7 to the Platform Blacklist
|
|
sc0:sms-user:> disablecomponent IO7/PAR0
|
|
Example 9. Adding the Data Bus CS0 on EX9 to the Domain A Blacklist
|
|
sc0:sms-user:> disablecomponent -dA EX9/DBUS0
|
|
Example 10. Adding CSB 0 and Processor 2 on System Board 1 to the Domain A Blacklist Because It Is Scheduled to Be Upgraded
|
|
sc0:sms-user:> disablecomponent -dA -i upgrade CS0 SB1/P2
|
|
Example 11. Adding Processor Pair 1 on System Board 3 to the Platform Blacklist Because It Needs Service
|
|
sc0:sms-user:> disablecomponent -i "Needs service" SB3/PP1
|
|
|
|
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/platform/blacklist
- List of platform components excluded.
- /etc/opt/SUNWSMS/config/domain_id/blacklist
- List of domain components to be excluded.
|
|
See attributes(5) for descriptions of the following attributes.
Attribute Types | Attribute Values |
Availability | SUNWSMSop |
|
|
addboard(1m), enablecomponent(1m),esmd(1m), showcomponent(1m)
|
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.
|