HP PPU User Manual

Pay Per Use (PPU) User’s Guide for

versions B.06.x

Fifth Edition

Manufacturing Part Number: T2351-90031

March 2004

United States

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.

Warranty

A copy of the specific warranty terms applicable to your Hewlett-Packard product and replacement parts can be obtained from your local Sales and Service Office.

Restricted Rights Legend

Use, duplication or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 for DOD agencies, and subparagraphs (c) (1) and (c) (2) of the Commercial Computer Software Restricted Rights clause at FAR

52.227-19 for other agencies. HEWLETT-PACKARD COMPANY

3000 Hanover Street Palo Alto, California 94304 U.S.A.

Use of this manual and supplied CDs is restricted to this product only. Additional copies of the programs may be made for security and back-up purposes only. Resale of the programs, in their present form or with alterations, is expressly prohibited.

Copyright  2003-2004 Hewlett-Packard Development Company, L.P. All rights reserved. Reproduction, adaptation, or translation of this document without prior written permission is prohibited, except as allowed under the copyright laws.

PPU software is a product of the Hewlett-Packard Development Company, L.P. and is protected by copyright.

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. Copyright  1996 Morning Star Technologies, Inc. Copyright  1990 Motorola, Inc. Copyright  1980, 1984, 1986 Novell, Inc. Copyright  1989-1993 The Open Software Foundation, Inc. Copyright  1996 Progressive Systems, Inc. Copyright  1989-1991 The University of Maryland Copyright  1986-1992 Sun Microsystems, Inc.

Trademark Notices

UNIX is a registered trademark in the United States and other countries, licensed exclusively through The Open Group.

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.

• First Edition: June 2003, 5187-2706, (PPU version B.06.00 on HP-UX 11i v1) Available on June 2003 HP-UX 11i v1 Instant Information CD

• Second Edition: September 2003, T2351-90001, (PPU version B.06.01 on HP-UX 11i v1 and 11i v2) Available on September 2003 HP-UX 11i v1 Instant Information CD

• Third Edition: September 2003, T2351-90011, (PPU version B.06.02 on HP-UX 11i v1 and 11i v2) Available on September 2003 HP-UX 11i v2 Instant Information CD

• Fourth Edition: December 2003, T2351-90021, (PPU versions B.06.03 on HP-UX 11i v1) Available on web, print, and December 2003 HP-UX 11i v1 Instant Information CD

• Fifth Edition: March 2004, T2351-90031, (PPU version B.06.04 on HP-UX 11i v2) Available on web, print, and March 2004 HP-UX 11i v2 Instant Information CD

IMPORTANT New information may have been developed after the time of this

printing. For the most current information, visit the following HP documentation web site (search for “PPU user’s guide”):

docs.hp.com

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. For example, to change to your HP-UX account’s home directory, enter:

Italics Manual titles, variable in commands and emphasized

words appear in italics. For example, you would substitute an actual directory name for directory_name in this command:

cd directory_name

[ ]and | Brackets [] enclose optional items in command syntax.

The vertical bar | separates syntax items in a list of choices. For example, you can enter any of these three items in this syntax:

ls [-a | -i | -x]

Enter Text in this bold, sans-serif font denotes keyboard keys

and on-screen menu items. A notation like indicates that you should hold the

press

Ctrl key down and

Ctrl-Q

1. About this guide

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

How to Use this Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

HP On Demand Solutions Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

System Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Most Recent PPU Version and Supported Platforms . . . . . . . . . . . . . . . . . . . . . . . . . 14

PPU Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

PPU User’s Guide History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Locating the PPU User’s Guide for versions B.06.x . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Manpages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

2. Understanding PPU Requirements

PPU Program Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

PPU Software Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

HP-UX 11i v2 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

HP-UX 11i v1 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

PPU System Move Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Contents

3. Installing and Configuring PPU Software

Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Installing PPU Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

How To Find The Latest Patches. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

For HP-UX 11i v1 or 11i v2 - Installing from the OE Media . . . . . . . . . . . . . . . . . . . 26

For HP-UX 11i v1 or 11i v2 - Installing from the AR Media . . . . . . . . . . . . . . . . . . . 27

For HP-UX 11i v1 or 11i v2 - Installing from the HP Software Depot. . . . . . . . . . . . 28

Configuring PPU Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Configuring the Utility Meter (required) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Configuring the Proxy Server (if necessary) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Configuring the Proxy Server’s Username and Password (if required by the proxy

server) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Configuring the System Identifier (if desired) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Viewing the System Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Verifying the https Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Manually Starting the ppud Daemon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Re-installing PPU Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Un-installing PPU Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Contents

4. Using the PPU Software

PPU Web Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

PPU Usage Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Understanding Utilization Capping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

New Partition Creation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

5. Troubleshooting

Troubleshooting the PPU Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

6. Frequently Asked Questions

Pay Per Use Program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Pay Per Use Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

A. Open Source and Licenses

Open Source Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

CURL MITX License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

OpenSSL License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

B. Special Considerations

Export Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Inactive Partitions in PPU Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Verifying PPU Utilization Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

C. Glossary

PPU Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

D. PPU Manpages

ppu (5) Manpage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

ppud (1M) Manpage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

ppuconfig (1M) Manpage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

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).

Chapter 1 9

About this guide

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.04 are

encompassed in references to “versions B.06.x” in this document.

This user’s guide provides you with the most recent information on using the PPU versions B.06.x software.

How to Use this Guide

• Chapter 1, About this Guide provides an introduction to the guide, an overview of the PPU system, and locating PPU documentation.

• Chapter 2, Understanding PPU Requirements describes PPU: program, software, and system move requirements.

• Chapter 3, Installing and Configuring PPU Software contains a Getting Started section to help you verify your PPU system is correctly installed and configured, and corrective actions to take if it is not. This chapter also has instructions on how to install, configure, un-install, or re-install the PPU software.

• Chapter 4, Using the PPU Software explains the PPU web portal, PPU usage reports, utilization capping, and what to do when creating a new partition.

• Chapter 5, Troubleshooting gives you a step by step procedure to resolve problems with the PPU software.

• Chapter 6, Frequently Asked Questions contains questions and answers to common PPU software topics.

Chapter 110

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.

We welcome any feedback that helps us improve the quality of our documentation. To provide feedback, go to the following HP web site:

docs.fc.hp.com/assistance/feedback.html

HP On Demand Solutions Program

PPU In previous versions of PPU (versions B.04.x — HP product T1322AA) a

customer’s usage charges were calculated based on the number of active processors in the system.

PPU versions B.06.x (HP product T2351AA) offers an alternative pricing model in which you are charged for the percent utilization of the active processors.

The billing amounts vary as your processor usage needs increase or decrease. This is different than the traditional financing approaches that are based on fixed payment amounts for a specified period.

The PPU product T2351AA is available for specified HP enterprise servers on HP-UX 11i v1 and 11i v2.

NOTE Customers who are on the Percent CPU Utilization metric should use the

most recent version of the PPU B.06.x software (HP product T2351AA).

iCOD iCOD is a purchase model in which you license components with

codewords. iCOD is available for specified HP enterprise servers on HP-UX 11i v1

and 11i v2.

Chapter 1 11

About this guide

Overview

System Overview

PPU versions B.06.x consists of the following components:

1. PPU system (https client)

2. Utility meter

3. Usage database

Figure 1-1 PPU System Components

Chapter 112

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. The https client does not require a web server or additional web components for its operation.

IMPORTANT If the https connection to the utility meter is broken, the PPU system

may be assumed to have 100% processor utilization.

Utility Meter To track the actual processor usage, the utility meter receives reports

from the https client. The utility meter consists of hardware (generally an IA-32 system) connected to your network and pre-loaded with HP software. The utility meter is installed and configured by your HP service representative. One utility meter is required per 100 PPU systems or partitions.

Usage Database The usage database receives information from the utility meter. The

information is then aggregated and posted to the PPU web portal for your viewing. See “PPU Web Portal” on page 36 for details on the PPU web portal.

NOTE If usage data for any partition in the PPU system is not received for any

given day, an e-mail notification is sent to your PPU system contact’s e-mail address. This e-mail address is configured in the utility meter’s initial set-up.

Chapter 1 13

About this guide

Overview

Most Recent PPU Version and Supported Platforms

Table 1-1 Most Recent PPU Version and Supported Platforms

Software and

Version

PPU B.06.04 (T2351AA)

PPU B.06.03 (T2351AA)

Operating

System

Version

HP-UX 11i v2

HP-UX 11i v1

PPU Supported Hardware Platforms

Currently, the PPU versions B.06.x software is supported on the following HP servers:

Supported

Hardware

Platforms

hp Integrity servers: Superdome, rx8620, and rx7620

hp 9000 servers: Superdome, rp8400, and rp7410

Notes

Available on:

• http://software.hp.com

• March 2004 HP-UX 11i v2 Operating Environments media

• March 2004 HP-UX 11i v2 Applications Software media

Available on:

• http://software.hp.com

• December 2003 HP-UX 11i v1 Operating Environments media

• December 2003 HP-UX 11i v1 Applications Software media

•HP-UX 11i v2

1. hp Integrity Superdome

2. hp Integrity rx8620

3. hp Integrity rx7620

•HP-UX 11i v1

1. hp 9000 Superdome

2. hp 9000 rp8400

3. hp 9000 rp7410

Chapter 114

About this guide

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.com

• Printed — order HP part number “T2351-90031”

• March 2004 HP-UX 11i v2 Instant Information CD (HP-UX 11i v2)

• In the PPU B.06.x software product, located in: /usr/share/doc/PayPerUseUserGuide.pdf Note, this is an early version of this document. For more current information see the document at docs.hp.com.

Manpages

See Appendix D, “PPU Manpages,” on page 69 for details of the following manpages:

• ppu (5): an overview of the PPU software

• ppud (1M): daemon that provides system configuration and CPU usage information to the utility meter

• ppuconfig (1M): set the configuration values of a PPU system

Chapter 1 15

About this guide

PPU Information

Chapter 116

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).

Chapter 2 17

Understanding PPU 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 to the utility meter (this is required on every partition, including virtual partitions)

• Migrate to later PPU software versions as they become available

For the specific details on your individual PPU program requirements, refer to your On Demand Solutions contract from HP or your authorized channel partner. Participants of the On Demand Solutions program who do not meet these requirements may be in breach of contract. This results in unnecessary expense for both the PPU program participant and HP.

Chapter 218

Understanding PPU 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. In the event your system’s operating system is re-installed with Ignite-UX, ensure that the correct version of HP-UX is used and the PPU software is installed. See “Getting Started” on page 24 for details.

IMPORTANT This document lists the patches required to install and run PPU versions

B.06.x known at the time of publication. To find the most current patches, see “How To Find The Latest Patches” on page 26 for detailed instructions.

HP-UX 11i v2 Requirements

For PPU Versions B.06.x on HP-UX 11i v2

Chapter 2 19

The following software is required for PPU versions B.06.x on HP-UX 11i v2:

❏ HP-UX 11i v2 ❏ PPU software bundle T2351AA (version B.06.x) located on the

following HP web site (search for “T2351AA”):

software.hp.com

❏ Kernel driver diag2 ❏ nPar bundle ❏ WBEM B8465BA bundle

Understanding PPU Requirements

PPU Software Requirements

HP-UX 11i v1 Requirements

For PPU Versions B.06.x on HP-UX 11i v1

IMPORTANT For Superdome systems, the Utility subsystem firmware must be 6.40 or

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

greater. PPU is not supported on versions prior to 6.40. The Utility firmware revision is displayed in two places by the Management Processor (MP). To determine your version, check the main menu when you first log into the MP, or type CM at the main menu to display the command menu, then HE for help.

Required Patches for PPU on HP-UX 11i v1

The following patch (or superseded patch) is required for PPU B.06.x on HP-UX 11i v1:

• PHKL_25218: S700_800 11.11 PDC Call retry,

PDC_SCSI_PARMS, iCOD hang fix

NOTE At the time of publication, there are no required patches for PPU B.06.x

on HP-UX 11i v2

Chapter 220

Understanding PPU 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.

Chapter 2 21

Understanding PPU Requirements

PPU System Move Requirements

Chapter 222

3 Installing and Configuring PPU

Software

This chapter covers the following topics:

• “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

Chapter 3 23

Installing and Configuring PPU Software

Getting Started

Factory Integrated Systems

NOTE The PPU B.06.x software must be installed and configured on every

Step 1. Verify the PPU software is installed by executing the following

You do not need to install the PPU B.06.x software if your processors and 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.

partition in your system, including virtual partitions.

There are three steps you can perform to verify your PPU system has the PPU B.06.x software installed and configured for communication with the utility meter:

command:

/usr/sbin/swlist | grep T2351AA

You should see output similar to:

T2351AA B.06.04 HP-UX Pay Per Use (PPU)

If you do not receive the correct result for Step 1 (above) see “Installing PPU Software” on page 26 for PPU software installation details.

Step 2. Verify the PPU software is configured to use the utility meter and the

https connection is functional by executing the following command:

/usr/sbin/ppuconfig -t

You should see output similar to:

Round trip communication with the utility meter succeeded.

If you do not receive the correct result for Step 2 (above) see “Configuring PPU Software” on page 29 for PPU software configuration details.

Chapter 324

+ 54 hidden pages