CLI Support on OpenVMS | HP Instant Capacity (iCAP) manual

CLI Support on OpenVMS

OpenVMS provides a CLI (command-line interface) to the Instant Capacity software. The HP-UX command syntax can be implemented using foreign command symbols. The DCL ICAP command provides DCL command support.

HP-UX Style Commands

The HP-UX command syntax can be used on OpenVMS systems by defining foreign command symbols to the iCAP images. Add the following three symbol declarations to your LOGIN.COM file or to the SYLOGIN file to define commands that use the HP-UX syntax:

$ icapmodify :== $ICAP_MODIFY $ icapnotify :== $ICAP_NOTIFY $ icapstatus :== $ICAP_STAT

Command options are specified as described in the HP-UX manpages for each command.

OpenVMS Command Mapping

Table B-1shows the HP-UX iCAP commands and their OpenVMS equivalents.

Table B-1 HP-UX and OpenVMS Command Equivalents

HP-UX Style	OpenVMS Style
icapstatus	icap show status
icapstatus -s	icap show status/snapshot
icapmodify -C <codeword>	icap apply "codeword"
icapmodify -c <address>	icap set email/contact="address"
icapmodify -f <address>	icap set email/from="address"
icapmodify -i <id>	icap set system_id "id"
icapmodify -r	icap reconcile
icapmodify -w <days>	icap set warning_days "days"
icapmodify -a	icap activate /cpu=/defer/ticap
icapmodify -d	icap deactivate /cpu/defer
icapmodify -s	icap set active_cpus n
icapnotify -a	icap set asset/state=onoff
icapnotify -n	icap set notification/state=onoff
icapmanage -i -u <rule_file>	icap manage install <rule_file>
icapmanage -C <codeword>	icap manage codeword <codeword>
icapmanage -a -g <group_name>	icap manage add group <group_name>
icapmanage -r -g <group_name>	icap manage remove group <group_name>
icapmanage -T <host>[,<host>]...[-g	icap manage test <host,host,...>
<group_name>]	[/group=<group_name>]
icapmanage -a -m	icap manage add member <member_name>
<member_name>:<host>[,<host>]...	/host_list=(host,host,...) [/group=<group_name>]
-g<group_name>
icapmanage -r -m <member_name>	icap manage remove member <member_name>
icapmanage -s -g <group_name> [-b]	icap manage status <group_name> [/BRIEF] [/FULL]
[-v]

210 Considerations for OpenVMS Systems

Image 210

HP Instant Capacity (iCAP) manual CLI Support on OpenVMS, HP-UX Style Commands, OpenVMS Command Mapping

Contents

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