Sun Microsystems, Inc.
   www.sun.com docs.sun.com | | |  
   
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 Administrationdisablecomponent(1m)


NAME

 disablecomponent - add the specified component to the specified blacklist file

SYNOPSIS

 disablecomponent [-d domain_id|domain_tag ] [-i "reason" ] location [location ...]
 disablecomponent -h

DESCRIPTION

 

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 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 and one for platform boards; and the internal automatic system recovery (ASR) blacklist.

disablecomponent used without any option edits the platform blacklist file.

disablecomponent cannot be used on the ASR blacklist file; only esmd(1M) can write to the ASR blacklist file.

For more information on the use and editing of platform and domain blacklists refer to Chapter 7 in the System Management Services (SMS) 1.2 Administrator Guide for the Sun Fire 15K/12K Systems.

OPTIONS

 

The following options are supported.

-d domain_id
ID for a domain. Valid domain_ids are 'A'...'R' and are case insensitive. Specifies the component to add to the domain blacklist.
-d domain_tag
Name assigned to a domain using addtag(1M). Specifies the component to add to the domain blacklist.
-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.

OPERANDS

 

The following operands are supported:

location
List of component locations, separated by forward slashes and comprised of:

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/ABUS1 location indicates address bus 1 at CS0.

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 will cause 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)

There are three bus locations: address, data and response.

The following bus forms are accepted:

ABUS|DBUS|RBUS (0|1)

EXTENDED DESCRIPTION

 

Group Privileges Required

 

You must have platform administrator, domain administrator, domain configurator privileges to run this command. If you have platform privileges you may run this command for the platform components only. If you have domain privileges you may only run this command on the domain for which you have privileges.

Refer to Chapter 2 in the System Management Services (SMS) 1.2 Administrator Guide for the Sun Fire 15K/12K Systems for more information.

EXAMPLES

 Example 1. Add CSB 0 and Processor 2 on System Board 1 to the Domain A Blacklist
 
 
sc0:sms-user:> disablecomponent -dA CS0 SB1/P2
Example 2. Add 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. Add 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. Add All Banks on Processor 0 on System Board 1 to the Domain B Blacklist
 
 
sc0:sms-user:> disablecomponent -dB SB1/P0/B
Example 5. Add All Banks on System Board 0 to the Domain D Blacklist
 
 
sc0:sms-user:> disablecomponent -dD SB0/B
Example 6. Add Processor Pair 1 on System Board 3 to the Platform Blacklist
 
 
sc0:sms-user:> disablecomponent SB3/PP1
Example 7. Add 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. Add Paroli Link 0 on wPCi Board 7 to the Platform Blacklist
 
 
sc0:sms-user:> disablecomponent IO7/PAR0
Example 9. Add the Data Bus CS0 on EX9 to the Domain A Blacklist
 
 
sc0:sms-user:> disablecomponent -dA EX9/DBUS0
Example 10. Add 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. Add Processor Pair 1 on System Board 3 to the Platform Blacklist Because It Needs Service
 
 
sc0:sms-user:> disablecomponent -i "Needs service" SB3/PP1

EXIT STATUS

 

The following exit values are returned:

0
Successful completion
>0
An error occurred.

FILES

 

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.

ATTRIBUTES

 

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

Attribute TypesAttribute Values
AvailabilitySUNWSMSop

SEE ALSO

 

addboard(1m), enablecomponent(1m),esmd(1m), showcomponent(1m)


SMS 1.2Go To TopLast Changed 22 April 2002

 
      
      
Copyright 2002 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, CA 95054 USA. All rights reserved.