Pay Per Use (PPU) User’s Guide for versions B.06.x Fifth Edition Manufacturing Part Number: T2351-90031 March 2004 United States © Copyright 2003-2004 Hewlett-Packard Development Company, L.P.
Legal Notices The information in this document is subject to change without notice. Hewlett-Packard makes no warranty of any kind with regard to this manual, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be held liable for errors contained herein or direct, indirect, special, incidental or consequential damages in connection with the furnishing, performance, or use of this material.
Copyright 1979, 1980, 1983, 1985-93 Regents of the University of California. This software is based in part on the Fourth Berkeley Software Distribution under license from the Regents of the University of California. Copyright 1988 Carnegie Mellon University Copyright 1990-1995 Cornell University Copyright 1986 Digital Equipment Corporation. Copyright 1997 Isogon Corporation Copyright 1985, 1986, 1988 Massachusetts Institute of Technology. Copyright 1991-1997 Mentat, Inc.
Publication History The manual publication date and part number indicate its current edition. The publication date will change when a new edition is released. The manual part number will change when extensive changes are made. To ensure that you receive the new editions, you should subscribe to the appropriate product support service. Contact your HP sales representative for details. IMPORTANT • First Edition: June 2003, 5187-2706, (PPU version B.06.
Conventions in this Guide This guide uses these typographic conventions: Boldface Words defined for the first time appear in boldface. Computer Computer font indicates system commands, file names, and literal items — which may be displayed by the computer. For example: file not found User input Bold, computer text indicates literal items that you type.
Contents 1. About this guide Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How to Use this Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . HP On Demand Solutions Program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents 4. Using the PPU Software PPU Web Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PPU Usage Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Understanding Utilization Capping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . New Partition Creation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1 About this guide This chapter covers the following topics: • “Introduction” on page 10 • “Overview” on page 12 • “PPU Information” on page 15 For more in-depth information, see the manpage ppu (5).
About this guide Introduction Introduction Welcome Welcome to the Pay Per Use (PPU) User’s Guide for versions B.06.x. HP’s pay per use (PPU) B.06.x software product provides you cost savings by charging for only the percent utilization of the processors in your HP enterprise server. As your computing demands vary, you are charged according to the processor usage. The PPU software product is a part of the HP On Demand Solutions (ODS) program. NOTE PPU versions B.06.00, B.06.01, B.06.02, B.06.03, and B.06.
About this guide Introduction • Appendix A, Open Source and Licenses lists the open source components used by the PPU software — and the CURL MITX and OpenSSL licenses. • Appendix B, Special Considerations describes export issues with the PPU software, inactivating partitions, and validating PPU utilization information with PPU web portal reports. • Appendix C, Glossary explains PPU systems and software terms. • Appendix D, Manpages contains the actual manpages for ppu, ppud, and ppuconfig.
About this guide Overview Overview System Overview PPU versions B.06.x consists of the following components: 1. PPU system (https client) 2. Utility meter 3.
About this guide Overview https Client The https client, which runs on the PPU system as a daemon, reports the following information to the utility meter: • System-identification information • Hardware-partition information • Virtual-partition information • Per-processor utilization information for the operating system instance You interact with the https client only when entering configuration information.
About this guide Overview Most Recent PPU Version and Supported Platforms Table 1-1 Software and Version PPU B.06.04 (T2351AA) PPU B.06.03 (T2351AA) Most Recent PPU Version and Supported Platforms Operating System Version HP-UX 11i v2 HP-UX 11i v1 Supported Hardware Platforms hp Integrity servers: Superdome, rx8620, and rx7620 hp 9000 servers: Superdome, rp8400, and rp7410 Notes Available on: • http://software.hp.
About this guide PPU Information PPU Information PPU User’s Guide History This is the fifth edition of the Pay Per Use (PPU) User’s Guide for versions B.06.x. Locating the PPU User’s Guide for versions B.06.x You can find the Pay Per Use (PPU) User’s Guide for versions B.06.x in the following locations: • For the most recent version of the user’s guide, visit the following HP documentation web site (search for “PPU User’s Guide”): docs.hp.
About this guide PPU Information 16 Chapter 1
2 Understanding PPU Requirements This chapter covers the following topics: • “PPU Program Requirements” on page 18 • “PPU Software Requirements” on page 19 • “PPU System Move Requirements” on page 21 For more in-depth information, see the manpage ppu (5).
Understanding PPU Requirements PPU Program Requirements PPU Program Requirements You must comply with the following HP On Demand Solutions program conditions to participate in the PPU program: • Maintain the HP PPU software — a non-intrusive and low overhead software module that resides on the PPU system — on every partition, including virtual partitions • Maintain the (HP required) hardware and software operation of the PPU utility meter • Maintain the https connection from the PPU system/partition t
Understanding PPU Requirements PPU Software Requirements PPU Software Requirements PPU systems are required to run the PPU software on every partition which reports information to the utility meter (located on your network). If your PPU system does not send usage reports, via the https client, your system’s processors may be assumed to be 100% utilized. Your PPU system is shipped with the correct version of HP-UX and the PPU software bundle.
Understanding PPU Requirements PPU Software Requirements HP-UX 11i v1 Requirements For PPU Versions B.06.x on HP-UX 11i v1 IMPORTANT The following software is required for PPU versions B.06.x on HP-UX 11i v1: ❏ HP-UX 11i v1 ❏ PPU software bundle T2351AA (version B.06.x) located on the following HP web site (search for “T2351AA”): software.hp.com ❏ Kernel driver diag2 For Superdome systems, the Utility subsystem firmware must be 6.40 or greater. PPU is not supported on versions prior to 6.40.
Understanding PPU Requirements PPU System Move Requirements PPU System Move Requirements If you are planning to move your PPU system from its current street address, refer to your Master Lease Agreement for details.
Understanding PPU Requirements PPU System Move Requirements 22 Chapter 2
3 Installing and Configuring PPU Software This chapter covers the following topics: Chapter 3 • “Getting Started” on page 24 below • “Installing PPU Software” on page 26 below • “Configuring PPU Software” on page 29 below • “Re-installing PPU Software” on page 33 • “Un-installing PPU Software” on page 34 23
Installing and Configuring PPU Software Getting Started Getting Started Factory Integrated You do not need to install the PPU B.06.x software if your processors and Systems software were ordered with your HP enterprise server in (or after) January 2003. The PPU software was already installed by HP prior to delivery. However, initially you need to configure the PPU software to communicate with the utility meter. NOTE The PPU B.06.
Installing and Configuring PPU Software Getting Started Step 3. Verify the ppud daemon is running on the system/partition by executing the following command: /usr/bin/ps -e | grep ppud You should see the ppud daemon listed as an active process on the system/partition. If you do not receive the correct result for Step 3 (above) see “Manually Starting the ppud Daemon” on page 32 for details. IMPORTANT You need to configure the PPU software so your PPU system/partition communicates with the utility meter.
Installing and Configuring PPU Software Installing PPU Software Installing PPU Software If you currently have PPU software installed that is prior to version B.05.00 (for example, version B.04.01), contact your HP sales representative to find out how to update to PPU B.06.x software. How To Find The Latest Patches This document lists the patches required to install and run PPU B.06.x software known at the time of publication. To find the most current patches, go to the HP Software Depot at software.hp.
Installing and Configuring PPU Software Installing PPU Software Step 4. Mount the drive to the desired directory. The following example uses the /dev/dsk/c1t2d0 device file (from Step 2, above) and the /cdrom directory. To mount the drive, enter a similar command as: Mount Example: mount -r /dev/dsk/c1t2d0 /cdrom Step 5. Install the PPU B.06.x bundle T2351AA from the OE CD/DVD: swinstall -s /cdrom T2351AA Step 6. Continue with “Configuring PPU Software” on page 29.
Installing and Configuring PPU Software Installing PPU Software For HP-UX 11i v1 or 11i v2 - Installing from the HP Software Depot Step 1. Do a search for the PPU product T2351AA at HP’s Software Depot web site: software.hp.com Step 2. Click on the pay per use software (% utilization) link that appears as a result of your search Step 3. Read the “overview” page, then click on the installation link (near the bottom). Step 4. Read the “installation” page, then click on the Receive for Free button. Step 5.
Installing and Configuring PPU Software Configuring PPU Software Configuring PPU Software After you have successfully installed the PPU B.06.x software, using the swinstall command, you need to configure the PPU https client connection to the utility meter. The utility meter must be configured on every partition, including virtual partitions. NOTE The following configuration procedure assumes your utility meter has been installed on the PPU system’s network by your HP service representative.
Installing and Configuring PPU Software Configuring PPU Software Configuring the Proxy Server (if necessary) Most networks do not require a proxy server to connect to devices within their intranet.
Installing and Configuring PPU Software Configuring PPU Software NOTE You can set the utility meter, proxy server, username/password, and system identifier (or any combination) with the single command: /usr/sbin/ppuconfig -m meter -p proxy[:port] -u -s system_id Viewing the System Settings You can view the utility meter, proxy server, proxy-server username, proxy-server password (not displayed), and system identifier settings with the ppuconfig command (with no options).
Installing and Configuring PPU Software Configuring PPU Software Manually Starting the ppud Daemon The ppud daemon is started automatically when you specify the utility meter using the /usr/sbin/ppuconfig -m meter command. It is also automatically started at system boot if a utility meter is configured. However, the ppud daemon’s process may have inadvertently been killed on the system/partition. If the ppud daemon is not running on your PPU system/partition, you need to start it manually.
Installing and Configuring PPU Software Re-installing PPU Software Re-installing PPU Software If you re-install HP-UX on a PPU system (for example, installing HP-UX by either cold-installing or installing from a “golden image”), you need to perform the following steps to restore your PPU configuration: Step 1. Manually save your PPU configuration file by backing up the following file: /etc/ppu/ppu_config Step 2. Install the PPU software (see “Installing PPU Software” on page 26 for details) Step 3.
Installing and Configuring PPU Software Un-installing PPU Software Un-installing PPU Software You should not un-install the PPU software from your PPU system. WARNING If you un-install the PPU software, you may be charged for 100% utilization of the processors in your PPU system.
4 Using the PPU Software This chapter covers the following topics: Chapter 4 • “PPU Web Portal” on page 36 • “PPU Usage Report” on page 37 • “Understanding Utilization Capping” on page 42 • “New Partition Creation” on page 43 35
Using the PPU Software PPU Web Portal PPU Web Portal PPU customers have access to detailed usage information via a web portal. The PPU web portal contains the following information: • Computed-average usage on a daily basis • Computed-average usage for a specified period of time • Client reports (usage reports that are sent to HP) The PPU web portal can be accessed from the HP web site: www.hp.
Using the PPU Software PPU Usage Report PPU Usage Report The most recent PPU usage report is retained on your PPU system/partition. You can access the usage report at: /var/ppu/PPUReport.xml If you open a PPU usage report with a browser that understands XML, it makes the usage report easier to read. The following PPU usage report example displays the self-describing information contained in a PPU usage report. Example 4-1 PPU 6.x Usage Report
Using the PPU Software PPU Usage Report - 4 440 75.000 - 5 440 80.000 - 6 440 40.000 - 7 440 65.
Using the PPU Software PPU Usage Report 36.000 - 4 4 1033823400 Sat Oct 5 00:10:00 2002 MDT 300 - 4 440 17.
Using the PPU Software PPU Usage Report 63.000 - 6 440 55.000 - 7 440 49.
Using the PPU Software PPU Usage Report MDT 300 - 4 440 44.000 - 5 440 53.000 - 6 440 32.
Using the PPU Software Understanding Utilization Capping Understanding Utilization Capping You are billed by HP according to the usage of the active processors in your PPU system. For example, on a 32 processor Superdome system, you are billed the same amount whether you utilize all 32 processors at 50% utilization, or if you utilize 16 processors at 100% utilization. There are three methods to cap the usage of processors on your PPU system: 1.
Using the PPU Software New Partition Creation New Partition Creation You must install and configure the PPU software on any newly created partition, including virtual partitions. See “Installing PPU Software” on page 26 for installation details. See “Configuring PPU Software” on page 29 for configuration details. IMPORTANT Chapter 4 A partition that doesn’t have the PPU https client installed and configured (reporting to the utility meter) could be assumed to have its processors 100% utilized.
Using the PPU Software New Partition Creation 44 Chapter 4
5 Troubleshooting This chapter covers the following topics: • Chapter 5 “Troubleshooting the PPU Software” on page 46 45
Troubleshooting Troubleshooting the PPU Software Troubleshooting the PPU Software In the event the PPU software is not functioning, perform the following step: Step 1. /usr/sbin/swverify T2351AA The above step verifies: • The PPU software is installed • The PPU system’s utility meter is installed and configured • The https connection from the PPU system to the utility meter is functional Alternatively, you can troubleshoot your PPU system by performing the following individual steps: 1.
Troubleshooting Troubleshooting the PPU Software 3. Ensure the ppud daemon is running by executing the following command: /usr/bin/ps -e | grep ppud You should see a ppud process running. If you do not, then start the ppud process by executing the following command: /sbin/init.d/ppu start 4. Check the syslog for ppud errors by viewing the file: /var/adm/syslog/syslog.log 5.
Troubleshooting Troubleshooting the PPU Software 48 Chapter 5
6 Frequently Asked Questions This chapter covers frequently asked questions on the following topics: Chapter 6 • “Pay Per Use Program” on page 50 • “Pay Per Use Software” on page 51 49
Frequently Asked Questions Pay Per Use Program Pay Per Use Program What is pay per use? Pay per use (PPU) is a pricing model in which you are charged for actual processor usage.
Frequently Asked Questions Pay Per Use Software Pay Per Use Software What software product is required for PPU systems? There are two HP pay per use (PPU) software products: • T2351AA (versions B.05.00 and B.06.x): is the newest PPU offering and billing is based on the percent utilization of processors • T1322AA (versions B.04.
Frequently Asked Questions Pay Per Use Software We received an e-mail message indicating a HP-UX partition did not report system configuration data. What is the problem and how do I correct it? Make sure that the PPU software is installed and the https connection is properly configured to the utility meter for the partition. All partitions, including virtual partitions, must have the PPU software installed and the https connection configured to connect to the utility meter.
A Open Source and Licenses This appendix lists the Open Source components used by the PPU software and the applicable licenses for the components.
Open Source and Licenses Open Source Components Open Source Components There is no charge for using HP’s PPU software.
Open Source and Licenses CURL MITX License CURL MITX License The PPU software is released under the following license. COPYRIGHT AND PERMISSION NOTICE Copyright (c) 1996 - 2002, Daniel Stenberg, . All rights reserved.
Open Source and Licenses OpenSSL License OpenSSL License The following license applies to OpenSSL with libcrypto. LICENSE ISSUES ============== The OpenSSL toolkit stays under a dual license, i.e. both the conditions of the OpenSSL License and the original SSLeay license apply to the toolkit. See below for the actual license texts. Actually both licenses are BSD-style Open Source licenses. In case of any license issues related to OpenSSL please contact openssl-core@openssl.org.
Open Source and Licenses OpenSSL License * 5. Products derived from this software may not be called “OpenSSL” * nor may “OpenSSL” appear in their names without prior written * permission of the OpenSSL Project. * * 6. Redistributions of any form whatsoever must retain the following * acknowledgment: * “This product includes software developed by the OpenSSL Project * for use in the OpenSSL Toolkit (http://www.openssl.
Open Source and Licenses OpenSSL License * Copyright remains Eric Young’s, and as such any Copyright notices in * the code are not to be removed. * If this package is used in a product, Eric Young should be given attribution * as the author of the parts of the library used. * This can be in the form of a textual message at program startup or * in documentation (online or textual) provided with the package.
B Special Considerations This appendix describes special considerations for PPU systems.
Special Considerations Export Issues Export Issues The PPU software uses Secure Socket Layer (SSL) to encrypt data transmitted between: • The PPU system and the utility meter • The utility meter and HP Because SSL uses 128 bit encryption, the PPU software cannot be exported to certain countries, as outlined by the Bureau of Industry and Security, in the U.S. Department of Commerce. The distribution channels for acquiring the PPU software comply with these export limitations.
Special Considerations Inactive Partitions in PPU Systems Inactive Partitions in PPU Systems Baseline usage for the PPU program is included in the minimum monthly payment. Baseline usage is assumed to be 25%. That is, 25% processor utilization is included in the minimum monthly payment. Inactive partitions in PPU systems are covered under baseline usage. NOTE An inactive PPU partition is reported as “IDLE”, in the measurement “Method” column, on the PPU web portal report.
Special Considerations Inactive Partitions in PPU Systems Cell boards assigned to active partitions must have at least one active processor. If your system/partition does not have any near term need to have at least one processors active on the system, then you can either: 1. Inactivate partitions (or) 2. Un-assign cell boards from partitions. When you un-assign cell boards from partitions there are zero active processors on that cell board. Un-assigned cell boards are covered under the baseline usage.
Special Considerations Verifying PPU Utilization Information Verifying PPU Utilization Information Your PPU system/partition’s processor utilization information is available from the HP PPU web portal. See “PPU Web Portal” on page 36 for details of the PPU web portal. If you are interested in verifying PPU utilization information against the PPU web portal information, you can use the sar command to compare processor utilization numbers.
Special Considerations Verifying PPU Utilization Information samples taken. In this example, there are 12 utilization samples taken every 5 minutes; therefore, one hour of utilization data is collected. Because the PPU web portal also reports in 5 minute increments, it is recommended to use a 5 minute interval duration with the sar command. You can vary the amount of sar information with its last argument. Step 2.
C Appendix C Glossary 65
Glossary PPU Terminology PPU Terminology The following terms are commonly used in conjunction with PPU: configured processors Processors that have been configured at the boot interface and are now available for activation. deconfigured processors Processors that have not yet been configured at the boot console interface (BCH). The iCOD software cannot activate a processor that is deconfigured.
Glossary PPU Terminology pay per use The HP On Demand Solutions product that has a pricing model in which you are charged for actual processor usage. You acquire a specific hardware platform, and number of processors, and are charged for the actual usage, based on the percent utilization of the processors. portal A HP web site that gives customers an interface to view their PPU system/partition utilization information. See “PPU Web Portal” on page 36 for details.
Glossary PPU Terminology 68 Appendix C
D PPU Manpages This appendix contains the manpages for PPU. The manpages are: NOTE Appendix D • “ppu (5) Manpage” on page 70 — An overview of the PPU software • “ppud (1M) Manpage” on page 71 — Data provider giving system configuration and CPU usage information • “ppuconfig (1M) Manpage” on page 73 — Set the configuration values of a pay-per-use system The information contained in the following manpages is current at the time of publication for this manual.
PPU Manpages ppu (5) Manpage ppu (5) Manpage ppu (5) NAME ppu – Pay Per Use software for HP-UX DESCRIPTION Pay Per Use (PPU) is a program under which customers pay only for computing capacity that they use. The PPU Software provides services for metering resource utilization on supported HP systems. The PPU software communicates with a utility meter to report utilization data. The utility meter in turn transmits the utilization data to HP for proper billing.
PPU Manpages ppud (1M) Manpage ppud (1M) Manpage ppud (1M) NAME ppud – Pay Per Use daemon SYNOPSIS Path: /usr/lbin ppud DESCRIPTION ppud is a daemon that provides system configuration and CPU usage information to a utility meter system for billing purposes. This daemon runs on Pay Per Use systems and meters CPU utilization and system configuration information.
PPU Manpages ppud (1M) Manpage SEE ALSO ppuconfig (1M), ppu (5) 72 Appendix D
PPU Manpages ppuconfig (1M) Manpage ppuconfig (1M) Manpage ppuconfig (1M) NAME ppuconfig – configure Pay Per Use daemon SYNOPSIS Path: /usr/sbin ppuconfig [-m meter] [-p proxy[:port]] [-s system_id|-h] [-u] ppuconfig -t DESCRIPTION ppuconfig is a tool for configuring communication between the Pay Per Use daemon ppud (see ppud(1M)) and a utility meter. A utility meter must be specified for a Pay Per Use system before the ppud daemon will collect and send utilization data to HP.
PPU Manpages ppuconfig (1M) Manpage Options ppuconfig recognizes the following command-line options and arguments: -m meter Specifies the utility meter that the Pay Per Use system should use for reporting. The meter can be specified as a fully qualified hostname or IP address. A non-blank value is required. -p proxy[:port] Specifies the proxy server that should be used by this system for HTTPS transmission if a proxy server is required.
PPU Manpages ppuconfig (1M) Manpage AUTHORS ppuconfig was developed by HP FILES /etc/ppu/ppu_config File containing utility meter configuration data. If this file is removed, the ppud daemon will not be started at system boot and utilization data will not be transmitted to HP.
PPU Manpages ppuconfig (1M) Manpage 76 Appendix D
Index C configured processors, defined, 66 configuring PPU software, 29 conventions, User’s Guide, 5 CURL MITX license, 55 moving a system, requirement, 21 D deconfigured processors, defined, 66 O On Demand Solutions program, 11 open source components used, 54 OpenSSL license, 56 E example usage report, 37 executable and config files, 47 export issues, 60 F failed partition, 62 files, executable and config, 47 frequently asked questions PPU, 50 PPU software, 51 G getting started, 24 glossary, 66 golden
Index ppud (1M) manpage, 71 ppud daemon, starting, 32 processors configured, defined, 66 deconfigured, defined, 66 program requirements, PPU, 18 proxy server, configuring, 30 R re-installing PPU software, 33 reports sent by PPU software, 52 required patches, for HP-UX 11i v1, 20 S sar, utilization verification, 63 software requirements, PPU, 19 starting the ppud daemon, 32 supported platforms PPU, 14 system identifier, configuring, 30 system overview, 12 system settings, viewing, 31 T terminology, 66 troubl
