HP Instant Capacity User’s Guide for versions B.07.x Second Edition Manufacturing Part Number: B9073-90081 September 2005 United States © Copyright 2000-2005 Hewlett-Packard Development Company, L.P.
Legal Notices Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Publication History The manual publication date and part number indicate its current edition. The publication date is changed when a new edition is released. The manual part number is changed when extensive changes are made. To ensure that you receive the new editions, you should subscribe to the appropriate product support service. See your HP sales representative for details. IMPORTANT • First Edition: May 2005, B9073-90070, (HP Instant Capacity versions B.07.
Conventions in this Guide This guide uses these typographic conventions: Boldface Words defined for the first time appear in boldface. Computer Computer font indicates system commands, file names, and literal items — which may be displayed by the computer. For example: file not found User input Bold, computer text indicates literal items that you type.
Contents 1. About this guide Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How to Use this Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Documentation Feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents 3. Installing and Uninstalling Instant Capacity Software Installing Instant Capacity Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . For HP-UX 11i v1 and 11i v2 - Installing from the HP-UX Media . . . . . . . . . . . . . . For HP-UX 11i v1 and 11i v2 - Installing from the HP Software Depot . . . . . . . . . . For All Installations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Error for Unlicensed Activation with Insufficient Temporary Capacity . . . . . . . . . . Temporary Capacity Balance Needing Action. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Temporary Capacity Negative Balance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Temporary Capacity Enforcement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 86 87 87 6. Cell Board Instant Capacity Cell Board Instant Capacity . . . . . . . . . .
Contents Instant Capacity Integration with vPars — Supported Hardware Platforms . . . . Integrated Virtual Partition Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Boot Time Compliance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Compatible Virtual Partition Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Temporary Capacity and Virtual Partitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1 About this guide This chapter covers the following topics: • “Introduction” on page 10 • “Overview” on page 14 • “Instant Capacity Information” on page 20 For more in-depth information, see the manpage icod (5).
About this guide Introduction Introduction Welcome Welcome to the HP Instant Capacity User’s Guide for versions B.07.x. Hewlett-Packard’s Instant Capacity software product provides the ability to instantly increase or decrease computing capacity on specified HP enterprise servers. NOTE The name of the product has changed from Instant Capacity on Demand (or iCOD) to HP Instant Capacity for HP 9000 and HP Integrity Servers, also known as Instant Capacity or iCAP.
About this guide Introduction IMPORTANT Purchase of an RTU license may take one or more days. To avoid a delay in activation of additional processors, it is a good idea to purchase and keep in reserve some quantity of Temporary Instant Capacity for the system. Temporary Instant Capacity can be used to instantly activate processors while waiting for a permanent RTU license to be acquired. The Instant Capacity software product is a part of the HP Utility Pricing (formerly On Demand) Solutions program.
About this guide Introduction How to Use this Guide This user’s guide is not designed to be read from front to back in its entirety. To get a decent understanding of Instant Capacity versions B.07.x, you should read this chapter and Chapter 2 - Getting Started. After reading these two chapters, you can utilize the table of contents and index (in back) for specific topics of interest.
About this guide Introduction • Appendix B, Glossary explains Instant Capacity systems and software terms. • Appendix C, Manpages contains the actual manpages for icod, icod_modify, icod_notify, icod_stat, and icodd. Documentation Feedback We welcome any feedback that helps us improve the quality of our documentation. To provide feedback, go to the following HP web site: http://docs.hp.com/assistance/feedback.html Be sure to reference the Instant Capacity B.07.
About this guide Overview Overview Software Product Overview The Instant Capacity versions B.07.x software product associated with HP’s Utility Pricing Solutions program is: • iCOD: HP product number B9073BA Only versions B.07.x information is in this user’s guide. The Instant Capacity product has been available since March 2000 (version B.01.00). The versions B.07.x software can be obtained from the following HP web site (search for “Instant Capacity”): http://www.hp.
About this guide Overview Figure 1-1 Instant Capacity System Elements System Compliance iCAP DB Codeword Generation Record Purchase iCAP Admin System iCAP Web Portal HP Sales Rep.
About this guide Overview Instant Capacity System Hardware An Instant Capacity system’s hardware is generally made up of the following components: • Cell boards • Processors • Memory Every Instant Capacity system contains a combination of the above components that are either licensed (and available for activation) or unlicensed.
About this guide Overview Instant Capacity Database The Instant Capacity database is a repository that tracks system compliance and provides the information for codeword generation. Other System Management Commands Other system management commands (for example, vparmodify, parCLI and parMgr) provide an interface to modify system configuration which affects license use and Instant Capacity compliance.
About this guide Overview Table 1-1 Software and Version iCOD B.11.11.07.01 (B9073BA) 18 Most Recent Instant Capacity Versions and Supported Platforms (Continued) Operating System Version HP-UX 11i v1 Supported Hardware Platforms hp 9000 servers: • Superdome • rp8420 • rp8400 • rp7420 • rp7410 Notes Available on: • http://www.hp.
About this guide Overview Past Instant Capacity Versions and Supported Operating Systems Instant Capacity Versions Previous versions of the Instant Capacity software are: Chapter 1 • B.01.00 (on HP-UX 11.00) • B.02.x (on HP-UX 11.00 and 11i v1) • B.03.x (on HP-UX 11i v1) • B.04.x (on HP-UX 11.00 and 11i v1) • B.05.00 (on HP-UX 11.00 and 11i v1) • B.06.
About this guide Instant Capacity Information Instant Capacity Information Instant Capacity User’s Guide History This is the first edition of the HP Instant Capacity User’s Guide for versions B.07.x. Locating the Instant Capacity User’s Guide for versions B.07.x You can find the HP Instant Capacity User’s Guide for versions B.07.
About this guide Instant Capacity Information • In the Instant Capacity B.07.x software product, located in: /usr/share/doc/icodRelNotes.pdf. Note, this is an early version of this document. For the most recent information see the release notes on http://docs.hp.com.
About this guide Instant Capacity Information 22 Chapter 1
2 Getting Started This chapter covers the following topics: • “Instant Capacity Requirements” on page 24 • “Instant Capacity Components” on page 29 • “Instant Capacity Codewords” on page 31 • “Instant Capacity Compliance and Enforcement” on page 32 • “Processor Configuration Change Notification” on page 34 • “Processor Activation” on page 35 • “Temporary Instant Capacity (TiCAP)” on page 37 • “Cell Board Instant Capacity” on page 38 • “Instant Capacity Software Validation” on page 39 • “
Getting Started Instant Capacity Requirements Instant Capacity Requirements Program Requirements You must comply with the following HP Utility Pricing Solutions conditions to participate in the Instant Capacity versions B.07.
Getting Started Instant Capacity Requirements HP-UX 11i v1 Requirements For Instant Capacity Versions B.07.x on HP-UX 11i v1 The following software is required for Instant Capacity versions B.07.x on HP-UX 11i v1: ❏ HP-UX 11i v1 September 2005 update, or later ❏ iCOD software bundle B9073BA (versions B.07.x) — installed automatically when the HP-UX 11i v1 Operating Environment (OE) is installed ❏ The kernel configuration must include the diag2 module ❏ WBEM B8465BA bundle (version A.02.
Getting Started Instant Capacity Requirements HP-UX 11i v2 Requirements For Versions B.07.x on HP-UX 11i v2 NOTE The following software is required for Instant Capacity versions B.07.x on HP-UX 11i v2: ❏ HP-UX 11i v2 May 2005 update, or later ❏ iCOD software bundle B9073BA (versions B.07.x) — installed automatically when the HP-UX 11i v2 Operating Environment (OE) is installed ❏ The kernel configuration must include the diag2 module ❏ WBEM B8465BA bundle (version A.01.
Getting Started Instant Capacity Requirements reports. The icod_stat command displays the current configuration for asset reporting. You turn asset reporting on or off with the icod_notify -a command. For details about how to configure e-mail connectivity, see “Configuring E-Mail on Instant Capacity Systems” on page 143. Roles Requirement Your organization may designate a person to fill a system-contact role for the successful management of Instant Capacity systems.
Getting Started Instant Capacity Requirements After the RTU codeword is retrieved from the web portal, the RTU codeword is applied by the use of the icod_modify command, with the -C option. Applying the codeword enables you to use additional components as specified by the license.
Getting Started Instant Capacity Components Instant Capacity Components Overview The Instant Capacity software monitors and enforces compliance with licensing agreements. It authorizes or denies activation of system components (CPUs, cells, memory) based on a complex-wide license database. See “License Requirement” on page 27 for details on licensing components. Activation of components is restricted according to complex-wide compliance.
Getting Started Instant Capacity Components Cell Boards Instant Capacity offers you a way to have additional (inactive) cell board capacity in your system for growing business needs. When the need arises, these cell boards, which contain memory and processors, are available for instant activation and use after purchasing a license from HP and applying a RTU codeword. The cell board, memory, and processors are each licensed separately.
Getting Started Instant Capacity Codewords Instant Capacity Codewords Instant Capacity B.07.x uses codewords as a licensing mechanism for system components. That is, prior to activating unlicensed components, a right-to-use (RTU) codeword must be applied to the system. A license must be purchased from HP prior to receiving a RTU codeword. Codewords are retrieved from the Utility Pricing Solutions web portal.
Getting Started Instant Capacity Compliance and Enforcement Instant Capacity Compliance and Enforcement The Instant Capacity software maintains complex-wide information about the licensing and activation of system components. The software monitors the number of unlicensed and licensed components for the entire complex. The Instant Capacity software authorizes activation at will of processors, cells, and memory if allowed by the system license counts.
Getting Started Instant Capacity Compliance and Enforcement — In an integrated virtual partition environment, preventing a virtual partition from booting if the number of assigned processors is greater than the number of intended active processors for the nPartition (see “Boot Time Compliance” on page 136) Chapter 2 33
Getting Started Processor Configuration Change Notification Processor Configuration Change Notification Specifying an increase or decrease in the number of active processors — using the icod_modify command — causes a processor configuration change. A notification e-mail is sent to the system-contact when a processor configuration change occurs.
Getting Started Processor Activation Processor Activation As previously mentioned, an Instant Capacity system contains a specified quantity of activated processing capacity (cells, processors, and memory) and a specified amount of deactivated processing capacity. Not all components that may be activated need be active. Components that are allowed by license counts may be deactivated for various reasons, and can be instantly activated at need.
Getting Started Processor Activation IMPORTANT 36 To avoid a delay in activation of additional processors, it is a good idea to purchase and keep in reserve some quantity of Temporary Instant Capacity for the system. Temporary Instant Capacity can be used to instantly and temporarily activate processors while waiting for a permanent RTU license to be acquired, as in Step 1. See Chapter 5 for details about Temporary Instant Capacity.
Getting Started Temporary Instant Capacity (TiCAP) Temporary Instant Capacity (TiCAP) You can purchase an amount of processor temporary capacity in your Instant Capacity system. Temporary capacity is purchased in units of multiple processor-days. Temporary capacity allows one or more processors above the normal license count to be activated for up to the specified period of prepaid processor minutes, without requiring the purchase of the processor.
Getting Started Cell Board Instant Capacity Cell Board Instant Capacity Cell Board Instant Capacity allows you to have additional (inactive) cell board capacity in your system for growing business needs. When the need arises, licensed cell boards, which contain memory and processors, are then available for instant activation and use. The Instant Capacity software monitors and enforces the count of inactive cell boards throughout the complex.
Getting Started Instant Capacity Software Validation Instant Capacity Software Validation The Instant Capacity software versions B.07.x (HP product B9073BA) are installed by HP manufacturing on instantly ignited systems. The Instant Capacity software can also be installed by an HP service representative on existing (supported) HP enterprise servers as an add-on. NOTE The Instant Capacity software is automatically installed when the HP-UX 11i v2 or 11i v1 Operating Environment (OE) is installed.
Getting Started Instant Capacity System Status Reporting Instant Capacity System Status Reporting You can use the icod_stat command to view the status of your Instant Capacity system.
Getting Started Timezone for icodd Daemon Timezone for icodd Daemon The icodd daemon performs routine Instant Capacity software tasks at noon and midnight on a daily basis. A partition’s local timezone setting affects what timezone the icodd daemon uses for the timing of noon and midnight. Because the icodd daemon is started by init, the /etc/default/tz file needs to contain the desired timezone specification. By default, the timezone is set to EST5EDT.
Getting Started Timezone for icodd Daemon 42 Chapter 2
3 Installing and Uninstalling Instant Capacity Software This chapter covers the following topics: Chapter 3 • “Installing Instant Capacity Software” on page 44 below • “Reinstalling Instant Capacity Software” on page 47 • “Uninstalling Instant Capacity Software” on page 48 43
Installing and Uninstalling Instant Capacity Software Installing Instant Capacity Software Installing Instant Capacity Software Factory Integrated You do not need to install the Instant Capacity software if your Systems processors and software were ordered with your HP enterprise server. The Instant Capacity software was already installed by HP prior to delivery.
Installing and Uninstalling Instant Capacity Software Installing Instant Capacity Software For HP-UX 11i v1 and 11i v2 - Installing from the HP-UX Media Follow this procedure to install the Instant Capacity B.07.x software on your HP-UX 11i v2 system from either the appropriate HP-UX Applications Software or Operating Environment media: Step 1. Log in as root. Step 2. Determine the DVD drive device file by entering the following command: ioscan -fnC disk Step 3.
Installing and Uninstalling Instant Capacity Software Installing Instant Capacity Software For All Installations After you have successfully installed the Instant Capacity B.07.x software using the swinstall command, perform the following procedure to validate your installation: Step 1. Execute the command: /usr/sbin/icod_stat Step 2. Verify that the icod_stat command’s output indicates the correct number of licensed and unlicensed components for cells, processors, and memory.
Installing and Uninstalling Instant Capacity Software Reinstalling Instant Capacity Software Reinstalling Instant Capacity Software Preserving current Instant Capacity information If you reinstall HP-UX on a partition with Instant Capacity (for example, installing HP-UX by either cold-installing or installing from a “golden image”), all information in the Instant Capacity configuration file disappears unless you do the following: 1.
Installing and Uninstalling Instant Capacity Software Uninstalling Instant Capacity Software Uninstalling Instant Capacity Software IMPORTANT 48 The Instant Capacity B.07.x software should not be uninstalled. You should not attempt to remove it.
4 Using Instant Capacity to Manage Processing Capacity This chapter covers the following topics: Chapter 4 • “Checking the Status of your Instant Capacity System” on page 50 • “Setting System-Contact Information” on page 53 • “Applying a Right-To-Use (RTU) Codeword” on page 54 • “Activating Processors” on page 56 • “Deactivating Processors” on page 59 • “Overriding Deferred Processor Activations and Deactivations” on page 61 • “Load-Balancing Active Processors” on page 63 • “Assigning a Ce
Using Instant Capacity to Manage Processing Capacity Checking the Status of your Instant Capacity System Checking the Status of your Instant Capacity System You can use the icod_stat command to view the status of your Instant Capacity system.
Using Instant Capacity to Manage Processing Capacity Checking the Status of your Instant Capacity System — Temporary capacity available — Processors using temporary capacity — Projected temporary capacity expiration • Complex-wide allocation of Instant Capacity resources among partitions: — nPar ID — Inactive cells — Inactive memory — Inactive processors — nPar name • Complex-wide Instant Capacity partition configuration information: — nPar ID — Intended active processors — Actual active processors — Tot
Using Instant Capacity to Manage Processing Capacity Checking the Status of your Instant Capacity System Sample Session of icod_stat /usr/sbin/icod_stat Software version: System ID: Serial Number: Product Number: Unique ID: System contact e-mail: From e-mail: Asset reporting: Temporary capacity warning Exception status: B.07.00 supericod 1234567890 A7026A fffff-fff-ffffff-ffff mjones@corp.com icap@corp.
Using Instant Capacity to Manage Processing Capacity Setting System-Contact Information Setting System-Contact Information It is recommended that you specify a system-contact’s e-mail address on each partition in your system.
Using Instant Capacity to Manage Processing Capacity Applying a Right-To-Use (RTU) Codeword Applying a Right-To-Use (RTU) Codeword IMPORTANT Codewords must be applied in the sequence in which they are obtained. Licensing a Processor An inactive processor must be licensed prior to activation. The Instant Capacity licensing procedure is as follows: Step 1.
Using Instant Capacity to Manage Processing Capacity Applying a Right-To-Use (RTU) Codeword NOTE Chapter 4 The application of the codeword increments the count of Licensed processors that can be activated in the output of the icod_stat command.
Using Instant Capacity to Manage Processing Capacity Activating Processors Activating Processors The icod_modify command provides the ability to increase processing capacity instantly by activating licensed processors in nPartitions (hard partitions) of Instant Capacity systems. At any time, any number of inactive (licensed) processors can be activated, in accordance with complex-wide compliance.
Using Instant Capacity to Manage Processing Capacity Activating Processors Constraints The Instant Capacity software will not activate a processor that is marked for deconfiguration. Also, you cannot use Instant Capacity to activate more processors than are configured in the current nPartition. If you want more, you need to modify the nPartition with the parmodify command.
Using Instant Capacity to Manage Processing Capacity Activating Processors Instant Capacity Activation Example Session The following example shows you how to activate an additional licensed processor. At the beginning of this activation session, there are a total of 4 processors in the partition; 2 processors are activated and 2 are inactive licensed processors.
Using Instant Capacity to Manage Processing Capacity Deactivating Processors Deactivating Processors Deactivating Processors in nPartitions You have the ability to decrease processor capacity instantly on HP enterprise servers with the Instant Capacity software. Any number of active processors can be deactivated at any time, within the partition constraints listed below. Processor deactivation can be useful for load balancing processors in nPartitions (hard partitions) of Instant Capacity systems.
Using Instant Capacity to Manage Processing Capacity Deactivating Processors Deactivation Example Session for Hardware-partitionable Systems The following example shows you how to deactivate an active processor. At the beginning of this deactivation session, there are a total of 4 processors in the partition; 3 processors are active and 1 is inactive. In this example, 1 active processor is deactivated, leaving the partition with 2 active processors and 2 inactive processors.
Using Instant Capacity to Manage Processing Capacity Overriding Deferred Processor Activations and Deactivations Overriding Deferred Processor Activations and Deactivations NOTE Only activation of processors is discussed in this section, but the discussion applies equally to the deactivation of processors.
Using Instant Capacity to Manage Processing Capacity Overriding Deferred Processor Activations and Deactivations Example 4-6 Undoing an Accidental Deferred Processor Activation 1. On your system or partition you currently have 2 processors activated and 2 processors inactive. You accidentally perform a deferred activation for 1 additional active processor by entering the following command: /usr/sbin/icod_modify -D -a 1 2.
Using Instant Capacity to Manage Processing Capacity Load-Balancing Active Processors Load-Balancing Active Processors Active processors can be redistributed across any or all partitions of a hardware-partitionable system if those partitions contain inactive processors.
Using Instant Capacity to Manage Processing Capacity Assigning a Cell to a Partition Assigning a Cell to a Partition NOTE Only licensed cells (containing fully licensed memory and at least one licensed processor) can be active in a partition. When a cell is assigned to a partition in an Instant Capacity system, depending on the number of licensed processors available in the system when the cell is assigned, the number of intended active processors for the partition automatically changes.
Using Instant Capacity to Manage Processing Capacity Assigning a Cell to a Partition In general, when an unassigned cell is assigned to a partition, the Instant Capacity software determines the number of unassigned processors in the complex that are licensed. The Instant Capacity software uses these licenses to activate as many processors as possible in the new cell. NOTE Chapter 4 Cell boards are assigned to specific partitions and cannot be shared between partitions.
Using Instant Capacity to Manage Processing Capacity Unassigning a Cell from a Partition Unassigning a Cell from a Partition When a cell is unassigned from a partition in a system with Instant Capacity, the number of intended active processors in the partition decreases only if the number of processors being removed with the cell is greater than the number of unlicensed processors in the partition.
Using Instant Capacity to Manage Processing Capacity Unassigning a Cell from a Partition In the next example of unassigning a cell from a partition, the number of processors removed (4) is greater than the number of unlicensed processors in the partition (3). When this happens, the number of intended active processors is automatically set to the total number of remaining processors in the partition (8).
Using Instant Capacity to Manage Processing Capacity Unassigning a Cell from a Partition NOTE 68 If your intent is to migrate a cell from one partition to another, you can control the number of licensed processors available to the cell by deactivating processors in the partition you removed the cell from. By deactivating processors, you are essentially freeing up processor licenses in the entire complex.
Using Instant Capacity to Manage Processing Capacity Software Application Considerations Software Application Considerations Some software applications size themselves based on the number of available processors when the application is started. If an application is running when an additional processor is activated, it may not recognize the newly activated processor as an available processor.
Using Instant Capacity to Manage Processing Capacity Processor Test Activation on Instant Capacity Systems Processor Test Activation on Instant Capacity Systems You may want to test your software application for proper operation and improved performance by activating an additional processor. The use of temporary capacity (TiCAP) is required for activation of an unlicensed processor for testing purposes. See Chapter 5, “Temporary Instant Capacity for Unlicensed Processors,” on page 73 for details.
Using Instant Capacity to Manage Processing Capacity Replacement of Failed Processors Replacement of Failed Processors LPMC and HPMC If an active processor fails with a Low Priority Machine Check (LPMC), in a partition with Instant Capacity, its processor capacity is replaced instantly by an inactive processor, if any are available in the partition. The failed processor is marked for deconfiguration during the next system reboot.
Using Instant Capacity to Manage Processing Capacity Replacement of Failed Processors If there are multiple active processors in your system, one of them is designated as the monarch processor, and the other (non-monarch) processors can be replaced online. If the monarch processor fails, it cannot be replaced without a reboot.
5 Temporary Instant Capacity for Unlicensed Processors This chapter covers the following topics: Chapter 5 • “Temporary Instant Capacity Overview” on page 74 • “Ordering Temporary Instant Capacity” on page 76 • “Using Temporary Instant Capacity” on page 77 • “Tracking the Usage of Temporary Instant Capacity” on page 80 • “Temporary Instant Capacity Warning Period” on page 83 • “Temporary Instant Capacity Expiration and License Enforcement” on page 84 • “Temporary Instant Capacity Exceptions”
Temporary Instant Capacity for Unlicensed Processors Temporary Instant Capacity Overview Temporary Instant Capacity Overview You can purchase an amount of temporary capacity (TiCAP) time for currently unlicensed (and inactive) processors in your Instant Capacity system. Temporary capacity can be purchased in units of multiple processor-days.
Temporary Instant Capacity for Unlicensed Processors Temporary Instant Capacity Overview IMPORTANT Chapter 5 Temporary Instant Capacity can only be used to activate Instant Capacity processors on a temporary basis. It cannot be used to activate Instant Capacity cell boards or Instant Capacity memory.
Temporary Instant Capacity for Unlicensed Processors Ordering Temporary Instant Capacity Ordering Temporary Instant Capacity To add temporary capacity credits to a system that contains Instant Capacity processors, order the desired quantity of the temporary capacity product for your type of server. The system serial number is required for orders of temporary capacity. Instant Capacity processors that are added on to an existing system may not automatically include any temporary capacity.
Temporary Instant Capacity for Unlicensed Processors Using Temporary Instant Capacity Using Temporary Instant Capacity Acquiring and Configuring Temporary Instant Capacity To add temporary capacity to a system that contains Instant Capacity processors, follow this procedure: Step 1. Order the desired amount of temporary capacity for your type of server by submitting a purchase order to HP. You must specify the system serial number.
Temporary Instant Capacity for Unlicensed Processors Using Temporary Instant Capacity Step 4. Optional: if you wish to view temporary capacity balances on the portal, configure your partition for e-mail connectivity to HP. See “Configuring E-Mail on Instant Capacity Systems” on page 143 for details. Utilizing Temporary Instant Capacity Auditing of temporary capacity is done at the complex level on Instant Capacity systems that support partitioning.
Temporary Instant Capacity for Unlicensed Processors Using Temporary Instant Capacity To deactivate one or more processors in an nPartition, use the icod_modify -d command.
Temporary Instant Capacity for Unlicensed Processors Tracking the Usage of Temporary Instant Capacity Tracking the Usage of Temporary Instant Capacity The icod_stat command provides the following temporary capacity information: • Amount of temporary capacity remaining (in days, hours, and minutes) • Number of processors using temporary capacity — this is the number of active processors that are not licensed • Projected temporary capacity expiration date and time — this is based on the current temporar
Temporary Instant Capacity for Unlicensed Processors Tracking the Usage of Temporary Instant Capacity Temporary Capacity Expiration Reminder The Instant Capacity software calculates when the temporary capacity balance will expire, based on the current consumption rate.
Temporary Instant Capacity for Unlicensed Processors Tracking the Usage of Temporary Instant Capacity See the iCOD User's Guide at /usr/share/doc/icodUserGuide.pdf for more information. Also note that the output from icod_stat during the warning period includes a warning about the expiration of temporary capacity.
Temporary Instant Capacity for Unlicensed Processors Temporary Instant Capacity Warning Period Temporary Instant Capacity Warning Period By default, the Instant Capacity software will send the expiration reminder when the temporary capacity balance is projected to expire within 15 days or less. You can adjust that warning period by specifying a different value with the icod_modify command, using the -w option.
Temporary Instant Capacity for Unlicensed Processors Temporary Instant Capacity Expiration and License Enforcement Temporary Instant Capacity Expiration and License Enforcement IMPORTANT If you leave unlicensed processors activated beyond the purchased temporary capacity duration, the software will automatically deactivate one or more processors on the next reboot of any partition in the complex.
Temporary Instant Capacity for Unlicensed Processors Temporary Instant Capacity Expiration and License Enforcement Purchasing an additional right-to-use (RTU) processor license for the system clears out any previous violation of Temporary Instant Capacity.
Temporary Instant Capacity for Unlicensed Processors Temporary Instant Capacity Exceptions Temporary Instant Capacity Exceptions Error for Unlicensed Activation with Insufficient Temporary Capacity You cannot activate an Instant Capacity processor with temporary capacity unless there is a sufficient balance of temporary capacity on the system. To increase the temporary capacity balance, see “Acquiring and Configuring Temporary Instant Capacity” on page 77 for details.
Temporary Instant Capacity for Unlicensed Processors Temporary Instant Capacity Exceptions Temporary Capacity Negative Balance A complex is out of compliance with the Instant Capacity contract if a negative balance of temporary capacity occurs. The Instant Capacity software sends an exception report (via e-mail) if there is a negative balance of temporary capacity. Exception information is also written to the syslog file.
Temporary Instant Capacity for Unlicensed Processors Temporary Instant Capacity Exceptions Example 5-6 Error Message for Temporary Capacity Partial Enforcement To: root@par1.yourorg.com Subject: iCOD license enforcement notice This message is being sent to inform you that, due to expiration of temporary capacity, 1 additional CPUs were deactivated on your iCOD system (containing the partition par1) to bring the system into compliance with iCOD licensing.
Temporary Instant Capacity for Unlicensed Processors Temporary Instant Capacity Exceptions Example 5-7 Error Message for Temporary Capacity Complete Enforcement To: root@par1.yourorg.com Subject: iCOD license enforcement notice This message is being sent to inform you that, due to expiration of temporary capacity, 1 CPUs were deactivated on your iCOD system (containing the partition par1) to bring the system into compliance with iCOD licensing.
Temporary Instant Capacity for Unlicensed Processors Temporary Instant Capacity Exceptions 90 Chapter 5
6 Cell Board Instant Capacity This chapter covers the following topics: Chapter 6 • “Cell Board Instant Capacity” on page 92 • “Ordering Cell Board Instant Capacity” on page 94 • “HP-UX License and Support” on page 95 • “Licensing an Instant Capacity Cell Board” on page 96 • “Instant Capacity Cell Board Licensing Examples” on page 97 • “Activation of an Instant Capacity Cell Board” on page 100 • “Accidental Activation of an Instant Capacity Cell Board” on page 102 • “Instant Capacity Cell
Cell Board Instant Capacity Cell Board Instant Capacity Cell Board Instant Capacity Overview Cell Board Instant Capacity offers you a way to have additional (inactive) cell board capacity in your system for growing business needs. When the need arises, cell boards, which contain memory and processors, can be licensed for activation and use.
Cell Board Instant Capacity Cell Board Instant Capacity After a cell board has been activated, all of the processors on the cell board are available for licensing and potential activation. Depending on the current number of licensed and unlicensed processors on your system, you may need to license additional processors in order to activate additional processors from the newly activated cell board.
Cell Board Instant Capacity Ordering Cell Board Instant Capacity Ordering Cell Board Instant Capacity To order the Cell Board Instant Capacity product you need to do the following: NOTE • Order the appropriate HP product number for the cell board for your specific class of HP server • Order the appropriate HP product number for the entire amount of Instant Capacity memory on the cell board • Order the appropriate HP product numbers and the quantities of licensed and unlicensed processors on the cell
Cell Board Instant Capacity HP-UX License and Support HP-UX License and Support You do not initially pay for HP-UX license and support fees on an Instant Capacity cell board. When you license a cell board, you must additionally pay for the incremental HP-UX license and support costs for each processor that is activated. That is, the HP-UX license and support costs are based on a “per active processor” basis and not included in the licensing of the cell board.
Cell Board Instant Capacity Licensing an Instant Capacity Cell Board Licensing an Instant Capacity Cell Board After you purchase an Instant Capacity cell board, its memory, and (optionally) processors, HP sends you a letter that contains details on how to acquire RTU codewords for the purchased components. The letter also describes how to apply the codewords to the system so the components are licensed.
Cell Board Instant Capacity Instant Capacity Cell Board Licensing Examples Instant Capacity Cell Board Licensing Examples There must be at least one licensed processor available for an Instant Capacity cell board you wish to license. However, this does not necessarily mean a processor needs to be licensed or that the total number of licensed processors increases.
Cell Board Instant Capacity Instant Capacity Cell Board Licensing Examples Example 6-1 Licensing a Cell Board without increasing the number of licensed processors For example, if you have an nPartition with two cell boards that have four active processors on the active cell board, and an inactive cell board with four unlicensed processors, licensing the inactive cell board results in two licensed processors per cell board.
Cell Board Instant Capacity Instant Capacity Cell Board Licensing Examples Example 6-2 Licensing a Cell Board that requires increasing the number of licensed processors In a different scenario, licensing of a cell board can cause the number of licensed processors to be below the minimum required (one licensed processor per cell board) and necessitate the licensing of an additional processor.
Cell Board Instant Capacity Activation of an Instant Capacity Cell Board Activation of an Instant Capacity Cell Board An Instant Capacity cell board is usually assigned to an nPartition; however, it does not participate in the boot of the nPartition. Activating an Instant Capacity cell board that is licensed is a two step process: Step 1. Set the cell board’s use-on-next-boot flag to “y” (yes) using the parmodify command Step 2.
Cell Board Instant Capacity Activation of an Instant Capacity Cell Board See the HP System Partitions Guide for details about adding and configuring cells in nPartitions.
Cell Board Instant Capacity Accidental Activation of an Instant Capacity Cell Board Accidental Activation of an Instant Capacity Cell Board If you inadvertently activate an Instant Capacity cell board, you can de-activate it by following this two step procedure: Step 1. Set the cell board’s use-on-next-boot flag to “n” (no) using the parmodify command Step 2.
Cell Board Instant Capacity Instant Capacity Cell Board Activation Exception Error Instant Capacity Cell Board Activation Exception Error When you attempt to activate an Instant Capacity cell board in an nPartition, depending on the number of licensed processors that are currently available in the complex, there is a chance the number of intended active processors for the nPartition is out of compliance and the activation fails.
Cell Board Instant Capacity Cell Board Instant Capacity and Temporary Instant Capacity Cell Board Instant Capacity and Temporary Instant Capacity You can activate processors with temporary capacity (TiCAP) in a licensed cell board; however, you cannot activate processors with temporary capacity in an unlicensed cell board. Instant Capacity cell board licensing is also required for permanent activation of processors.
7 Troubleshooting This chapter covers the following topics: Chapter 7 • “Handling Compliance Exceptions” on page 106 • “Troubleshooting the Instant Capacity Software” on page 109 • “Diagnosing E-mail Configuration” on page 111 105
Troubleshooting Handling Compliance Exceptions Handling Compliance Exceptions A complex can get out of compliance with the Instant Capacity contract if any of the following occurs: NOTE • More cells are active than expected (not enough inactive cells) • More memory is active than expected (not enough inactive memory) • More processors are active than expected (not enough inactive processors) • There is a negative temporary capacity balance Your system may be out of compliance due to having differ
Troubleshooting Handling Compliance Exceptions Example 7-1 Exception Report for More Processors Active than Expected To: root@par1.yourorg.com Subject: iCOD Exception Report This message is being sent to inform you that your iCOD system (containing the partition, par1) is in an exception state based on the following detected exceptions: More processors active than expected This system is out of compliance with the iCOD contract. must be corrected as soon as possible.
Troubleshooting Handling Compliance Exceptions Example 7-2 Content of Exception Report for More Cells Active than Expected More cells active than expected 'More cells active than expected' means that one or more unlicensed iCOD cells have been detected to be in use. To find out how many inactive cells are expected on the system, run icod_stat and look at the expected number of iCOD cells.
Troubleshooting Troubleshooting the Instant Capacity Software Troubleshooting the Instant Capacity Software In the event the Instant Capacity software is not functioning, perform the following steps: Step 1. Verify that the Instant Capacity software is installed and not corrupted by entering the following command: /usr/sbin/swverify B9073BA You should see Verification succeeded. in the output of the swverify command. Step 2.
Troubleshooting Troubleshooting the Instant Capacity Software Step 7. Ensure that the WBEM B8465BA bundle (version A.01.05 or higher) is installed. Step 8. Make sure par commands such as parstatus are working. For failures in virtual partitions, check the vPar commands such as vparstatus. Step 9. Check the Instant Capacity log file (/var/adm/icod.log) and the syslog (/var/adm/syslog/syslog.log) for any error messages.
Troubleshooting Diagnosing E-mail Configuration Diagnosing E-mail Configuration You can use the following steps to confirm the e-mail configuration or to aid in debugging the configuration: Step 1. Send an e-mail message from your system to an e-mail address in the same domain (intranet) and confirm receipt of the e-mail message. Step 2.
Troubleshooting Diagnosing E-mail Configuration 112 Chapter 7
8 Frequently Asked Questions This chapter covers frequently asked questions on the following topic: • Chapter 8 “Instant Capacity Software” on page 114 113
Frequently Asked Questions Instant Capacity Software Instant Capacity Software What software product is required for Instant Capacity on Itanium-based servers running HP-UX 11i v2? The HP software bundle for the Instant Capacity versions B.07.x software, on Itanium-based servers running HP-UX 11i v1 or 11i v2, is HP product number B9073BA.
Frequently Asked Questions Instant Capacity Software One of my HP-UX applications has compatibility issues with the Instant Capacity software. How do I correct the problem? The application may have a problem when processors are activated or deactivated. Some applications size themselves at system startup based on the number of active processors and they don’t adjust for processor increases or decreases. See “Software Application Considerations” on page 69 for details.
Frequently Asked Questions Instant Capacity Software How can I obtain codewords for unlicensed components if the Utility Pricing Solutions portal is down? If the Utility Pricing Solutions portal is down, contact the HP Response Center. The Response Center can create an emergency codeword via the Instant Capacity codeword backup tool. If you do not receive a timely response from the HP Response Center, contact the Instant Capacity administrator by sending an e-mail message to: icap_admin@hp.com.
Frequently Asked Questions Instant Capacity Software How does Instant Capacity interact/coexist with partitions running software other than HP-UX? Instant Capacity is only supported on HP-UX. If other partitions of an Instant Capacity system are running another operating system, then the Instant Capacity software assumes that all the system components in the non-HP-UX partitions are active licensed components.
Frequently Asked Questions Instant Capacity Software If asset reporting is configured, and the system has e-mail connectivity to HP, these messages are sent to HP: Table 8-2 Asset reporting e-mail sent by the Instant Capacity software Triggered By 118 E-mail Message icod_notify (on demand) An asset report is sent to the reply address, root, and HP (the asset report sent to HP is encrypted). System startup and system shutdown An encrypted asset report is sent to HP.
A Special Considerations This appendix covers the following topics: Appendix A • “Assumed Values in icod_stat” on page 120 • “Upgrading to Instant Capacity versions B.06.x or B.07.
Special Considerations Assumed Values in icod_stat Assumed Values in icod_stat The icod_stat command may make assumptions on the number of active processors and amount of active memory, depending on certain system conditions. If values are assumed, the icod_stat command’s output contains an asterisk next to the appropriate field.
Special Considerations Assumed Values in icod_stat If a non-local partition appears to be inactive, the number of active processors reported by the icod_stat command is zero. For example, if the hardware for a non-local partition is inactive, icod_stat considers the partition as inactive and reports the number of active processors as zero.
Special Considerations Upgrading to Instant Capacity versions B.06.x or B.07.x Software Upgrading to Instant Capacity versions B.06.x or B.07.x Software The first time a version of the new B9073BA Instant Capacity software (B.06.00 or later) is loaded onto a system where the old B9073AA software (version B.03.x through B.05.x) has been in use, the new software requires the system to go through an upgrade process.
Special Considerations Upgrading to Instant Capacity versions B.06.x or B.07.x Software Step 2. Go to the HP Utility Pricing Solutions web portal: http://hp.com/go/icod/portal. Log into the portal and click on the link to get codewords. Step 3. Click on the Upgrade Codeword link to get an upgrade codeword. Step 4. Supply the requested information from the icod_stat -s command output gathered in Step 1 and get the upgrade codeword from the portal. You need the codeword in the next step. Step 5.
Special Considerations Upgrading to Instant Capacity versions B.06.x or B.07.x Software Step 8. If the Exception status in Step 7 indicates that there are more processors, cells, or memory active than expected, you need to deactivate the appropriate number of each component in order to bring the system into compliance with the Instant Capacity contract. Step 9. From the output in Step 7, verify that the correct system-contact information is specified.
Special Considerations Dual Core Support in Instant Capacity Systems Dual Core Support in Instant Capacity Systems With dual core processing, each cell board has four sockets and each socket accepts a CPU module that contains two processor cores. You can upgrade an Instant Capacity Superdome system to a dual core system by replacing the cell boards and processors. Contact your HP service representative for details on upgrading to dual core processors. The Instant Capacity versions B.07.
Special Considerations New Partition Creation and Instant Capacity New Partition Creation and Instant Capacity You can assign a cell to an existing partition even if the cell contains unlicensed processors. In this case, it can be verified that the partition has valid Instant Capacity software installed, and that the partition is running an operating system capable of activating and deactivating processors.
Special Considerations Implications of Removing a Cell from an Instant Capacity System Implications of Removing a Cell from an Instant Capacity System The Instant Capacity software tracks the expected number of inactive components (processors, cells, and memory) in a complex and knows the actual number of active and inactive components. The complex is in compliance if the actual number of inactive components meets or exceeds the expected number of inactive components.
Special Considerations Implications of Removing a Cell from an Instant Capacity System Table A-1 State Removing a Cell — Decrease Inactive Processors Partition (Cell) 0 Partition (Cell) 1 Notes Before Cell 0 is Removed 2 active 2 inactive 2 active 2 inactive 4 inactive processors expected (in compliance) After Cell 0 is Removed 0 active 0 inactive 2 active, 2 inactive 4 inactive processors expected (out of compliance) In the above example, because the removed cell causes the complex to be out o
Special Considerations Shutting Down a Partition with Instant Capacity Processors Shutting Down a Partition with Instant Capacity Processors The Instant Capacity software saves information about the number of active processors for each partition and this information expires over time. If the partition is not active (but the hardware is powered up), Instant Capacity software on other partitions assumes that all processors in the inactive partition are active.
Special Considerations Instant Capacity and Re-Initializing the nPartition (Genesis Partitions) Instant Capacity and Re-Initializing the nPartition (Genesis Partitions) Any use of the CC command at the service processor level has the potential to overwrite all Instant Capacity configuration, including information about any temporary capacity balance, and is therefore not recommended on Instant Capacity systems.
Special Considerations par Commands from PC System Management Station (SMS) par Commands from PC System Management Station (SMS) A HP-UX partition is required to perform changes to the complex, that could affect the Instant Capacity state of the complex, using par commands (parmodify or parcreate). Therefore, if a par command is executed on an Instant Capacity complex from a PC System Management Station (SMS), the command must be directed towards a HP-UX partition in order to succeed.
Special Considerations Instant Capacity Integration with Virtual Partitions Instant Capacity Integration with Virtual Partitions Overview In a virtual partition environment, processors that are not assigned to any virtual partition are considered inactive (in addition to other classes of inactive processors). Activations and deactivations of processors are accomplished by adding and removing dynamic (unbound) processors to/from a virtual partition.
Special Considerations Instant Capacity Integration with Virtual Partitions environment” because the Instant Capacity software co-exists with the virtual partition software, with a lesser degree of coordination between the two products. The Instant Capacity software must be installed on all virtual partitions in an Instant Capacity system. See the Installing and Managing HP-UX Virtual Partitions manual for details of virtual partitions. This manual can be found on the HP web site: http://docs.hp.
Special Considerations Instant Capacity Integration with Virtual Partitions Instant Capacity Integration with vPars — Supported Hardware Platforms Table A-2 Software and Version iCOD B.11.23.07.00 (B9073BA) iCOD Integration with vPars — Supported Hardware Platforms Operating System Version HP-UX 11i v2 Supported Hardware Platforms hp Integrity servers: • Superdome • rx8620 • rx7620 Requirements vPar software version A.04.01 or greater is required hp 9000 servers: iCOD B.11.11.07.
Special Considerations Instant Capacity Integration with Virtual Partitions Integrated Virtual Partition Environment Activation and Deactivation of Processors When using vPars version A.04.01 or greater, the icod_modify command must be used to modify processor capacity when you are making any adjustment to an nPartition or to multiple nPartitions: • When you execute the icod_modify command to deactivate a processor, a check is made to see if the request can be satisfied.
Special Considerations Instant Capacity Integration with Virtual Partitions Boot Time Compliance In the integrated virtual partition environment, a compliance check is performed whenever a virtual partition is booted.
Special Considerations Instant Capacity Integration with Virtual Partitions WARNING The icod_modify command should not be used in a compatible virtual partition environment to deactivate processors if processor sets (Psets) are being used. The icod_modify command utilizes the vparmodify command which does not recognize Psets. Using the icod_modify command to deactivate a processor may cause an unintended processor to be removed from a Pset.
Special Considerations Instant Capacity Integration with Virtual Partitions Example Output of icod_stat on a Partitionable System Containing vPars /usr/sbin/icod_stat Version: System ID: Serial number: Product number: Unique ID: System contact e-mail: From e-mail: Asset reporting: Temporary capacity warning Exception status: B.07.01 zoo6 USR4020003 A5201A Z3e0ec8e078cd3c7b mjones@corp.
Special Considerations Instant Capacity Integration with Virtual Partitions Allocation of iCOD Resources Among Partitions ------------------------------------------------------------nPar Inactive Inactive Inactive ID Cells Memory CPUs nPar Name ==== ======== =========== ======== ====================== 0 0 0.0 GB 0* zoo0 1 0 0.0 GB 0 zoo1 2 1 8.0 GB 4* zoo2 3 0 0.0 GB 0* zoo3a 4 0 0.0 GB 0 zoo5 5 0 0.0 GB 2 zoo7 6 0 0.0 GB 1 zoo6 (local) 8 0 0.0 GB 3 zoo8 9 0 0.0 GB 0* zoo9 10 0 0.0 GB 0* zoo10 11 0 0.
Special Considerations Instant Capacity Integration with Virtual Partitions Static Virtual Partitions If a virtual partition is static (that is, the resources cannot be migrated, added, deleted, or modified) and you attempt to activate or deactivate processors, the Instant Capacity software displays a message indicating that the configuration of the processor resources cannot be modified.
Special Considerations Instant Capacity Compatibility with Processor Sets Instant Capacity Compatibility with Processor Sets Overview The Instant Capacity versions B.07.x software successfully co-exists with processor sets (Psets). To co-exist with Psets, the Instant Capacity software only activates and deactivates processors in the default processor set. Processors in non-default processor sets are not activated or deactivated. NOTE There must be at least one processor in the default processor set.
Special Considerations Instant Capacity Compatibility with Processor Sets With vPars version A.04.01 or greater, vPars is Pset-aware to an extent. When adding processors to a running vPar, a processor is always added to the default Pset; thereafter, it may be moved to another Pset.
Special Considerations Configuring E-Mail on Instant Capacity Systems Configuring E-Mail on Instant Capacity Systems E-Mail Requirements Previous versions of the Instant Capacity software required e-mail connectivity to HP in order to send asset reports as encrypted e-mail messages. Instant Capacity versions B.07.
Special Considerations Configuring E-Mail on Instant Capacity Systems The ability to receive e-mail from HP is optional, but you may find it useful for testing the capability of sending e-mail to HP. For more information see “Configuring Your Server to Send but Not Receive E-Mail” on page 149. Refer to the sendmail(1M) manpage for more information on sendmail. sendmail is part of the HP-UX core and is installed with the HP-UX operating system.
Special Considerations Configuring E-Mail on Instant Capacity Systems Sendmail sendmail is the application used by the Instant Capacity software to send encrypted mail messages from your system to HP. The sendmail daemon, if running, can also be used to receive e-mail. For the purposes of this e-mail configuration, only the ability to send e-mail is required. Mail applications invoke sendmail to send e-mail. The configuration file, /etc/mail/sendmail.cf, offers tremendous flexibility.
Special Considerations Configuring E-Mail on Instant Capacity Systems In some DNS environments, no changes to the default /etc/mail/sendmail.cf file may be needed to properly route e-mail from the Instant Capacity system to HP. • Example A-3 In some environments, configuring your system to properly send e-mail from the system to HP can require as little as a two line edit (or none) to the /etc/mail/sendmail.cf file.
Special Considerations Configuring E-Mail on Instant Capacity Systems Steps to Confirm or Diagnose E-mail Configuration After you have configured your Instant Capacity system to send e-mail over the internet you can use the following steps to confirm the e-mail configuration or to aid in debugging the configuration: 1. Send an e-mail message from your system to an e-mail address in the same domain (intranet) and confirm receipt of the e-mail message. 2.
Special Considerations Configuring E-Mail on Instant Capacity Systems Configuring Instant Capacity’s FROM E-mail Address One of the e-mail requirements of the Instant Capacity program is that the FROM e-mail address, on e-mail messages sent by the Instant Capacity software from your system, must be DNS resolvable. The Instant Capacity software uses adm@localhost.domain as the default FROM e-mail address (where localhost is the hostname of your system and domain is its DNS domain).
Special Considerations Configuring E-Mail on Instant Capacity Systems Configuring Your Server to Send but Not Receive E-Mail For security reasons, some organizations do not wish to allow incoming mail. If you want your Instant Capacity system to be capable of only sending e-mail, and not receiving e-mail, complete the following configuration procedure: Step 1. To prevent the sendmail daemon from starting up again when your system reboots, edit the /etc/rc.config.
Special Considerations Configuring E-Mail on Instant Capacity Systems Testing E-Mail Transmission of the Asset Report NOTE The following procedure assumes your Instant Capacity system is capable of sending internet e-mail. Execute the following command to send your asset report, by e-mail, to HP: /usr/sbin/icod_notify The specified reply_address should receive an acknowledgment e-mail message from HP confirming the receipt of your asset report.
Special Considerations Measurement Software on Instant Capacity Systems Measurement Software on Instant Capacity Systems Instant Capacity systems inherently have fewer active processors than the total number of processors in the system. This fundamental difference between the number of active processors and the total number of processors can cause some processor measurement products and utilities to report incorrect information.
Special Considerations Dynamic Processor Resilience (DPR) Dynamic Processor Resilience (DPR) The LPMC monitor, within the Support Tools Manager (STM) diagnostics, generates Information events for all cache errors that are detected. After three errors (Threshold) have been detected on a processor in 1440 minutes, or a 24-hour period of time (Period), the monitor deactivates that particular processor, marks it for deconfiguration on the next system reboot, and generates a SERIOUS event.
B Appendix B Glossary 153
Glossary Instant Capacity Terminology Instant Capacity Terminology The following terms are commonly used in conjunction with Instant Capacity: activated processor A processor that has been turned on by the Instant Capacity software or during installation. Processors are activated with the icod_modify command (or the vparmodify command in a virtual partition) while HP-UX is running. add-on system A system that has been converted to an Instant Capacity system.
Glossary Instant Capacity Terminology deactivated processor A processor that either has not yet been activated or that has been turned off by the Instant Capacity software and returned to the pool of inactive processors. These processors are available for activation.
Glossary Instant Capacity Terminology inactive partition A partition where all of the cells in the partition are inactive. inactive processor A processor in an Instant Capacity system that is currently inactive. Licensed inactive processors are capable of activation by use of the icod_modify command (or by use of the vparmodify command in a virtual partition). An inactive processor is also referred to as a “deactivated processor”.
Glossary Instant Capacity Terminology migrating processors The process of activating and deactivating processors across partitions for load-balancing. See “Load-Balancing Active Processors” on page 63 for more information. monarch processor This is the main controlling processor from the perspective of the operating system. This processor is designated as CPU 0. The LPMC monitor does not deactivate/replace a failing monarch processor. This is also known as the boot processor.
Glossary Instant Capacity Terminology temporary capacity (TiCAP, TiCOD) Or Temporary Instant Capacity, an HP product that enables customers to purchase prepaid processor activation rights, for a specified (temporary) period of time. Temporary capacity is sold in 30 processor-day increments. Temporary capacity is also referred to as “TiCAP” or, formerly, as “TiCOD”.
C Instant Capacity Manpages This appendix contains the manpages for Instant Capacity commands.
Instant Capacity Manpages iCOD (5) Manpage iCOD (5) Manpage iCOD (5) NAME iCOD – instant Capacity on Demand software for HP-UX DESCRIPTION iCOD provides services for instantly increasing or decreasing processing capacity (CPUs, cells, and memory) on supported HP servers to meet varying system demands.
Instant Capacity Manpages iCOD (5) Manpage 3) If asset reporting is to be used, execute the icod_notify command (see icod_notify (1M)) to send an asset report to HP, root, and to the specified e-mail address. HP will respond to the asset report by sending a confirmation e-mail to the specified e-mail address. Receipt of the confirmation e-mail verifies that e-mail communication with HP is established.
Instant Capacity Manpages iCOD (5) Manpage Virtual Partitions iCOD processors may be present in systems or partitions where virtual partition technology is employed. In a virtual partition environment, processors that are not assigned to any virtual partition are considered inactive (in addition to other classes of inactive processors).
Instant Capacity Manpages iCOD (5) Manpage Processor Sets In an environment where processor sets are being used, the icod_modify command activates iCOD processors into the default processor set and deactivates processors from only the default processor set.
Instant Capacity Manpages iCOD (5) Manpage iCOD Cell Board iCOD Cell Board offers a way to have additional (inactive) cell board capacity in your iCOD system. These iCOD cell boards, which contain memory and processors, can be activated after a cell RTU codeword is obtained from the HP iCOD portal and is applied to the system using the icod_modify command. SEE ALSO icod_modify (1M), icod_notify (1M), icod_stat (1M), icodd (1M).
Instant Capacity Manpages icod_modify (1M) Manpage icod_modify (1M) Manpage icod_modify (1M) NAME icod_modify – Activate and deactivate processors. Specify system contact e-mail address. Change iCOD configuration information. Specify iCOD from e-mail address. Specify system identifier. Specify temporary capacity warning period. Apply codewords.
Instant Capacity Manpages icod_modify (1M) Manpage a codeword. A complex is in a compliant state when the number of active components of a given type does not exceed the number of licensed components of a given type (processors, cells, memory). Changes to the intended number of active processors using this command are persistent (survive system reboot).
Instant Capacity Manpages icod_modify (1M) Manpage intended active processors by n for the nPartition. If specified within a virtual partition, it also results in the assignment of additional processors to the local vPar. -c Sets the system contact e-mail address. This is the e-mail address that will receive configuration change notification and exception reports. Note that this can be an e-mail alias, if multiple recipients of these reports are desired.
Instant Capacity Manpages icod_modify (1M) Manpage returned to the default setting by specifying an empty string (""). The system identifier is a string that you specify to help track your own systems. -r Reconcile. Activate or deactivate processors (subject to compliance limits) to bring the system to a state where the intended number of processors are active. -w Set temporary capacity warning period to number of days. If not specified, the default warning period is 15 days.
Instant Capacity Manpages icod_modify (1M) Manpage -d to stop the use of temporary capacity. It is not necessary to use the -t option when using the -d option. If a previous authorization via icod_modify has resulted in temporary capacity being consumed in a virtual partition environment, deactivating a processor with a vparmodify command temporarily reduces the consumption of temporary capacity.
Instant Capacity Manpages icod_modify (1M) Manpage UPGRADES The icod_modify command fails if the system is in a state where a software upgrade is incomplete (the software on the system has been upgraded from version B.05.00 or earlier, but an upgrade codeword issued by the HP iCOD portal (http://www.hp.com/go/icod/portal) has not been applied to the system). The only option that can be used when the complex is in this state is the -C option, which accepts the upgrade codeword.
Instant Capacity Manpages icod_modify (1M) Manpage FILES /var/adm/icod.
Instant Capacity Manpages icod_modify (1M) Manpage SEE ALSO icod_notify (1M), icod_stat (1M), icodd (1M), icod (5).
Instant Capacity Manpages icod_notify (1M) Manpage icod_notify (1M) Manpage icod_notify (1M) NAME icod_notify – Test e-mail connectivity to HP for instant Capacity on Demand (iCOD) systems. Request a confirmation response e-mail from HP. Turn configuration change notification and asset reporting on or off.
Instant Capacity Manpages icod_notify (1M) Manpage Options icod_notify recognizes these options and arguments: -a on|off Turns e-mail asset reporting on or off. This option is used to specify if the iCOD software should send asset reports to HP via e-mail. The icod_stat command displays the present setting for this option. -n on|off Turns configuration change notification on or off.
Instant Capacity Manpages icod_notify (1M) Manpage RETURN VALUE icod_notify exits with one of these values: 0 Command succeeded. >0 Command failed; error message sent to STDERR. EXAMPLES Test e-mail connectivity with HP by sending an asset report to HP, root, and "super_user@corp.com", and request a confirmation e-mail from HP to be sent to "super_user@corp.com". icod_notify super_user@corp.
Instant Capacity Manpages icod_stat (1M) Manpage icod_stat (1M) Manpage icod_stat (1M) NAME icod_stat – Display instant Capacity on Demand (iCOD) status and system information SYNOPSIS Path: /usr/sbin icod_stat icod_stat -s DESCRIPTION The icod_stat command displays the status and system information on an iCOD system. For further information see the iCOD User’s Guide located at /usr/share/doc/icodUserGuide.pdf.
Instant Capacity Manpages icod_stat (1M) Manpage System contact e-mail: This field displays the e-mail address for the person who should receive configuration change notification and exception reports. This field is set via the icod_modify-c command. From e-mail: This field displays the e-mail address that will be specified as the sender of all iCOD initiated e-mail correspondence. This field is set via the icod_modify -f command. If not set, e-mail will be sent from the adm user on the local system.
Instant Capacity Manpages icod_stat (1M) Manpage Processors that cannot immediately be assigned: This field displays the number of unassigned processors (licensed or unlicensed) in the hard partition that are not assigned to the local virtual partition and cannot be instantly assigned. This number will also include CPUs in inactive cells and deconfigured CPUs. When using versions of vPars before A.
Instant Capacity Manpages icod_stat (1M) Manpage Appendix C 179
Instant Capacity Manpages icod_stat (1M) Manpage Global iCOD information The following status is displayed for the entire complex: iCOD cells: This field displays the number of unlicensed cells in the complex. Unlicensed cells are expected to be inactive. Actual inactive cells: This field displays the current number of inactive cells in the complex. iCOD processors: This field displays the total number of unlicensed processors in the complex. Unlicensed processors are expected to be inactive.
Instant Capacity Manpages icod_stat (1M) Manpage Inactive CPUs: This field displays the current number of inactive processors in the hard partition. nPar Name: This field displays the partition name corresponding to the row of information that is displayed. If the row is the local partition, the word "local" will follow the partition name. For cells that are not assigned to partitions, the "Unassigned Cells" label will be displayed.
Instant Capacity Manpages icod_stat (1M) Manpage Options icod_stat recognizes these options: Displays system snapshot information. This option displays the product and serial number for this system, as well as a snapshot string that can be entered into the HP iCOD portal for periodic auditing purposes.
Instant Capacity Manpages icodd (1M) Manpage icodd (1M) Manpage icodd (1M) NAME icodd – instant Capacity on Demand (iCOD) daemon. SYNOPSIS Path: /usr/lbin icodd DESCRIPTION icodd is installed and started as part of the iCOD software on all potential iCOD systems, and re-spawns itself if killed. Note that other iCOD commands fail if this daemon is not running because the operations this daemon performs are vital in keeping the complex wide view of the iCOD state current.
Instant Capacity Manpages icodd (1M) Manpage The icodd daemon performs periodic operations based on the time of day. The icodd daemon is spawned by init and gets its timezone specification from the /etc/default/tz file. By default the timezone specified in /etc/default/tz is EST5EDT. You can specify which timezone the icodd daemon uses to interpret its current time by modifying the /etc/default/tz file. Refer to environ (5) for details of the TZ format.
Index A activated processor, defined, 154 activating Cell Board Instant Capacity, 100 activating processors, 56 add-on system, defined, 154 asset report testing e-mail transmission, 150 assigning cell to partition, 64 assumed values in icod_stat, 120 audit application, Instant Capacity, 16 B bound processor, defined , 154 C Cell Board Instant Capacity, 91 accidental activation, 102 activating, 100 activation exception, 103 licensing, 96 licensing examples, 97 ordering, 94 Temporary Instant Capacity, 104 Cel
Index icodd (1M) manpage, 183 icodd daemon timezone, 41 inactive cell, defined, 155 inactive partition, defined, 156 inactive processor, defined , 156 installing software, Instant Capacity, 44 Instant Capacity activating processors, 56 applying RTU codeword, 54 assumed values in icod_stat, 120 audit application, 16 cell removal implications, 127 codewords, 31 compatibility with Psets, 141 compliance and enforcement, 32 compliance exceptions, 106 components, 29 configuration change notification, 34 configuri
Index P par commands with PC SMS , 131 past versions, Instant Capacity, 19 patches required for HP-UX 11i v1, 25 Pay per use, defined , 157 PC SMS and par commands, 131 portal, Instant Capacity, 16 PPU, defined, 157 processor activated, defined , 154 configured, defined, 154 deactivated, defined, 155 deconfigured, defined, 155 inactive, defined, 156 Instant Capacity, defined, 156 monarch, defined, 157 processor activation, Instant Capacity, 35 processor test activation, Instant Capacity, 70 processors migr
