System Management Services 1.4 man pages


sun.com \| docs.sun.com		How To Buy \| My Sun \| Worldwide Sites

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 and Capacity on Demand (COD) resources used for domains

SYNOPSIS

setupplatform -p available [-d domain_indicator [-a|-r] location ...]

setupplatform -p cod [headroom|-d domain_indicator domainRTU]

setupplatform [-d domain_indicator - ]

setupplatform -h

setupplatform(1M) sets up the available component list and COD resources to be used for domains. If a domain_id or domain_tag is specified, a list of boards must be specified. An empty board list can be specified as a dash( - ). When no domain_id or domain_tag is specified, current values are displayed in the square brackets ([]) at the command prompt. If no value is specified for a parameter, it retains its current value.

OPTIONS

The following options are supported:

-a

Adds the slot(s) to the available component list for the domain.

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

-p available

Modifies the domain available component list.

-p cod

Assigns COD resources.

-r

Removes the slots from the available component list for the domain.

-

Clears the entire available component list.

OPERANDS

The following operands are supported:

domainRTU

Number of COD right-to-use (RTU) licenses to be reserved for a domain.

headroom

Amount of headroom (processors) to be enabled.

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

If you run the setupplatform command without specifying any options, the command prompts you for platform and COD information. You are asked to specify the available component list for all 18 domains, the amount of COD headroom to be used, and the number of COD RTU licenses to be reserved for your domains. When you are prompted for COD information, the maximum values allowed are displayed within parentheses () and default values are displayed within brackets [].

Use the -p cod option with the setupplatform command to enable COD headroom (processors to be used on demand). Use the -d domain_indicator with the -p cod option to specify the number of domain COD RTU licenses to be reserved.

You can reset the domain available component list and COD RTU reservation values by running the setupplatform command with a domain indicator and the '-' option.

Group Privileges Required

You must have platform administrator privileges to run this command.

Refer to Chapter 2, "SMS Security Options and Administrative Privileges" in the System Management Services (SMS) 1.4 Administrator Guide for more information.

EXAMPLES

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

Example 1. Setting 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 SB16
Available for domain D [SB9 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 []?
PROC Headroom Quantiy (0 to disable, 8 MAX) [0]? 4
PROC RTUs reserved for domain A (10 MAX) [0]? 3
PROC RTUs reserved for domain B (7  MAX) [0]? 0
PROC RTUs reserved for domain C (7  MAX) [0]? 0
PROC RTUs reserved for domain D (7  MAX) [0]? 0
PROC RTUs reserved for domain E (7  MAX) [0]? 0
PROC RTUs reserved for domain F (7  MAX) [0]? 0
PROC RTUs reserved for domain G (7  MAX) [0]? 0
PROC RTUs reserved for domain H (7  MAX) [0]? 0
PROC RTUs reserved for domain I (7  MAX) [0]? 0
PROC RTUs reserved for domain J (7  MAX) [0]? 0
PROC RTUs reserved for domain K (7  MAX) [0]? 0
PROC RTUs reserved for domain L (7  MAX) [0]? 0
PROC RTUs reserved for domain M (7  MAX) [0]? 0
PROC RTUs reserved for domain N (7  MAX) [0]? 0
PROC RTUs reserved for domain O (7  MAX) [0]? 0
PROC RTUs reserved for domain P (7  MAX) [0]? 0
PROC RTUs reserved for domain Q (7  MAX) [0]? 0
PROC RTUs reserved for domain R (10 MAX) [3]? 3

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. Setting Up Available Component List for Domain engB to Boards at SB0, IO1, and IO2

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

Example 3. Clearing All Boards in engB Available Component List and Reserved COD RTUs

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

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

sc0:sms-user:>  setupplatform -p available engB -a SB0 IO2

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

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

Example 6. Setting COD CPU Headroom Quantity and Reserve Domain COD RTU Licenses

sc0:sms-user:>  setupplatform -p cod
PROC Headroom Quantity (0 to disable, 8 MAX) [0]? 4
PROC RTUs reserved for domain A (10 MAX) [0]? 3
PROC RTUs reserved for domain B (7  MAX) [0]? 0
PROC RTUs reserved for domain C (9  MAX) [2]? 0
.
.
.
PROC RTUs reserved for domain R (7  MAX) [0]? 0

Example 7. Set the COD Headroom CPUs to 8

sc0:sms-user:>  setupplatform -p cod 8

Example 8. Set the number of COD RTUs for Domain engB to 6

sc0:sms-user:>  setupplatform -p cod -d engB 6

EXIT STATUS

The following exit values are returned:

0: Successful completion.
>0: An internal error occurred. For further information, see /var/opt/SUNWSMS/adm/platform/messages.

ATTRIBUTES

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

Attribute Types	Attribute Values
Availability	SUNWSMSop