HP Instant Capacity User Manual

HP Instant Capacity user's guide for Version
10.x
HP-UX 11i v3, HP-UX 11i v2, and HP-UX 11i v1
HP Part Number: T1428-90074 Published: September 2010 Edition: 3
© Copyright 2000-2010 Hewlett-Packard Development Company, L.P
Legal Notices
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 informationcontained hereinis subject to change without notice. Theonly warranties forHP products and services are set forth in theexpress
warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP
shall not be liable for technical or editorial errors or omissions contained herein.
UNIX is a registered trademark of The Open Group.

Table of Contents

About This Guide.............................................................................................................11
Intended Audience................................................................................................................................11
New and Changed Information in This Edition...................................................................................11
Publishing History................................................................................................................................12
Document Organization.......................................................................................................................13
Typographic Conventions.....................................................................................................................14
Location of Instant Capacity Information.............................................................................................15
Instant Capacity user’s guide for Version 10.x................................................................................15
Locating the Instant Capacity release notes for Version 10.x..........................................................15
Manpages.........................................................................................................................................16
HP Encourages Your Comments..........................................................................................................16
1 Introduction to Instant Capacity..................................................................................17
Instant Capacity Summary...................................................................................................................18
Terminology.....................................................................................................................................19
Overview...............................................................................................................................................20
Software Product Overview............................................................................................................20
System Overview.............................................................................................................................20
Instant Capacity System Hardware...........................................................................................21
Instant Capacity Software..........................................................................................................21
Utility Pricing Solutions Portal..................................................................................................22
Instant Capacity Administration System...................................................................................22
Instant Capacity Database..........................................................................................................22
Other System Management Commands....................................................................................22
Most Recent Instant Capacity Product Versions and Supported Platforms...................................23
Past Versions and Supported Operating Systems...........................................................................25
2 Getting Started.............................................................................................................27
Instant Capacity Requirements.............................................................................................................28
Program Requirements....................................................................................................................28
Software Requirements....................................................................................................................28
HP-UX 11i v1 Requirements and Dependent Products.............................................................28
Required Patches for HP-UX 11i v1...........................................................................................29
HP-UX 11i v2 Requirements and Dependent Products.............................................................29
Required Patches for HP-UX 11i v2...........................................................................................29
HP-UX 11i v3 Requirements and Dependent Products.............................................................30
OpenVMS Version 8.4 Requirements.........................................................................................30
Network Requirements...................................................................................................................30
Email Requirements........................................................................................................................30
System Contact Requirement..........................................................................................................31
Usage Rights Requirement..............................................................................................................31
Instant Capacity Integration with Virtual Partitions (HP-UX)........................................................31
Instant Capacity Components..............................................................................................................33
Overview.........................................................................................................................................33
Processors and Cores.......................................................................................................................33
Cell Boards and Memory.................................................................................................................33
Global Instant Capacity........................................................................................................................35
Instant Capacity Codewords................................................................................................................36
Temporary Instant Capacity.................................................................................................................37
Table of Contents 3
Instant Capacity Compliance and Enforcement...................................................................................38
Configuration Change Notification......................................................................................................39
Core Activation.....................................................................................................................................40
Increasing Processing Capacity by Purchasing RTUs.....................................................................40
Instant Capacity Cell Board..................................................................................................................41
Instant Capacity Software Validation...................................................................................................42
On HP-UX Systems..........................................................................................................................42
On OpenVMS Systems....................................................................................................................42
Status Reporting on Instant Capacity Systems.....................................................................................43
Time Zone Considerations....................................................................................................................44
3 Installing and Removing Instant Capacity Software.................................................45
Installing Instant Capacity Software.....................................................................................................46
Installing from the HP-UX Media (HP-UX 11i v1, 11i v2, and 11i v3):...........................................46
Installing from the HP Software Depot (For HP-UX 11i v1, 11i v2, and 11i v3):............................47
For All HP-UX Installations.............................................................................................................47
Installing Instant Capacity on OpenVMS Systems.........................................................................47
Reinstalling Instant Capacity Software.................................................................................................48
Preserving current Instant Capacity information...........................................................................48
Removing Instant Capacity Software...................................................................................................49
4 Using Instant Capacity to Manage Processing Capacity........................................51
Checking the Status of your Instant Capacity System..........................................................................52
Setting System Contact Information.....................................................................................................54
Applying a Right To Use (RTU) Codeword..........................................................................................55
Activating Cores...................................................................................................................................57
Example Core Activation Session....................................................................................................58
Deactivating Cores................................................................................................................................59
Example Deactivation Session for Hardware-Partitionable Systems..............................................59
Overriding Deferred Activation and Deactivation...............................................................................61
Load-Balancing Active Cores................................................................................................................62
Understanding and Managing Intended Active Values.......................................................................63
Activations and Deactivations in a Virtual Partition Environment......................................................64
When to Use the vparmodify or icapmodify Commands...............................................................64
What is Unused Capacity................................................................................................................64
Static Virtual Partitions....................................................................................................................64
Activating Cores in a Virtual Partition Environment......................................................................65
Deactivating Cores in a Virtual Partition Environment..................................................................65
Boot Time Compliance....................................................................................................................66
Assigning a Cell to a Partition..............................................................................................................67
Unassigning a Cell from a Partition......................................................................................................69
Software Application Considerations...................................................................................................71
Test Activation of Cores Using Temporary Capacity...........................................................................72
Replacement of Failed Cores................................................................................................................73
HP-UX LPMC and HPMC...............................................................................................................73
LPMC Deactivations in Virtual Partitions.......................................................................................73
Failed Monarch Processors (HP-UX)...............................................................................................73
Replacement of Failed Cores on OpenVMS....................................................................................73
Failed OpenVMS Primary Processors.............................................................................................73
5 Temporary Instant Capacity........................................................................................75
Temporary Instant Capacity Overview................................................................................................76
Ordering Temporary Instant Capacity.................................................................................................78
4 Table of Contents
HP-UX Licensing and Support with Temporary Instant Capacity.................................................78
OpenVMS Licensing and Support with Temporary Instant Capacity............................................78
Using Temporary Instant Capacity.......................................................................................................79
Acquiring and Configuring Temporary Instant Capacity...............................................................79
Using Temporary Instant Capacity.................................................................................................79
Temporary Capacity and Virtual Partitions..........................................................................................81
Tracking Usage of Temporary Instant Capacity...................................................................................83
Temporary Instant Capacity Warning Period.......................................................................................85
Temporary Instant Capacity Expiration and Compliance Enforcement..............................................86
Temporary Instant Capacity Exceptions...............................................................................................87
Error for Activation with Insufficient Temporary Capacity............................................................87
Temporary Capacity Balance Needing Action................................................................................87
Temporary Capacity Negative Balance...........................................................................................87
Temporary Capacity Enforcement..................................................................................................87
6 Instant Capacity Cell Board........................................................................................91
Instant Capacity Cell Board..................................................................................................................92
Overview.........................................................................................................................................92
Ordering Instant Capacity Cell Board..................................................................................................93
HP-UX and OpenVMS License and Support........................................................................................94
Acquiring Usage Rights for Instant Capacity Cell Board.....................................................................95
Instant Capacity Cell Board and Considerations of Core Usage Rights..............................................96
Activation of an Instant Capacity Cell Board.......................................................................................97
Accidental Activation of an Instant Capacity Cell Board.....................................................................98
Instant Capacity Cell Board Activation Exception Error......................................................................99
Instant Capacity Cell Board and Temporary Instant Capacity...........................................................100
7 Global Instant Capacity............................................................................................101
Global Instant Capacity Overview......................................................................................................102
Global Instant Capacity Requirements...............................................................................................104
Global Instant Capacity Group Managers..........................................................................................105
Standby Group Managers..............................................................................................................105
Global Instant Capacity Grouping Rules............................................................................................107
Global Instant Capacity Sharing Rights..............................................................................................108
Creating Global Instant Capacity Groups...........................................................................................109
Global Instant Capacity Resource Sharing.........................................................................................112
Effect of Temporary Capacity........................................................................................................112
Status Reporting............................................................................................................................113
Global Instant Capacity and Temporary Capacity.............................................................................115
Temporary Capacity and Freed Usage Rights...............................................................................115
Temporary Capacity and Status Reporting...................................................................................115
Temporary Capacity Prefetch........................................................................................................116
Removing a Global Instant Capacity Group Member........................................................................117
Reinstalling a Group Member.............................................................................................................118
Group Manager Availability (No Standby Manager).........................................................................119
Group Manager Failover Considerations...........................................................................................120
Upgrades and Global Instant Capacity...............................................................................................121
Adding New Partitions..................................................................................................................121
Rights Seizure......................................................................................................................................122
When to Migrate Usage Rights and When to Seize Usage Rights................................................122
Effects of Rights Seizure................................................................................................................122
Down Partitions with Powered-On Cells......................................................................................123
Temporary Capacity and Rights Seizure.......................................................................................123
Table of Contents 5
Other Considerations.....................................................................................................................124
Additional HA Solutions...............................................................................................................124
Summary of Rights Seizure...........................................................................................................124
Considerations for Multiple Groups...................................................................................................127
Additional Considerations..................................................................................................................128
8 Using Instant Capacity on HP Integrity Superdome 2...........................................129
Overview.............................................................................................................................................129
iCAP: From compliance check paradigm to self enforcement......................................................129
Important Considerations...................................................................................................................130
Sizing Partitions.............................................................................................................................130
Resizing Partitions.........................................................................................................................130
Memory iCAP................................................................................................................................130
Installing iCAP on HP Integrity Superdome 2...................................................................................130
iCAP commands.................................................................................................................................131
Viewing number of active cores....................................................................................................131
Generating snapshot......................................................................................................................131
Setting usage rights for a partition................................................................................................132
Deactivating Cores.........................................................................................................................132
Activating Cores............................................................................................................................132
Using iCAP Memory.....................................................................................................................132
iCAP Use Cases...................................................................................................................................133
Core migration between partitions in a complex..........................................................................133
Core migration across complexes (GiCAP)...................................................................................134
9 Troubleshooting..........................................................................................................137
Handling Compliance Exceptions......................................................................................................137
Troubleshooting the Instant Capacity Software..................................................................................140
Diagnosing Email Configuration........................................................................................................142
10 Frequently Asked Questions...................................................................................143
Instant Capacity Software...................................................................................................................144
Instant Capacity Hardware.................................................................................................................147
Global Instant Capacity.......................................................................................................................148
1 Instant Capacity HP-UX Manpages.........................................................................149
iCAP(5)................................................................................................................................................150
icapmanage(1M)..................................................................................................................................159
icapmodify(1M)...................................................................................................................................174
icapnotify(1M).....................................................................................................................................180
icapstatus(1M).....................................................................................................................................182
icapd(1M)............................................................................................................................................189
A Special Considerations.............................................................................................191
Assumed Values in icapstatus Command..........................................................................................192
Assumed Processor Values............................................................................................................192
Assumed Memory Values..............................................................................................................192
Upgrading to Instant Capacity version B.06.x or later (HP-UX)........................................................193
Dual-Core Support in Instant Capacity Systems................................................................................195
New Partition Creation and Instant Capacity.....................................................................................196
Implications of Removing a Cell from an Instant Capacity System ..................................................197
6 Table of Contents
Shutting Down a Partition with Instant Capacity Cores....................................................................198
Instant Capacity and Reinitializing the nPartition (Genesis Partitions).............................................199
par Commands from PC System Management Station......................................................................200
Instant Capacity Compatibility with Processor Sets (HP-UX)...........................................................201
Overview........................................................................................................................................201
Scope of the Instant Capacity Software Interacting with psets.....................................................201
psets on nPars................................................................................................................................201
psets on vPars................................................................................................................................201
Configuring Email on Instant Capacity Systems................................................................................202
Email Requirements.......................................................................................................................202
Email Configuration.................................................................................................................202
Steps to Confirm or Diagnose Email Configuration................................................................204
Configuring Instant Capacity’s From Email Address..............................................................204
Configuring Your Server to Send but Not Receive Email........................................................205
Testing Email Transmission of the Asset Report......................................................................205
Measurement Software and Instant Capacity Systems.......................................................................206
HP OpenView Measurement Products.........................................................................................206
Other Measurement Software........................................................................................................206
Dynamic Processor Resilience (HP-UX).............................................................................................207
Security Issues.....................................................................................................................................208
Customer protections which iCAP assumes to be in place...........................................................208
Disabling the iCAP daemon (HP-UX)...........................................................................................208
Customer Security Requirements..................................................................................................208
Security Tuning Options................................................................................................................208
B Considerations for OpenVMS Systems....................................................................209
CLI Support on OpenVMS..................................................................................................................210
HP-UX Style Commands...............................................................................................................210
OpenVMS Command Mapping.....................................................................................................210
OpenVMS iCAP Files.....................................................................................................................211
DCL ICAP Command....................................................................................................................212
DCL Commands..................................................................................................................................212
ICAP ACTIVATE...........................................................................................................................212
ICAP APPLY..................................................................................................................................213
ICAP DEACTIVATE......................................................................................................................214
ICAP RECONCILE........................................................................................................................215
ICAP SET.......................................................................................................................................216
ICAP SHOW..................................................................................................................................218
ICAP_SERVER...............................................................................................................................219
Special OpenVMS-Specific Features and Considerations..................................................................220
Core Activation and Deactivation.................................................................................................220
Email Considerations.....................................................................................................................220
Restrictions..........................................................................................................................................221
Glossary.........................................................................................................................223
Index...............................................................................................................................229
Table of Contents 7
List of Figures
1-1 Instant Capacity System Elements................................................................................................21
4-1 Permanent Activation of Instant Capacity Components..............................................................56
4-2 Partition premodification state: One cell assigned with 3 active and 1 inactive cores, and usage
rights for 2 additional cores...........................................................................................................67
4-3 Premodification state: Unassigned cell with 4 inactive cores and no usage rights......................67
4-4 Partition postmodification state: Cell 2 assigned to partition.......................................................67
4-5 Partition premodification state: Three cells with 2 active and 2 inactive cores in each, and 6
expected inactive cores..................................................................................................................69
4-6 Partition postmodification state: Cell 3 is unassigned (total of 6 active cores remaining)...........69
4-7 Partition postmodification state: Unassigned Cell 3 with 4 inactive cores...................................69
4-8 Partition premodification state: Three cells with 3 active and 1 inactive cores in each, and 3
expected inactive cores..................................................................................................................69
4-9 Partition postmodification state: Unassigned Cell 3 (total of 8 active cores are set)....................70
4-10 Postmodification state: Unassigned Cell 3 with 4 inactive cores, with usage rights available for
1 additional core............................................................................................................................70
5-1 Using Temporary Instant Capacity: Temporary Activation of Cores Without Usage Rights.......77
6-1 nPartition premodification state: One cell assigned with 1 active core and 3 inactive cores; the
complex has no additional core usage rights................................................................................99
6-2 nPartition premodification state: Instant Capacity cell (Cell 2) with 4 inactive cores..................99
6-3 nPartition requested state: Instant Capacity Cell (Cell 2) cannot be activated in nPartition........99
7-1 Using Global Instant Capacity.....................................................................................................103
8-1 iCAP Memory configuration option...........................................................................................133
8 List of Figures
List of Tables
1-1 Most Recent Instant Capacity Versions and Supported Platforms...............................................23
6-1 Cell Board Activation Not Requiring Additional Core Usage Rights..........................................96
6-2 Cell Board Activation Requiring Additional Core Usage Rights.................................................96
8-1 Use Case 1 — Initial Configuration.............................................................................................133
8-2 Use Case 1 — Configuration of Complex After Core Migration................................................134
8-3 Use Case 2 — Initial Configuration.............................................................................................134
8-4 Use Case 2 — Initial Configuration.............................................................................................134
8-5 Configuration of Complex1 post core migration........................................................................134
8-6 Configuration of Complex2 post core migration........................................................................135
10-1 Email sent by the Instant Capacity software...............................................................................145
10-2 Asset reporting email sent by the Instant Capacity software......................................................146
A-1 Removing a Cell and Decreasing Inactive Cores........................................................................197
B-1 HP-UX and OpenVMS Command Equivalents..........................................................................210
B-2 OpenVMS iCAP Files..................................................................................................................211
9
List of Examples
2-1 Configuration Change Notification email for Instant Capacity System (not vPar)......................39
4-1 Sample Session of icapstatus (on HP-UX).....................................................................................53
4-2 Applying an RTU Codeword (HP-UX).........................................................................................55
4-3 Activating an Additional Core (HP-UX).......................................................................................58
4-4 Deactivating an Active Core (HP-UX)...........................................................................................60
4-5 Correcting an Incorrect Number of Deferred Active Cores (HP-UX)...........................................61
4-6 Undoing an Accidental Deferred Activation (HP-UX).................................................................61
4-7 vPar Boot–Time Compliance Message..........................................................................................66
5-1 Applying a Temporary Capacity Codeword (HP-UX).................................................................79
5-2 Activating an Instant Capacity Core with Temporary Capacity (HP-UX)...................................80
5-3 Temporary Capacity Information from icapstatus Command (HP-UX)......................................83
5-4 Temporary Capacity Expiration Reminder...................................................................................84
5-5 Error Message for Activation with Insufficient Temporary Capacity (HP-UX)...........................87
5-6 Error Message for Temporary Capacity Partial Enforcement.......................................................88
5-7 Error Message for Temporary Capacity Complete Enforcement..................................................89
7-1 Applying a Sharing Rights Codeword........................................................................................108
7-2 Creating a Group.........................................................................................................................109
7-3 Adding a Member to a Group.....................................................................................................110
7-4 Example Output of icapstatus for a Group Member System......................................................111
9-1 Exception Report for More Cores Active than Expected............................................................138
A-1 Example Edit to Sendmail Configuration (/etc/mail/sendmail.cf)..............................................203
10 List of Examples

About This Guide

The HP Instant Capacity user’s guide for Version 10.x provides you with the most recent information for using the Instant Capacity Version 10 software. This document describes Instant Capacity Version B.11.31.10.00.00 on HP-UX 11i v3 systems, B.11.23.10.00.00 on HP-UX 11i v2 systems, B.11.11.09.02.00 on HP-UX 11i v1 systems, and Instant Capacity Version 9.x on OpenVMS 8.4 Integrity servers.
The latest version of this document can be found online at: www.hp.com/go/hp-icap-docs.
This chapter covers the following topics:
“Intended Audience” (page 11)
“New and Changed Information in This Edition” (page 11)
“Publishing History” (page 12)
“Document Organization” (page 13)
“Typographic Conventions” (page 14)
“Location of Instant Capacity Information” (page 15)
“HP Encourages Your Comments” (page 16)

Intended Audience

All personnel with system administrator access (that is, with root login privileges on HP-UX systems, or Administrators on OpenVMS systems) to an Instant Capacity system should read and understand the contents of this document and the implications of managing an Instant Capacity system.
Administrators are expected to have knowledge of HP-UX, or OpenVMS Integrity operating system concepts, commands, and configuration.
This document is not a tutorial.

New and Changed Information in This Edition

This edition of HP Instant Capacity user’s guide for Version 10.x. includes a new chapter that provides information about iCAP support on HP Integrity Superdome 2. For detailed information about iCAP support on HP Integrity Superdome 2, see Chapter 8 (page 129)
Intended Audience 11

Publishing History

The document printing date and part number indicate the document’s current edition. The printing date will change when a new edition is printed. Minor changes may be made at reprint without changing the printing date. The document part number will change when extensive changes are made. Document updates may be issued between editions to correct errors or document product changes. To ensure that you receive the updated or new editions, you should subscribe to the appropriate product support service. See your HP sales representative for details. You can find the latest version of this document on line at:
www.hp.com/go/hp-icap-docs.
Manufacturing Part Number
Publication DateEdition NumberSupported VersionsSupported Operating
Systems
September 20103B.11.23.10.00.00HP-UX 11i v2T1428-90074
B.11.31.10.00.00HP-UX 11i v3
November 20092B.11.11.09.00.00HP-UX 11i v1B9073-90201
B.11.23.09.00.00HP-UX 11i v2
B.11.31.09.00.00HP-UX 11i v3
9.xHP OpenVMS
Version 8.4
12

Document Organization

This user’s guide is not designed to be read from front to back in its entirety. To get an understanding of Instant Capacity version 9.x, you should read this chapter, Chapter 1 - Instant Capacity Overview, and Chapter 2 - Getting Started. After reading these chapters, you can utilize the table of contents and index (in back) for specific topics of interest.
About This Guide provides an introduction to this guide and locating Instant Capacity
information.
Chapter 1, Introduction to Instant Capacity provides an overview of the Instant Capacity system.
Chapter 2, Getting Started describes Instant Capacity requirements, concepts and methods,
and related software topics.
Chapter 3, Installing and Removing Instant Capacity Software contains procedures on how to
install and reinstall Instant Capacity software.
Chapter 4, Using Instant Capacity to Manage Processing Capacity explains how to view system
status, apply codewords, activate and deactivate cores, assign and unassign cells, and HP’s test activation policy for Instant Capacity.
Chapter 5, Temporary Instant Capacity gives you details on what temporary capacity is, and
how to order and use it.
Chapter 6, Instant Capacity Cell Board provides details on what Instant Capacity Cell Board
is, and how to order and use it.
Chapter 7, Global Instant Capacity gives you details on Global Instant Capacity, describes the
concept of groups and shared resources, and how to order and use it.
Chapter 8, Using Instant Capacity on HP Integrity Superdome 2 provides information about
iCAP support on HP Integrity Superdome 2.
Chapter 9, Troubleshooting gives you step by step procedures to resolve problems with the
Instant Capacity software and other related configurations.
Chapter 10, Frequently Asked Questions contains questions and answers to common Instant
Capacity software topics.
Instant Capacity HP-UX Manpages contains the actual HP-UX manpages for icap,
icapmanage, icapmodify, icapnotify, icapstatus, and icapd.
Appendix A, Special Considerations describes assumed values in icapstatus output,
upgrading to Instant Capacity B.06.x or later software, dual core support, creating and shutting down partitions, implications of removing a cell board from an Instant Capacity system, par commands with PC SMS, integration with Psets, configuring email, testing email transmission of an asset report, measurement software, dynamic processor resilience, and security related issues.
Appendix B, Considerations for OpenVMS Systems contains information for running Instant
Capacity on OpenVMS systems.
Glossary explains Instant Capacity systems and software terms.
Document Organization 13

Typographic Conventions

This document uses the following conventions:
%, $, or #
audit(5) A manpage. The manpage name is audit, and it is located in
Command
Computer output
Ctrl+x A key sequence. A sequence such as Ctrl+x indicates that you
ENVIRONMENT VARIABLE The name of an environment variable, for example, PATH.
[ERROR NAME]
Key The name of a keyboard key. Return and Enter both refer to the
Glossary term The defined use of an important word or phrase.
User input
Variable
[] The contents are optional in syntax. If the contents are a list
{} The contents are required in syntax. If the contents are a list
... The preceding element can be repeated an arbitrary number of
Indicates the continuation of a code example.
| Separates items in a list of choices.
WARNING A warning calls attention to important information that if not
CAUTION A caution calls attention to important information that if not
IMPORTANT This alert provides essential information to explain a concept or
NOTE A note contains additional information to emphasize or
A percent sign represents the C shell system prompt. A dollar sign represents the system prompt for the Bourne, Korn, and POSIX shells. A number sign represents the superuser prompt.
Section 5.
A command name or qualified command phrase.
Text displayed by the computer.
must hold down the key labeled Ctrl while you press another key or mouse button.
The name of an error, usually returned in the errno variable.
same key.
Commands and other text that you type.
The name of a placeholder in a command, function, or other syntax display that you replace with an actual value.
separated by |, you must choose one of the items.
separated by |, you must choose one of the items.
times.
understood or followed will result in personal injury or nonrecoverable system problems.
understood or followed will result in data loss, data corruption, or damage to hardware or software.
to complete a task
supplement important points of the main text.
14

Location of Instant Capacity Information

Instant Capacity user’s guide for Version 10.x

You can find the HP Instant Capacity user’s guide for Version 10.x in the following locations:
On the HP Documentation website:
www.hp.com/go/hp-icap-docs
These are the most current and the most current localized versions of the user guide.
September 2010 HP-UX 11i v1 Instant Information media (English and Japanese only)
September 2010 HP-UX 11i v2 Instant Information media (English and Japanese only)
September 2010 HP-UX 11i v3 Instant Information media (English and Japanese only)
In the Instant Capacity 10.x HP-UX software product:
/usr/share/doc/icapRelNotes.pdf
On the OpenVMS Version 8.4 Documentation CD (English only)

Locating the Instant Capacity release notes for Version 10.x

You can find the Instant Capacity release notes for Version 10.x in the following locations:
On the HP Documentation website:
www.hp.com/go/hp-icap-docs
These are the most current release notes and the most current localized versions.
September 2010 HP-UX 11i v1 Instant Information media (English and Japanese only)
September 2010 HP-UX 11i v2 Instant Information media (English and Japanese only)
September 2010 HP-UX 11i v3 Instant Information media (English and Japanese only)
In the Instant Capacity 10.x HP-UX software product:
/usr/share/doc/icapRelNotes.pdf
This document is not localized and is available in English only.
On the OpenVMS Version 8.4 Documentation CD (English only)
Location of Instant Capacity Information 15

Manpages

NOTE: The information contained in this section applies only to HP-UX systems. It does not apply to Integrity servers running OpenVMS.
See “Instant Capacity HP-UX Manpages” (page 149) for more information about the following manpages:
icap(5): overview of the Instant Capacity commands and their usage
icapmanage(1M): how to manage Global Instant Capacity (GiCAP) groups
icapmodify(1M): how to manage processingcapacity in your Instant Capacity system, change system contact information, and apply codewords
icapnotify(1M): how to manage asset reporting and configuration notification
icapstatus(1M): how to display processing capacity status, usage information, and system information
icapd(1M): overview of the Instant Capacity daemon, which provides the software a complexwide view of processing capacity

HP Encourages Your Comments

HP encourages your comments concerning this document. We are committed to providing documentation that meets your needs. Send any errors found, suggestions for improvement, or compliments to:
docsfeedback@hp.com
Include the document title, manufacturing part number, and any comment, error found, or suggestion for improvement you have concerning this document.
16

1 Introduction to Instant Capacity

This chapter covers the following topics:
“Instant Capacity Summary” (page 18)
“Overview” (page 20)
For more in-depth information, see icap(5).
17

Instant Capacity Summary

HP Instant Capacity software provides the ability to instantly increase or decrease computing capacity on specified HP enterprise servers.
NOTE: HP Instant Capacity for HP 9000 and HP Integrity Servers, also known as Instant Capacity or iCAP, was known in earlier versions as Instant Capacity on Demand, or iCOD. Although the commands, warning messages and error messages refer to the software as iCAP, some internal files might still refer to iCOD.
NOTE: For simplicity and commonality, this book uses the HP-UX commands in all examples. For information about OpenVMS command equivalents, see Appendix B (page 209).
With Instant Capacity, you initially purchase an HP enterprise server with a specified amount of active processing capacity, and a specified amount of inactive processing capacity. This amount can vary based on your sales contract with HP.
Processing capacity consists of the system components:
Processors containing cores
Cell boards
Memory
For each type of component, the number of components that can be active is equal to the number of usage rights applied to the complex for that type of component. Componentsthat are purchased with a part number identifying them as “Instant Capacity” and without the label “Right to Use” come without usage rights. Components that are not labeled “Instant Capacity” implicitlyinclude usage rights that can be applied to any component of that type that is installed on the complex.
Prior to activation of an inactive component, you must obtain additional usage rights. The fundamental method is to purchase usage rights by purchasing the appropriate Instant Capacity products that include the label “Right to Use (RTU)”. HP then supplies an RTU codeword. When the codeword is applied to the HP enterprise server, the inactive component can be activated.
Additional methods for activating components for which usage rights have not been purchased include:
If an HP-UX server is a member of a Global Instant Capacity (GiCAP) group, and if extra capacity is available from other members of the group, capacity can be “borrowed” from another member of the group. For information about GiCAP, see Chapter 7.
Youcan purchaseadditional temporary capacity and apply the Temporary Instant Capacity
(TiCAP) codeword in order to activate one or more cores temporarily. For more information
on TiCAP, see Chapter 5. If a server is a member of a GiCAP group, temporary capacity can be shared among members of the group.
You can temporarily activate one or more inactive cores using the Instant Access Capacity (IAC) provided with the initial purchase of the Instant Capacity component. Instant Access Capacity is the same as TiCAP except it is automatically provided with an Instant Capacity component andcannot be purchased separately. It provides an immediate buffer of temporary capacity in case extra capacity is needed before there is time to purchase an RTU or a TiCAP codeword, or to set up a GiCAP group on an HP-UX system.
IMPORTANT: It is always a good idea to keep some quantity of temporary capacity in reserve. Purchase of codewords may take one or more days, so having a buffer of temporary capacity allows you to avoid delays in activation of additional cores. Instant Access Capacity provides this buffer initially, but as that capacity is depleted, ongoing purchases of additional temporary capacity are recommended to replenish it.
The Instant Capacity software product is a part of the HP Utility Pricing Solutions (formerly On Demand Solutions) program.
18 Introduction to Instant Capacity
This document provides you with the most recent information about using the Instant Capacity version 9.x software to manage processing capacity in your HP enterprise server.
NOTE: All personnel with system administrator access (that is, root login privileges) to an Instant Capacity system should read and understand the contents of this document and the implications of increasing or decreasing processing capacity.

Terminology

For commonly used terms associated with the HP Utility Pricing Solutions program, see the
Glossary.
Instant Capacity Summary 19

Overview

Software Product Overview

The following Instant Capacity software products are associated with HP’s Utility Pricing Solutions program:
iCOD: HP product number B9073BA (HP-UX)
iCAP: HP OpenVMS product number BA484AA
This user's guide contains information for Instant Capacity version 10.x on HP-UX systems and version 9.x on OpenVMS systems.
Instant Capacity must be run on a partitionable system. In an Integrity Virtual Machines (VM) environment, Instant Capacity software provides meaningful functionality only on the VM Host system; it does not run on a virtual machine (also known as a “guest”).
The Instant Capacity product has been available on HP-UX since March 2000 (version B.01.00).
The HP-UX version 9.x software can be obtained from the following HP Software Depot website (search for “Instant Capacity”):
http://www.hp.com/go/softwaredepot

System Overview

Instant Capacity version 9.x consists of the following elements:
Instant Capacity system hardware (including cells, cores, and memory)
Instant Capacity software
Utility Pricing Solutions Portal
Instant Capacity Administration System
Instant Capacity database
Other system management commands
For more information about Instant Capacity concepts and methods, see Chapter 2: “Getting
Started” (page 27).
Figure 1-1 (page 21) shows how the Instant Capacity system elements and processes are linked.
20 Introduction to Instant Capacity
Figure 1-1 Instant Capacity System Elements
Other
System Management
Commands
iCAP DB
System
Compliance
Codeword
Generation
Asset
Report
Record Purchase
Status and
Control
Status and
Control
Status and
Control
Authorization
Purchase
Codeword
Request
Notification
Cores, Cells
and Memory
HP Sales
Rep.
iCAP Admin
System
iCAP
Software
iCAP Web
Portal
Customer
Instant Capacity System Hardware
Instant Capacity Software
The Instant Capacity system hardware is made up of the following components:
Cell boards
Processors, which contain cores
Memory
Every Instant Capacity system contains a combination of these components that are purchased either with usage rights (and available for activation) or without usage rights (must be inactive). Note that although you purchase processors, the Instant Capacity software monitors and manages cores.
The Instant Capacity software provides the means to:
Increase or decrease (load balance) system processing capacity (icapmodify command).
View status and configuration of the system components (icapstatus command).
Administer system identification and notification information (icapmodify command).
If configured, send system asset reports through encrypted email to HP (icapd daemon on HP-UX, ICAP_SERVER process on OpenVMS).
Send configuration change notification, through encrypted email, to the specified system contact.
Overview 21
Monitor and report system compliance (icapd daemon on HP-UX, ICAP_SERVER process on OpenVMS).
Manage Global Instant Capacity groups (icapmanage command).
For detailsabout these commands on HP-UX, see “Instant Capacity HP-UX Manpages” (page 149). For the OpenVMS equivalents of these commands, see “DCL Commands” (page 212).
Utility Pricing Solutions Portal
The Utility Pricing Solutions (or Instant Capacity) portal is located at the HP web site:
http://www.hp.com/go/icap/portal
After you purchase a component without usage rights, HP sends you a letter containing instructions on how to obtain an RTU codeword from the Utility Pricing Solutions portal.
Instant Capacity Administration System
If asset reporting is configured, the icapd daemon sends asset reports, in the form of encrypted email messages, to the Instant Capacity Administration System, which saves information in the Instant Capacity database.
Instant Capacity Database
The Instant Capacity database is a repository on an HP (internal) corporate server that tracks system resources and provides the information for codeword generation. Note that this database should not be confused with a Global Instant Capacity database, which is created on a customer Group Manager system. See Chapter 7 (page 101) for details about Global Instant Capacity.
Other System Management Commands
Other system management commands (such as vparmodify, parCLI and parMgr on HP-UX) provide an interface to modify system configuration that affects Instant Capacity contractual compliance.
22 Introduction to Instant Capacity

Most Recent Instant Capacity Product Versions and Supported Platforms

Table 1-1 lists the current versions of Instant Capacity and the platforms supported for each
version.
Table 1-1 Most Recent Instant Capacity Versions and Supported Platforms
Software and Version
B.11.31.10.00.00
(B9073BA)
B.11.23.10.00.00
(B9073BA)
Operating System
Version
HP-UX 11i v3iCAP
HP-UX 11i v2iCAP
Platforms
HP Integrity servers:
• HP Integrity Superdome 2
• Superdome
• rx8640
• rx8620
• rx7640
• rx7620
HP 9000 servers:
• Superdome
• rp8440
• rp8420
• rp8400
• rp7440
• rp7420
• rp7410
HP Integrity servers:
• Superdome
• rx8640
• rx8620
• rx7640
• rx7620
HP 9000 servers:
• Superdome
• rp8420
• rp8400
• rp7420
• rp7410
NotesSupported Hardware
Available on:
http://www.hp.com/go/softwaredepot
• September 2009 HP-UX 11i v3 Operating Environment media
Available on:
http://www.hp.com/go/softwaredepot
• September 2009 HP-UX 11i v2 Applications Software media
Available on:
http://www.hp.com/go/softwaredepot
• September 2009 HP-UX 11i v1 Applications Software media
Available on:
• OpenVMS Version 8.4 Operating System media
B.11.11.09.00.00
(B9073BA)
iCAP 9.x
(BA484AA)
HP-UX 11i v1iCAP
HP OpenVMS Version 8.4
HP 9000 servers:
• Superdome
• rp8440
• rp8420
• rp8400
• rp7440
• rp7420
• rp7410
HP Integrity servers:
• Superdome
• rx8640
• rx8620
• rx7640
• rx7620
For commonality across all platforms supported by Instant Capacity, generic references to version numbers are in the form “9.x” in this document. Because the operating system version is also
Overview 23
incorporated in the depot version number on newer releases of HP-UX, specific references to version numbers may be more precise; for example, B.11.23.09.00.00 for the HP-UX 11i v2 depot.
24 Introduction to Instant Capacity

Past Versions and Supported Operating Systems

Previous versions of the Instant Capacity software are as follows:
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.x (on HP-UX 11i v1 and 11i v2)
B.07.x (on HP-UX 11i v1 and 11i v2)
B.08.00 (on HP-UX 11i v1 and 11i v2)
B.08.00.01 (on HP-UX 11i v1 and 11i v2)
B.08.01.01 (on HP-UX 11i v1, 11i v2 and 11i v3)
B.08.02 (on HP-UX 11i v1, 11i v2 and 11i v3)
B.08.02.01 (on HP-UX 11i v1, 11i v2 and 11i v3)
B.08.03.00 (on HP-UX 11i v1, 11i v2, and 11i v3)
B.08.03.01 (on HP-UX 11i v1, 11i v2, and 11i v3)
8.0 (on OpenVMS Version 8.3)
8.1 (on OpenVMS Version 8.3-1H1)
Overview 25
26

2 Getting Started

This chapter covers the following topics:
“Instant Capacity Requirements” (page 28)
“Instant Capacity Components” (page 33)
“Global Instant Capacity” (page 35)
“Instant Capacity Codewords” (page 36)
“Temporary Instant Capacity” (page 37)
“Instant Capacity Compliance and Enforcement” (page 38)
“Configuration Change Notification” (page 39)
“Core Activation” (page 40)
“Instant Capacity Cell Board” (page 41)
“Instant Capacity Software Validation” (page 42)
“Status Reporting on Instant Capacity Systems” (page 43)
“Time Zone Considerations” (page 44)
For more in-depth information, see icap(5).
27

Instant Capacity Requirements

Program Requirements

To participate in the Instant Capacity version 9.x program, you must comply with the following conditions of the HP Utility Pricing Solutions program:
Maintain the HP Instant Capacity software on each HP-UX or OpenVMS partition in the
system. The Instant Capacity software is a nonintrusive, low-overhead software module that resides on the partition.
Migrate to later Instant Capacity software versions as they become available.
For specifics about your individual program requirements, see the Utility Pricing Solutions contract from HP or your authorized channel partner.
IMPORTANT: Participants in the Utility Pricing Solutions program who do not meet these requirements may be in breach of contract. This can result in unnecessary expense for both the program participant and HP.

Software Requirements

Every HP-UX and OpenVMS partition in an Instant Capacity system is required to have the Instant Capacity software installed and the icapd daemon running (on HP-UX systems), or the ICAP_SERVER process running (onOpenVMS systems).Youmust maintain theInstant Capacity software until all program requirements are fulfilled and until the system is no longer considered an Instant Capacity system. If you are using GiCAP, all systems must be running Instant Capacity version 9.x.
NOTE: For necessaryHP-UX updates, install the latest Operating Environments Update Release (OEUR) or Application Release (AR) update, if possible. This ensures that you install all required products and versions. Instant Capacity does not work correctly with HP-UX releases prior to December 2004.
Your Instant Capacity system is ordered and shipped with all of the following required software and dependent products, with the exception of the vPars software. If your system’s operating system is reinstalled or installed with Ignite-UX, ensure that the following software requirements are satisfied.
HP-UX 11i v1 Requirements and Dependent Products
The following software is required for Instant Capacity version 9.x on HP-UX 11i v1:
HP-UX 11i v1
iCOD software bundle B9073BA (version 9.x) — On the 11i v1 Applications Software media, or download the most recent version from the HP Software Depot at http://www.hp.com/
go/softwaredepot.
The kernel configuration must include the diag2 module.
WBEM B8465BA bundle (version A.02.05 or higher)
nParProvider bundle (version B.12.01.06.02 or higher, available from the OE media)
If you have a virtual partitioned environment, the Virtual Partitions (vPars) software (bundle T1335AC) must be version A.03.05 or higher. vPars is available separately and is not included with the OE.
(GiCAP only) The CIM Server configuration property sslClientVerificationMode must be set to a value of “optional” on all GiCAP Group Managers and on all OS instances of all member systems. (The CIM Server may need to be restarted if the property was not previously set to this value.) For details, see cimconfig(1M). Note that communication between
28 Getting Started
the managers and members of groups is established using SSL certificates that are supplied by the GiCAP software.
Required Patches for HP-UX 11i v1
The following patches are required for Instant Capacity version 9.x on HP-UX 11i v1:
PHKL_22987: S700_800 11.11 pstat() patch (Use only if your system runs MeasureWare software)
PHKL_23154: S700_800 11.11 dflush() patch
PHKL_25218: S700_800 11.11 PDC Call retry, PDC_SCSI_PARMS, iCOD hang
fix
PHKL_26232: S700_800 11.11 Psets Enablement patch,FSS iCOD patch
PHKL_30197: S700_800 11.11 Psets & vPar, Reboot hangs, serial number
PHCO_24396: S700_800 11.11 /etc/default/tz patch
PHCO_24477: S700_800 11.11 sar (1M) patch
PHCO_29832: S700_800 11.11 reboot(1M) patch
PHCO_29833: S700_800 11.11 killall(1M) patch
IMPORTANT: For the most recent required patches, see the Instant Capacity Installation page on the HP Software Depot (search for “B9073BA”):
http://www.hp.com/go/softwaredepot
HP-UX 11i v2 Requirements and Dependent Products
The following software is required for Instant Capacity version 9.x on HP-UX 11i v2:
HP-UX 11i v2
iCOD software bundle B9073BA (version 9.x) — On the 11i v2 Applications Software media, or download the most recent version from the HP Software Depot at http://www.hp.com/
go/softwaredepot.
The kernel configuration must include the diag2 module.
WBEM B8465BA bundle (version A.02.05 or higher)
nParProvider bundle (version B.23.01.06.02 or higher, available from the OE media)
If you have a virtual partitioned environment, the Virtual Partitions (vPars) software (bundle T1335BC) must be version A.04.01 or higher. vPars is available separately and is not included with the OE.
(GiCAP only) The CIM Server configuration property sslClientVerificationMode must be set to a value of “optional” on all GiCAP Group Managers and on all OS instances of all member systems. (The CIM Server may need to be restarted if the property was not previously set to this value.) For details, see cimconfig(1M). Note that communication between the managers and members of groups is established using SSL certificates that are supplied by the GiCAP software.
NOTE: On HP-UX 11i v2 systems, updated firmware might be required by the nPar or Virtual Partition software, as documented for these products.
Required Patches for HP-UX 11i v2
The following patches are required for Instant Capacity version 9.x on HP-UX 11i v2:
PHKL_33752: S700_800 11.23 Itanium 2 Processor speed reporting patch required only for IA systems
PHCO_34721: killall(1M) patch
PHKL_35174: _CS_PARTITION_IDENT patch required for GiCAP onrx8640 and rx7640 systems
Instant Capacity Requirements 29
IMPORTANT: For the most recent required patches, see the Instant Capacity Installation page on the HP Software Depot (search for “B9073BA”):
http://www.hp.com/go/softwaredepot
HP-UX 11i v3 Requirements and Dependent Products
The following software is required for Instant Capacity version 9.x on HP-UX 11i v3:
HP-UX 11i v3
iCOD software bundle B9073BA (version 9.x) — Installed automatically when the HP-UX 11i v3 Operating Environment (OE) is installed, or download the most recent version from the HP Software Depot at http://www.hp.com/go/softwaredepot.
The kernel configuration must include the diag2 module.
WBEMSvcs bundle (version A.02.05 or higher)
nParProvider bundle (version B.31.01.07.01 or higher, available from the OE media)
If you have a virtual partitioned environment, the Virtual Partitions (vPars) software (bundle T1335BC) must be version A.05.01 or higher. vPars is available separately and is not included with the OE.
(GiCAP only) The CIM Server configuration property sslClientVerificationMode must be set to a value of “optional” on all GiCAP Group Managers and on all OS instances of all member systems. (The CIM Server may need to be restarted if the property was not previously set to this value.) For details, see cimconfig(1M). Note that communication between the managers and members of groups is established using SSL certificates that are supplied by the GiCAP software.
OpenVMS Version 8.4 Requirements
The following software is required for Instant Capacity version 9.x on OpenVMS Version 8.4:
HP OpenVMS Version 8.4 for Integrity Servers or later
iCAP software bundle BA484AA (version 9.x) — Included with OpenVMS Version 8.4 and automatically installed on relevant systems when Version 8.4 is initially installed
WBEMCIM bundle ( version X2.92 or higher) — Optionally installed with OpenVMS Version
8.4
nParProvider bundle — Installed with OpenVMS Version 8.4
SSL bundle (version SSL 1.4 or higher) — Optionally installed with OpenVMS Version 8.4

Network Requirements

GiCAP and iCAP do not use any network ports directly. However, version 9.0 GiCAP uses WBEM/SSL for the communication protocol, requiring use of the CIM HTTPS port 5989. GiCAP also uses ping (which uses port 7 for the echo protocol) and host lookup services (getaddrinfo and getnameinfo) which may use the Domain Name System (DNS), Network Information Service (NIS), or a local host file to provide the lookup function.

Email Requirements

For some configurations, previous versions of the Instant Capacity software (prior to B.07.x) required email connectivity to HP in order to send asset reports as encrypted email messages. Instant Capacity version B.07.x and later no longer require email connectivity or asset reporting, however, you can choose to configure it because it can be useful for viewing complexwide asset information at the Utility Pricing Solutions portal (http://www.hp.com/go/icap/portal).
30 Getting Started
Loading...
+ 202 hidden pages