ICAP commands, Generating snapshot | HP Instant Capacity (iCAP)

iCAP commands

iCAP supports a limited set of command options on HP Integrity Superdome 2. The user is presented with command options that are sufficient to self enforce the compliance.

Viewing number of active cores

iCAP ensures that the number of active cores are equal to the number of usage rights on a partition. You can view the number of active cores on the partition using the following command:

machinfo

The number of logical processors displayed under the CPU info section is the number of active cores on the partition.

NOTE: If Hyper-threading is on, the machinfo command reports twice the number of actual active cores, as logical processors. For example, if the same output as shown below was captured after turning on Hyper-threading, there would be 14 logical processors reported.

Sample output:

#machinfo CPU info:

2 Intel(R) Itanium(R) Processor Family processors (1.47 GHz, 20 MB)

4.8GT/s QPI, CPU version C0

7 logical processors

Memory: 8043 MB (7.85 GB)

Firmware info:

Firmware revision: 001.040.000

FP SWA driver revision: 1.18

IPMI is supported on this system.

BMC firmware revision: 0.05

Platform info:
Model:		"ia64 hp Superdome2 SD16"
Machine ID	number:	f6cf-f0e7-4ed6-9718-1165c2f
Machine serial number:		testing
OS info:
Nodename:	beer07b
Release:	HP-UX B.11.31
Version:	U (unlimited-user license)
Machine:	ia64
ID Number:	411663
vmunix _release_version:
@(#) $Revision: vmunix:		B.11.31_LR FLAVOR=perf

Generating snapshot

An audit snapshot is to be presented at the Utility Pricing Portal while purchasing usage rights for iCAP resources. The audit snapshot is an encrypted representation of the iCAP resources on the complex. This can be generated using the icapstatus command as shown below: icapstatus –s

Sample output:

# icapstatus -s

This audit snapshot string may be presented to the HP Portal or to WTEC in order to establish the current iCAP state of the complex. The string is an encrypted and signed representation of the global icapstatus information. Product number: *****

Serial number: ******

Audit snapshot:

iCAP commands 131

Image 131

HP Instant Capacity (iCAP) manual ICAP commands, Viewing number of active cores, Generating snapshot

Contents

HP Instant Capacity users guide for Version Copyright 2000-2010 Hewlett-Packard Development Company, L.P Table of Contents Temporary Instant Capacity 101 149 129137 143 229 209223 List of Figures 10-2 List of Tables10-1 138 List of Examples110 111 This chapter covers the following topics About This GuideIntended Audience New and Changed Information in This Edition Publishing History Document Organization Typographic Conventions Locating the Instant Capacity release notes for Version Location of Instant Capacity InformationInstant Capacity user’s guide for Version Manpages HP Encourages Your Comments For more in-depth information, see icap5 Introduction to Instant Capacity Memory Instant Capacity Summary Terminology System Overview OverviewSoftware Product Overview Instant Capacity Software Instant Capacity System Hardware Instant Capacity Database Utility Pricing Solutions PortalInstant Capacity Administration System Other System Management Commands B9073BA Introduction to Instant Capacity Past Versions and Supported Operating Systems Page Getting Started HP-UX 11i v1 Requirements and Dependent Products Instant Capacity RequirementsProgram Requirements Software Requirements HP-UX 11i v2 Requirements and Dependent Products Required Patches for HP-UX 11i OpenVMS Version 8.4 Requirements Network RequirementsEmail Requirements HP-UX 11i v3 Requirements and Dependent Products Instant Capacity Integration with Virtual Partitions HP-UX System Contact RequirementUsage Rights Requirement Http//docs.hp.com Cell Boards and Memory Instant Capacity ComponentsOverview Processors and Cores Getting Started Global Instant Capacity Instant Capacity Codewords Temporary Instant Capacity Instant Capacity Compliance and Enforcement Configuration Change Notification Increasing Processing Capacity by Purchasing RTUs Core Activation Instant Capacity Cell Board On OpenVMS Systems Command will display the message Verification succeededInstant Capacity Software Validation On HP-UX Systems Status Reporting on Instant Capacity Systems Time Zone Considerations Installing and Removing Instant Capacity Software Factory Integrated Systems Installing Instant Capacity SoftwareCommand output displays the message Verification succeeded Install the B.09.x bundle B9073BA from the DVD Installing Instant Capacity on OpenVMS Systems For All HP-UX Installations Preserving current Instant Capacity information Reinstalling Instant Capacity Software Removing Instant Capacity Software Page Using Instant Capacity to Manage Processing Capacity Checking the Status of your Instant Capacity System Usr/sbin/icapstatus Example 4-1 Sample Session of icapstatus on HP-UX Usr/sbin/icapmodify -c mjones@corp.com Setting System Contact Information Example 4-2 Applying an RTU Codeword HP-UX Applying a Right To Use RTU Codeword Permanent Activation of Instant Capacity Components Constraints Activating CoresActivating Cores in nPartitions Example 4-3 Activating an Additional Core HP-UX Example Core Activation Session Partition Constraints Deactivating CoresDeactivating Cores in nPartitions Example 4-4 Deactivating an Active Core HP-UX Example 4-6 Undoing an Accidental Deferred Activation HP-UX Overriding Deferred Activation and Deactivation Load-Balancing Active Cores Understanding and Managing Intended Active Values Static Virtual Partitions When to Use the vparmodify or icapmodify CommandsWhat is Unused Capacity Deactivating Cores in a Virtual Partition Environment Activating Cores in a Virtual Partition Environment Example 4-7 vPar Boot-Time Compliance Message Boot Time Compliance Assigning a Cell to a Partition Using Instant Capacity to Manage Processing Capacity Unassigning a Cell from a Partition Cell Available Usage Rights Software Application Considerations Test Activation of Cores Using Temporary Capacity Replacement of Failed Cores Using Instant Capacity to Manage Processing Capacity Temporary Instant Capacity Temporary Instant Capacity Overview Temporary Instant Capacity Overview HP-UX Licensing and Support with Temporary Instant Capacity Ordering Temporary Instant Capacity Example 5-1 Applying a Temporary Capacity Codeword HP-UX Using Temporary Instant CapacityAcquiring and Configuring Temporary Instant Capacity Using Temporary Instant Capacity Usr/sbin/icapmodify -t -a Usr/sbin/icapstatus Temporary Capacity and Virtual Partitions Yes Zoo8 Zoo9 Zoo10 Zoo11 Zoo12 Zoo13 Unassigned Cells Temporary Capacity Expiration Reminder Tracking Usage of Temporary Instant Capacity Example 5-4 Temporary Capacity Expiration Reminder Icapmodify -w Temporary Instant Capacity Warning Period Temporary Instant Capacity Temporary Capacity Negative Balance Error for Activation with Insufficient Temporary CapacityTemporary Instant Capacity Exceptions Temporary Capacity Balance Needing Action Temporary Instant Capacity Temporary Instant Capacity Exceptions Page Instant Capacity Cell Board Instant Capacity Cell Board Ordering Instant Capacity Cell Board HP-UX and OpenVMS License and Support Acquiring Usage Rights for Instant Capacity Cell Board Cell Board Activation Requiring Additional Core Usage Rights Activation of an Instant Capacity Cell Board Accidental Activation of an Instant Capacity Cell Board Instant Capacity Cell Board Activation Exception Error Instant Capacity Cell Board and Temporary Instant Capacity Global Instant Capacity Global Instant Capacity Overview Using Global Instant Capacity Global Instant Capacity Requirements Standby Group Managers Global Instant Capacity Group Managers Run icapmanage -Q Global Instant Capacity Grouping Rules Example 7-1 Applying a Sharing Rights Codeword Example 7-1shows how to apply a sharing rights codewordGlobal Instant Capacity Sharing Rights Example 7-2 Creating a Group Creating Global Instant Capacity Groups Example 7-3 Adding a Member to a Group Usr/sbin/icapstatus Effect of Temporary Capacity Global Instant Capacity Resource SharingExample Core Rights Sharing Status Reporting Example Cell/Memory Sharing Temporary Capacity and Status Reporting Example Activation Using Pooled Temporary CapacityGlobal Instant Capacity and Temporary Capacity Temporary Capacity and Freed Usage Rights Temporary Capacity Prefetch Removing a Global Instant Capacity Group Member Reinstalling a Group Member Group Manager Availability No Standby Manager Group Manager Failover Considerations Adding New Partitions Upgrades and Global Instant Capacity Effects of Rights Seizure When to Migrate Usage Rights and When to Seize Usage RightsRights Seizure Temporary Capacity and Rights Seizure Down Partitions with Powered-On Cells Summary of Rights Seizure Additional HA SolutionsOther Considerations Rights Seizure Http//docs.hp.com Considerations for Multiple Groups Additional Considerations Case 3 GiCAP Using Instant Capacity on HP Integrity SuperdomeICAP From compliance check paradigm to self enforcement Resizing Partitions Installing iCAP on HP Integrity SuperdomeImportant Considerations Sizing Partitions Generating snapshot ICAP commandsViewing number of active cores Activating Cores Setting usage rights for a partitionUsing iCAP Memory Deactivating Cores NPar2 Use Case 1 Initial ConfigurationICAP Use Cases Core migration between partitions in a complex Configuration of Complex1 post core migration Use Case 1 Configuration of Complex After Core MigrationUse Case 2 Initial Configuration 4contains Initial configuration of Complex2 Configuration of Complex2 post core migration 136 Handling Compliance Exceptions Troubleshooting More cells active than expected Negative temporary capacity balance Troubleshooting the Instant Capacity Software Additional Troubleshooting Steps for Email Connectivity As root, execute the command Diagnosing Email Configuration Frequently Asked Questions Instant Capacity Software Icapmodify if a configuration change Triggered By Asset reporting email sent by the Instant Capacity software Instant Capacity Hardware Global Instant Capacity Instant Capacity HP-UX Manpages ICAP --Instant Capacity software for HP-UX ICAP5Initializing an Instant Capacity Server Codewords Status of Instant Capacity Components Software Removal Temporary Capacity TiCAP Program Virtual PartitionsHP Integrity Virtual Machines Integrity VM Processor Sets GiCAP Groups Instant Capacity Cell BoardGlobal Instant Capacity GiCAP Grouping Rules GiCAP Group ManagerStandby GiCAP Group Manager GiCAP Group Members GiCAP Member Removal Upgrades and GiCAPGiCAP Group Creation GiCAP Resource Sharing Multiple Group Considerations Groups and the TiCAP BalanceGroup Compliance Additional GiCAP Considerations Group Manager Failover Considerations See Also Compliance Synopsis Icapmanage1M Options Communication only and is not saved or stored Group, you are prompted for the root password for eachSpecified host. The password is used for initial Specify virtual machine or guest OS instances For a given command execution, host removals are If there are intermittent problems with networkUsed when the vPar or nPar configuration of a member Host to be added. The password is used for initial Manager including temporary capacity. For members Provide verbose status information. Include all levelsInformation group, manager and member. For Group Managers, include resources being held by the Group 164 Containing the specified host. Core usage rights must be Using the -zoption before failbackAvailable in the GiCAP group or the command fails This option can be useful particularly when core usage This command will prompt for the root password Hardware and grouping rules. Specification of the -UFile instead of the installed rule file, and can be used to Host system to be set up as a standby Group Manager Host names comprising each member complex Symbols used in the displayStatus Information Information displayed for each GiCAP group Purchased For inactive cells associated with inaccessibleInaccessible members no partitions could be Inactive because usage rights have not been Specified Field is displayed only when the -voption isFrom member systems where none Seized from members where none Summary field is not displayed when Members for disaster recoveryWhen the -voption is specified. However, if Partitions could be contacted. This member Seized Members for purposes of disaster recoveryIs specified and only for systems where usage Member system from which they were International Code Set Support Environment Variables Take control as an active Group Manager Show the full status of the ADMIN1 groupRemove the ADMIN1 group Remove host mystandby from use as a standby Group Manager Compliance Icapmodify1M Options and Arguments Intended Active Rights across the complex, on the next reboot of any Reboot. This option modifies the default behaviorPending deferred request and resets the values for Causing an immediate activation or deactivation Configuration change notification email Not necessary to use the -toption when using the -dCommand temporarily reduces the consumption Temporary capacity. a subsequent core activation using Apply an iCAP codeword Icapmodify was developed by HP Set the systemid to AssetNum234Set the system contact email address to superuser@corp.com Obsolescent Icapnotify1M Turn email asset reporting off Turn configuration change notification onTurn configuration change notification off Turn email asset reporting on Icapstatus display fields Symbols used in the displayIcapstatus1M Information displayed for a GiCAP group Local virtual partition that are currently active Information displayed for the local virtual partitionFrom the GiCAP group Borrowed/Loaned memory usage Information displayed for the local nPartition Complex Instant Capacity Resource Summary For the hard partition Activated during a boot operation. Typically, this isCommand. Other commands such as parmodify Member of a group Icapstatus was developed by HP Icapd was developed by HP Icapd1MIcapd --Instant Capacity iCAP daemon 190 This appendix covers the following topics Special Considerations Assumed Memory Values Assumed Values in icapstatus CommandAssumed Processor Values Upgrading to Instant Capacity version B.06.x or later HP-UX Usr/sbin/icodmodify command Execute the following command Dual-Core Support in Instant Capacity Systems New Partition Creation and Instant Capacity Table A-1 Removing a Cell and Decreasing Inactive Cores Shutting Down a Partition with Instant Capacity Cores Page Par Commands from PC System Management Station Psets on vPars Instant Capacity Compatibility with Processor Sets HP-UXPsets on nPars Before you start Configuring Email on Instant Capacity SystemsEmail Configuration On Partitionable Systems Overview of email routing across the internet Sendmail application Reverting to the Default From Address Steps to Confirm or Diagnose Email ConfigurationConfiguring Instant Capacity’s From Email Address Configuring a Specified From Address Testing Email Transmission of the Asset Report Configuring Your Server to Send but Not Receive Email On HP Integrity Superdome Systems Measurement Software and Instant Capacity SystemsHP OpenView Measurement Products Other Measurement Software Monarch Processors Dynamic Processor Resilience HP-UX Disabling the iCAP daemon HP-UX Security IssuesSecurity Tuning Options Customer protections which iCAP assumes to be in place Considerations for OpenVMS Systems CLI Support on OpenVMS HP-UX Style CommandsOpenVMS Command Mapping Table B-1 HP-UX and OpenVMS Command Equivalents Table B-2 OpenVMS iCAP Files OpenVMS iCAP Files Format DCL CommandsDCL Icap Command Name Parameter Icap Apply Icap Deactivate Icap Reconcile Value Parameters Icap SET Warningdays days Icap Show Icapserver iCAP server process Description Email Considerations Special OpenVMS-Specific Features and ConsiderationsCore Activation and Deactivation Restrictions 222 Activate cell Glossary EFI Inactive RTU TiCAP Wbem Index Hpmc RTU Wbem