enablecomponent(1M) removes a component from the platform, domain, or ASR blacklist, making it eligible 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 ASR blacklist.

The ASR blacklist is an internal file created by esmd when it powers off components due to environmental conditions. The ASR blacklist is also used by the power libraries and SMS commands to prevent turning on a bad component.

enablecomponent, when used without any option, edits the platform blacklist.

Use showcomponent(1M) to display whether a particular component is currently blacklisted.

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:

-a

Specifies the component to remove from the ASR blacklist.

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

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.

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

The MaxCPU has two processors, procs 0 and 1, and only one proc pair (PP0). Using PP1 for this board causes enablecomponent 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

The following exit values are returned:

0

Successful completion.

>0

An error occurred.

The following files are used by this command.

/etc/opt/SUNWSMS/config/asr/blacklist

List of components excluded by esmd.

/etc/opt/SUNWSMS/config/platform/blacklist

List of platform components excluded.

/etc/opt/SUNWSMS/config/domain_id/blacklist

List of domain components excluded.

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

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