-C H A P T E R

C H A P T E R 6

Capacity on Demand

Product Names are configured with processors (CPUs) on CPU/Memory boards. These boards are purchased as part of your initial system configuration or as add-on components. The right to use the CPUs on these boards is included with the initial purchase price.

The Capacity on Demand (COD) option provides additional processing resources that you pay for when you use them. Through the COD option, you purchase and install unlicensed COD CPU/Memory boards in your system. Each COD CPU/Memory board contains four CPUs, which are considered as available processing resources. However, you do not have the right to use these COD CPUs until you also purchase the right-to-use (RTU) licenses for them. The purchase of a COD RTU license entitles you to receive a license key, which enables the appropriate number of COD processors.

You use COD commands included with the SMS software to allocate, activate, and monitor your COD resources.

This chapter covers the following topics:

COD Overview

The COD option provides additional CPU resources on COD CPU/Memory boards that are installed in your system. Although your Product Name comes configured with a minimum number of standard (active) CPU/Memory boards, your system can have a mix of both standard and COD CPU/Memory boards installed, up to the maximum capacity allowed for the system. At least one active CPU is required for each domain in the system.

If you want the COD option, and your system is not currently configured with COD CPU/Memory boards, contact your Sun sales representative or authorized Sun reseller to purchase COD CPU/Memory boards. Your salesperson will work with your service provider to install the COD CPU/Memory boards in your system.

The following sections describe the main elements of the COD option:

COD Licensing Process

COD RTU licenses are required to enable COD CPU resources. COD licensing involves the following tasks:

Obtaining COD RTU license certificates and COD RTU license keys for COD resources to be enabled.

You can purchase COD RTU licenses at any time from your Sun sales representative or reseller. You can then obtain a license key (for the COD resources purchased) from the Sun License Center.
Entering the COD RTU license keys in the COD license database.

The COD license database stores the license keys for the COD resources that you enable. You record this license information in the COD license database by using the addcodlicense(1M) command. The COD RTU licenses are considered as floating licenses and can be used for any COD CPU resource installed in the system.

For details on completing the licensing tasks, see To Obtain and Add a COD RTU License Key to the COD License Database.

COD RTU License Allocation

With the COD option, your system is configured to have a certain number of COD CPUs available, as determined by the number of COD CPU/Memory boards and COD RTU licenses that you purchase. The COD RTU licenses that you obtain are handled as a pool of available licenses.

When you activate a domain containing a COD CPU/Memory board or when a COD CPU/Memory board is connected to a domain through a dynamic reconfiguration (DR) operation, the following occurs automatically:

The system checks the current installed COD RTU licenses.

The system obtains a COD RTU license (from the license pool) for each CPU on the COD board.

The COD RTU licenses are allocated to the CPUs on a "first come, first serve" basis. However, you can allocate a specific quantity of RTU licenses to a particular domain by using the setupplatform(1M) command. For details, see To Enable Instant Access CPUs and Reserve Domain RTU Licenses.

If there is an insufficient number of COD RTU licenses and a license cannot be allocated to a COD CPU, the COD CPU is not configured into the domain and is considered as unlicensed. A COD CPU is considered to be unused when it is assigned to a domain but the CPU is not active.

If a COD CPU/Memory board does not have sufficient COD RTU licenses for its COD CPUs, the system will fail the COD CPU/Memory board during the setkeyswitch on operation. For additional details and examples, see Deconfigured and Unlicensed COD CPUs.

When you remove a COD CPU/Memory board from a domain through a DR operation or when a domain containing a COD CPU/Memory board is shut down normally, the COD RTU licenses for the CPUs on those boards are released and added to the pool of available licenses.

You can use the showcodusage command to review COD usage and COD RTU license states. For details on showcodusage and other commands that provide COD information, see Monitoring COD Resources.

Note - You can move COD boards between Sun Fire systems (Sun Fire 15K, 12K, 6800, 4810, 4800, and 3800 servers), but the associated license keys are tied to the original platform for which they were purchased and are non-transferable.

Instant Access CPUs

If you require COD CPU resources before you complete the COD RTU license purchasing process, you can temporarily enable a limited number of resources called instant access CPUs (also referred to as headroom). These instant access CPUs are available as long as there are unlicensed COD CPUs in the system. The maximum number of instant access resources available on Product Names is eight CPUs.

Instant access CPUs are disabled by default on Sun Fire high-end systems. If you want to use these resources, you activate them by using the setupplatform(1M) command. Warning messages are logged on the platform console, informing you that the number of instant access CPUs (headroom) used exceeds the number of COD licenses available. Once you obtain and add the COD RTU license keys for instant access CPUs to the COD license database, these warning messages will stop.

For details on activating instant access CPUs, see, To Enable Instant Access CPUs and Reserve Domain RTU Licenses.

Instant Access CPUs as Hotspares

You can temporarily enable an available, instant access CPU to replace a failed non-COD CPU. In this case, the instant access CPU is considered as a hotspare (a spare CPU that can be used immediately to replace a failed non-COD CPU). However, once the failed non-COD CPU has been replaced, you must deactivate the instant access CPU (see To Enable Instant Access CPUs and Reserve Domain RTU Licenses). Contact your Sun sales representative or reseller to purchase a COD RTU license for the instant access CPU in use if you want to continue using it.

Resource Monitoring

Information about COD events, such as the activation of instant access CPUs (headroom) or license violations, is recorded in the platform log and can be viewed by using the showlogs command.

Other commands, such as the showcodusage(1M) command, provide information on COD components and COD configuration. For details on obtaining COD information and status, see Monitoring COD Resources.

Getting Started with COD

Before you can use COD on Product Names, you must complete certain prerequisites. These tasks include the following:

Installing the same version of the SMS software on both the main and spare system controller (SC).

For details on upgrading the software, refer to the System Management Services (SMS) 1.4 Installation Guide.

Note - SMS software versions before SMS 1.3 will not recognize COD CPU/Memory boards.

Contacting your Sun sales representative or reseller and doing the following:
- Signing the COD contract addendum, in addition to the standard purchasing agreement contract for your Product Name.
- Purchasing COD CPU/Memory boards and arranging for their installation.

Performing the COD RTU licensing process as described in To Obtain and Add a COD RTU License Key to the COD License Database.

Managing COD RTU Licenses

COD RTU license management involves the acquisition and addition of COD RTU licenses keys to the COD license database. You can also remove COD RTU licenses from the license database if needed.

To Obtain and Add a COD RTU License Key to the COD License Database

1. Contact your Sun sales representative or authorized Sun reseller to purchase a COD RTU license for each COD CPU to be enabled.

Sun will send you a COD RTU License Certificate for each CPU license that you purchase. The COD RTU license sticker on the License Certificate contains a right-to-use serial number used to obtain a COD RTU license key.

2. Contact the Sun License Center and provide the following information to obtain a COD RTU license key:

The COD RTU serial number from the license sticker on the COD RTU License Certificate.
Chassis HostID, which uniquely identifies the platform.

You can obtain the Chassis HostID by running the command
showplatform -p cod as platform administrator.

For instructions on contacting the Sun License Center, refer to the COD RTU License Certificate that you received or check the Sun License Center web site:

http://www.sun.com/licensing

The Sun License Center will send you an email message containing the RTU license key for the COD resources that you purchased.

3. Add the license key to the COD license database by using the addcodlicense (1M) command. In an SC window, log in as a platform administrator and type:

sc0:sms-user:> addcodlicense license-signature

where license-signature is the complete COD RTU license key assigned by the Sun License Center. You can copy the license key string that you receive from the Sun License Center.

4. Verify that the specified license key was added to the COD license database by running the showcodlicense -r command (see To Review COD License Information).

The COD RTU license key that you added should be listed in the showcodlicense(1M) command output.

To Delete a COD License Key From the COD License Database

1. In an SC window, log in as a platform administrator and type:

sc0:sms-user:> deletecodlicense license-signature

where :

license-signature is the complete COD RTU license key to be removed from the COD license database.

The system verifies that the license removal will not cause a COD RTU license violation, which occurs when there is an insufficient number of COD licenses for the number of COD resources in use. If the deletion will cause a COD RTU license violation, the SC will not delete the license key.

Note - You can force the removal of the license key by specifying the -f option with the deletecodlicense(1M) command. However, be aware that the license key removal could cause a license violation or an over commitment of RTU license reservations. An RTU license over commitment occurs when there are more RTU domain reservations than RTU licenses installed in the system. For additional details, refer to the deletecodlicense(1M) command description in the System Management Services (SMS) 1.4 Reference Manual.

2. Verify that the license key was deleted from the COD license database by running the showcodlicense -r command, described in the next procedure.

The deleted license key should not be listed in the showcodlicense output.

To Review COD License Information

1. In an SC window, log in as a platform administrator and type one of the following to display COD license information:

To view license data in an interpreted format, type:

sc0:sms-user:> showcodlicense

For example:

sc0:sms-user:> showcodlicense

              Lic                                    Tier

 Description  Ver   Expiration  Count   Status  Cls  Num  Req

 -----------  ---  -----------  -----  -------  ---  ---  ---

 PROC          01         NONE     16     GOOD    1    1    0

TABLE 6-1 describes the COD license information in the showcodlicense output.

TABLE 6-1 COD License Information
Item	Description
Description	Type of resource (processor)
Lic Ver	Version number of the license
Expiration	None. Not supported (no expiration date)
Count	Number of RTU licenses granted for the given resource
Status	One of the following states: GOOD - Indicates the resource license is valid EXPIRED - Indicates the resource license is no longer valid
Cls	Not applicable.
Tier Num	Not applicable.
Req	Not applicable.

To view license data in raw license key format, type:
sc0:sms-user:> showcodlicense -r
The license key signatures for COD resources are displayed. For example:
sc0:sms-user:> showcodlicense -r

01:5014936C37048:45135285:0201000000:8:00000000:0000000000000000000000
Note - The COD RTU license key listed above is provided as an example and is not a valid license key.

For details on the showcodlicense(1M) command, refer to the command description in the System Management Services (SMS) 1.4 Reference Manual.

Activating COD Resources

To activate instant access CPUs and allocate COD RTU licenses to specific domains, use the setupplatform command. TABLE 6-2 describes the various setupplatform command options that can be used to configure COD resources

TABLE 6-2 `setupplatform` Command Options for COD Resource Configuration
Use `setupplatform` Command Options	To...
`setupplatform -p cod`	Enable or disable instant access CPUs (headroom) and allocate domain COD RTU licenses
`setupplatform -p cod` headroom-number	Enable or disable instant access CPUs (headroom)
`setupplatform -p cod -d` domainid RTU-number	Reserve a specific quantity of COD RTU licenses for a particular domain

For details on the setupplatform command options, refer to the command description in the System Management Services (SMS) 1.4 Reference Manual.

To Enable Instant Access CPUs and Reserve Domain RTU Licenses

1. In an SC window, log in as a platform administrator and type:

sc0:sms-user:> setupplatform -p cod

You are prompted to enter the COD parameters (headroom quantity and domain RTU information). For example:

sc0:sms-user:> setupplatform -p cod

PROC RTUs installed: 12

PROC Headroom Quantity (0 to disable, 8 MAX) [0]:0

PROC RTUs reserved for domain A (12 MAX) [0]: 4

PROC RTUs reserved for domain B (8 MAX) [2]: 4

PROC RTUs reserved for domain C (4 MAX) [0]: 0

PROC RTUs reserved for domain D (4 MAX) [0]:?

PROC RTUs reserved for domain E (4 MAX) [0]?

PROC RTUs reserved for domain G (4 MAX) [0]?

PROC RTUs reserved for domain H (4 MAX) [0]?

PROC RTUs reserved for domain I (4 MAX) [0]?

PROC RTUs reserved for domain J (4 MAX) [0]?

PROC RTUs reserved for domain K (4 MAX) [0]?

PROC RTUs reserved for domain L (4 MAX) [0]?

PROC RTUs reserved for domain M (4 MAX) [0]?

PROC RTUs reserved for domain N (4 MAX) [0]?

PROC RTUs reserved for domain O (4 MAX) [0]?

PROC RTUs reserved for domain P (4 MAX) [0]?

PROC RTUs reserved for domain Q (4 MAX) [0]?

PROC RTUs reserved for domain R (4 MAX) [0]?

Note the following about the prompts displayed:

Instant access CPU (headroom) quantity

The text in parenthesis indicates the maximum number of instant access CPUs (headroom) allowed. The value inside the brackets is the number of instant access CPUs currently configured.

To disable the instant access CPU (headroom) feature, type 0. You can disable the headroom quantity only when there are no instant access CPUs in use.
Domain reservations

The text in parenthesis indicates the maximum number of RTU licenses that can be reserved for the domain. The value inside the brackets is the number of RTU licenses currently allocated to the domain.

2. Verify the COD resource configuration by running the showplatform(1M) command:

sc0:sms-user:> showplatform -p cod

For example:

sc0:sms-user:> showplatform -p cod

COD:

====

Chassis HostID : 5014936C37048

PROC RTUs installed: 8

PROC Headroom Quantity: 0

PROC RTUs reserved for domain A : 4

PROC RTUs reserved for domain B : 0

PROC RTUs reserved for domain C : 0

PROC RTUs reserved for domain D : 0

PROC RTUs reserved for domain E : 0

PROC RTUs reserved for domain F : 0

PROC RTUs reserved for domain G : 0

PROC RTUs reserved for domain H : 0

PROC RTUs reserved for domain I : 0

PROC RTUs reserved for domain J : 0

PROC RTUs reserved for domain K : 0

PROC RTUs reserved for domain L : 0

PROC RTUs reserved for domain M : 0

PROC RTUs reserved for domain N : 0

PROC RTUs reserved for domain O : 0

PROC RTUs reserved for domain P : 0

PROC RTUs reserved for domain Q : 0

PROC RTUs reserved for domain R : 0

Note - The Chassis HostID is used for COD licensing purposes. If the Chassis HostID is listed as UNKNOWN, you must power on the centerplane support boards to obtain the Chassis HostID. In this case, allow up to one minute before rerunning the showplatform command to display the Chassis HostID.

Monitoring COD Resources

This section describes various ways to track COD resource use and obtain COD information.

COD CPU/Memory Boards

You can determine which CPU/Memory boards in your system are COD boards by using the showboards(1M) command.

To Identify COD CPU/Memory Boards

1. In an SC window, log in as platform administrator and type:

sc0:sms-user:> showboards -v

The information displayed shows board assignments and test status. COD CPU boards are identified as CPU (COD).

For example:

sc0:sms-user:> showboards -v

Location    Pwr    Type of Board   Board Status  Test Status   Domain

--------    ---    -------------   ------------  -----------   ------

SC0         On     SC              Main              -             -

SC1         On     SC              Spare             -             -

PS0         On     PS                -               -             -

PS1         On     PS                -               -             -

SB0         Off    CPU             Available     Unknown       Isolated

SB1          -     Empty Slot      Available         -         Isolated

SB2         Off    CPU             Available     Unknown       Isolated

SB3          -     Empty Slot      Available         -         Isolated

SB4         On     CPU (COD)       Assigned      Unknown       A

SB5          -     Empty Slot      Available         -         Isolated

SB6         On     CPU (COD)       Active        Passed        B

SB7          -     Empty Slot      Available         -         Isolated

SB8          -     Empty Slot      Available         -         Isolated

SB9          -     Empty Slot      Available         -         Isolated

SB10         -     Empty Slot      Available         -         Isolated

SB11         -     Empty Slot      Available         -         Isolated

SB12        Off    CPU (COD)       Assigned      Unknown       C

COD Resource Usage

To obtain information on how COD resources are used in your system, use the showcodusage(1M) command.

To View COD Usage By Resource

1. In an SC window, log in as a platform administrator and type:

sc0:sms-user:> showcodusage -p resource

For example:

sc0:sms-user:> showcodusage -p resource

Resource:

=========

Resource    In Use  Installed  Licensed  Status

----------  ------  ---------  --------  ------

PROC             4         12        12  OK: 8 available

TABLE 6-1 describes the COD resource information displayed by the showcodusage(1M) command.

TABLE 6-3 `showcodusage` Resource Information
Item	Description
Resource	The COD resource (processor)
In Use	The number of COD CPUs currently used in the system
Installed	The number of COD CPUs installed in the system
Licensed	The number of COD RTU licenses installed
Status	One of the following COD states: OK - Indicates there are sufficient licenses for the COD CPUs in use and specifies the number of remaining COD resources available and the number of any instant access CPUs (headroom) available HEADROOM - The number of instant access CPUs in use VIOLATION - Indicates a license violation exists. Specifies the number of COD CPUs in use that exceeds the number of COD RTU licenses available. This situation can occur when you force the deletion of a COD license key from the COD license database, but the COD CPU associated with that license key is still in use.

To View COD Usage by Domain

1. In an SC window, log in as a platform or domain administrator and type:

sc0:sms-user:> showcodusage -p domains -v

The output includes the status of CPUs for all domains. For example:

sc0:sms-user:> showcodusage -p domains -v

Domains:

========

Domain/Resource  In Use  Installed  Reserved  Status

---------------  ------  ---------  --------  ------

A - PROC              0          4         4

     SB4 - PROC       0          4

         SB4/P0                               Unused

         SB4/P1                               Unused

         SB4/P2                               Unused

         SB4/P3                               Unused

B - PROC              4          4         4

     SB6 - PROC       4          4

         SB6/P0                               Licensed

         SB6/P1                               Licensed

         SB6/P2                               Licensed

         SB6/P3                               Licensed

C - PROC              0          4         0

    SB12 - PROC       0          4

        SB12/P0                               Unused

        SB12/P1                               Unused

        SB12/P2                               Unused

        SB12/P3                               Unused

describes the COD resource information displayed by domain.

TABLE 6-4 `showcodusage` Domain Information
Item	Description
Domain/Resource	The COD resource (processor) for each domain. An unused processor is a COD CPU that has not yet been assigned to a domain.
In Use	The number of COD CPUs currently used in the domain
Installed	The number of COD CPUs installed in the domain
Reserved	The number of COD RTU licenses allocated to the domain
Status	One of the following CPU states: Licensed - The COD CPU has a COD RTU license. Unused -The COD CPU is not in use. Unlicensed - The COD CPU could not obtain a COD RTU license and is not in use.

To View COD Usage by Resource and Domain

1. In an SC window, log in as a platform administrator and type:

sc0:sms-user:> showcodusage -v

The information displayed contains usage information by both resource and domain. For example:

sc0:sms-user:> showcodusage -v

Resource:

=========

Resource  In Use  Installed  Licensed  Status

--------  ------  ---------  --------  ------

PROC           4          4        16  OK: 12 available

Domains:

========

Domain/Resource  In Use  Installed  Reserved  Status

---------------  ------  ---------  --------  ------

A - PROC              0          0         0

B - PROC              0          0         0

     SB6 - PROC       0          0

         SB6/P0                               Unused

         SB6/P1                               Unused

         SB6/P2                               Unused

         SB6/P3                               Unused

C - PROC              0          0         0

    SB12 - PROC       0          0

        SB12/P0                               Unused

        SB12/P1                               Unused

        SB12/P2                               Unused

        SB12/P3                               Unused

D - PROC              4          4         0

     SB4 - PROC       4          4

         SB4/P0                               Licensed

         SB4/P1                               Licensed

         SB4/P2                               Licensed

         SB4/P3                               Licensed

    SB16 - PROC       4          4

        SB16/P0                               Unused

        SB16/P1                               Unused

        SB16/P2                               Unused

        SB16/P3                               Unused

E - PROC              0          0         0

F - PROC              0          0         0

G - PROC              0          0         0

R - PROC              0          0         0

Unused - PROC         0          0        12

Deconfigured and Unlicensed COD CPUs

When you activate a domain that uses COD CPU/Memory boards, any COD CPUs that cannot obtain a COD RTU license are identified as deconfigured or unlicensed. You can determine which COD CPUs are deconfigured or unlicensed by reviewing the following items:

Message output for a setkeyswitch on operation

Any COD CPUs that did not aquire a COD RTU license are identified as deconfigured. If all the COD CPUs on a COD CPU/Memory board are deconfigured, the setkeyswitch on operation will fail the COD CPU/Memory board, and the setkeyswitch on operation also fails, as the next example shows:

sc0:sms-user:> setkeyswitch -d A on

Acquiring licenses for all good processors...

Proc SB03/P0    deconfigured: no license available.

Proc SB03/P2    deconfigured: no license available.

Proc SB03/P3    deconfigured: no license available.

Proc SB03/P1    deconfigured: no license available.

No minimum system left after Check CPU licenses (for COD)! Bailing out!

Deconfigure Slot0: 00008

Deconfigure EXB:   00008

POST (level=16, verbose=40, -H3.0) execution time 3:08

# SMI Sun Fire 15K POST log closed Fri Jul 26 15:15:53 2002

showcodusage(1M) command output

To obtain the status of COD CPUs for a domain, see To View COD Usage by Domain. The Unlicensed status indicates that a COD RTU license could not be obtained for the COD CPU and that the CPU is not being used by the domain.

Other COD Information

summarizes the COD configuration and event information that you can obtain through other system controller commands. For further details on these commands, refer to their descriptions in the System Management Services (SMS) 1.4 Reference Manual.

TABLE 6-5 Obtaining COD Component, Configuration, and Event Information
To...	Use This Command
Display information about COD events, such as license violations or headroom activation, that are logged on the platform console	`showlogs`
Display the current COD resource configuration: Number of instant access CPUs (headroom) in use Domain RTU license reservations Chassis HostID	`showplatform -p cod`