System Management Services 1.2 man pages


	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 Administration

setupplatform(1m)

DESCRIPTION
OPTIONS
OPERANDS
EXTENDED DESCRIPTION
EXAMPLES
EXIT STATUS
ATTRIBUTES
SEE ALSO

NAME

setupplatform - set up the available component list for domains

SYNOPSIS

setupplatform [-d domain_id|domain_tag [-a|-r] location [location ...] ]

setupplatform [-d domain_id|domain_tag location [location ...] ]

setupplatform [-d domain_id|domain_tag - ]

setupplatform -h

setupplatform(1M) sets up the available component list for domains. If a domain_id|domain_tag is specified, a list of boards must be specified. An empty board list can be specified as '--'. In the case where no domain_id|domain_tag is specified, current values are displayed in the "[]" at the command prompt. If no value is specified for a parameter, it will retain its current value.

OPTIONS

The following options are supported.

-a: Add the slot(s) to the available component list for the domain.
-d domain_id: ID for a domain. Valid domain_ids are 'A'...'R' and are case insensitive.
-d 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.
-r: Remove the slots from the available component list for the domain.
-: Clears the entire available component list.

OPERANDS

The following operands are supported:

location

Board location separated by a space.

The following location forms are accepted:

Sun Fire 15K, Sun Fire 12K

SB(0...17), SB(0...8)

IO(0...17), IO(0...8)

EXTENDED DESCRIPTION

Group Privileges Required

You must have platform administrator privileges to run this command.

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

Use showplatform(1M) to display the available component list once you have run setupplatform.

Example 1. Set Up Available Component List for All Domains.

sc0:sms-user:>  setupplatform 
Available component list for domain domainA [SB3 SB2 SB1 IO5 IO4 IO3]? -r SB1
Are you sure[no]:  (yes/no)? y
Available for domain DomainB [SB6 SB4 SB1 IO3 IO2 ]?  -
Are you sure[no]:  (yes/no)? y
Available for domain C [SB7 SB5 IO8 IO7]? -a SB17 SB6
Available for domain D [SB8 SB4 SB2 IO6 IO5 IO1]?
Available for domain E [SB0 IO0]?
Available for domain F []?
Available for domain G []?
Available for domain H []?
Available for domain I []?
Available for domain J []?
Available for domain K []?
Available for domain L []?
Available for domain M []?
Available for domain N []?
Available for domain O []?
Available for domain P []?
Available for domain Q []?
Available for domain R []?

sc0:sms-user:>  showplatform -p available 
Available for domain DomainA:
 SB3 SB2
 IO0 IO4 IO3
Available for domain DomainB:
 None
 None
Available for domain DomainC:
 SB1 SB6 SB7 SB5
 IO8 IO7
Available for domain D:
 SB9 SB8 SB4
 IO6 IO5 IO1
Available for domain E:
 SB0
 IO0
Available for domain DomainF:
 None
 None
Available for domain DomainG:
 None
 None
Available for domain DomainH:
 None
 None
Available for domain I:
 None
 None
Available for domain J:
 None
 None
Available for domain DomainK:
 None
 None
Available for domain L:
 None
 None
Available for domain M:
 None
 None
Available for domain N:
 None
 None
Available for domain O:
 None
 None
Available for domain P:
 None
 None
Available for domain Q:
 None
 None
Available for domain R:
 None
 None

Example 2. Set Up Available Component List for Domain engB to Boards at SB0, IO1, and IO2

sc0:sms-user:>  setupplatform -d engB SB0 IO1 IO2

Example 3. Clear All Boards in engB Available Component List

sc0:sms-user:>  setupplatform -d engB -

Example 4. Add Boards at SB0 and IO2 to engB Available Component List

sc0:sms-user:>  setupplatform -d engB -a SB0 IO2

Example 5. Remove Boards at SB3 and IO3 From engB Available Component List

sc0:sms-user:>  setupplatform -d engB -r SB3 IO3

EXIT STATUS

The following exit values are returned:

0: Successful completion
>0: An error occurred.

ATTRIBUTES

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

Attribute Types	Attribute Values
Availability	SUNWSMSop