|
|
|
System Administration | setupplatform(1m) |
| 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(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.
|
|
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.
|
|
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)
|
|
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.
|
|
|
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
|
|
|
|
The following exit values are returned:
-
0
- Successful completion.
- >0
- An internal error occurred. For further information, see
/var/opt/SUNWSMS/adm/platform/messages.
|
|
See attributes(5) for descriptions of the following attributes.
Attribute Types | Attribute Values |
Availability | SUNWSMSop |
|
|
addtag(1m), showplatform(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.
|