HP Pay per use Utility Meter II Software Installation and Configuration Guide HP Part Number: 5900-1252 Published: December 2010, Edition 2
© Copyright 2010 Hewlett-Packard Development Company, L.P. Legal Notices Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial 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 information contained herein is subject to change without notice.
Table of Contents About This Document.....................................................................................7 1 2 3 4 5 Intended Audience...............................................................................................................................7 Publishing History................................................................................................................................7 Document Organization..............................................................
Glossary....................................................................................................33 Index.........................................................................................................
List of Figures 1-1 3-1 3-2 3-3 3-4 Flow of Metered Usage Data............................................................................................................10 UPS Portal Welcome Page................................................................................................................25 End-to-End Connectivity Verification Input Page...................................................................................26 End-to-End Connectivity Verification Page..........................
About This Document 1 Intended Audience This document provides instructions for installing, configuring, and verifying the operation of version 9.2 of the HP Pay per use Utility Meter II software (HP product T2258AA) on supported HP servers.
1 Introduction 1.1 Overview Pay per use (PPU) is part of HP's Utility Pricing Solutions (UPS) program. In this program, customers are charged according to usage of the PPU resources (servers) under a UPS contract. For more information on this program, see the HP Utility Pricing Web page: http://www.hp.com/go/utility. The usage data for PPU is collected by the Utility Meter software, which runs on the Utility Meter server. Version 9.
Figure 1-1 Flow of Metered Usage Data The communication from the Utility Meter to the PPU Partition runs over https (TCP port 5989). The communication from the Utility Meter to the Onboard Administrator (OA) runs over https (TCP port 443). These ports must be open from the Utility Meter to any PPU partition or OA that needs to be metered. No non-transparent proxy server can be configured between the PPU partition(s) or the OA and the Utility Meter. 1.2 Recommended Hardware The Utility Meter 9.
1.3.1 Utility Meter Software Back Up The Utility Meter configuration files should be backed up on a regular basis because they include a list of devices being monitored. The folder that contains the configuration files, /opt/hp/RemoteSupport/umeter/conf, should be backed up using a method of your choice. 1.3.
1.5 Utility Pricing Solutions Web Portal HP maintains a Web portal that displays the usage data for Utility Pricing Solutions (UPS) resources under a PPU contract. The UPS Web portal is located at: http://www.hp.com/go/payperuse. The Web portal uses the standard HP Passport single sign-in process. If you do not have a Passport ID, please click the Register link. If you have an existing Passport ID, please click the Sign-in link. Registration to the portal is free.
If, for whatever reason, HP does not receive PPU usage data for two consecutive days, the Utility Meter system contact is notified through email and HP applies the missing data rule to derive usage for the PPU resources. At the same time, a support case is logged within HP for the problem. An HP support representative will contact the customer regarding the issue. You can use the Utility Pricing Solutions Portal (http://www.hp.
2 Installing and Configuring the Utility Meter Software This chapter provides information about installing and configuring the Utility Meter software. 2.1 Obtaining the Utility Meter Software Download the latest version of the HP Pay per use Utility Meter II software from the HP Software Depot web site http://software.hp.com. Search for product number T2258AA. The Software Depot download is an ISO image that includes a hardened version of Red Hat Enterprise Linux Server and the Utility Meter software.
7. 8. Once the installation is completed, the system will reboot automatically. When the system begins rebooting, make sure to return to the Virtual Media dialog and disconnect the ISO image from the virtual media, otherwise the installation will repeat after the system reboots. Once the install is complete and the system has rebooted, login as user umeter (default password: h.lnxmtr).
2.3 Configuring the Utility Meter Parameters The Utility Meter software can be configured using the GUI or by using the umadmin configure command. The following values must be configured before any data can be sent to HP: • SMTP or HTTPS transport • Customer contact email address • Date and time • Hostname • Network parameters 2.3.1 Configuring the Utility Meter Parameters from the Command Line Use the following procedure to configure the Utility Meter using the command line: 1. 2.
Enter y to confirm your settings. The Utility Meter daemon will be restarted to update to the new settings. • SMTP Protocol: Enter 1 to use SMTP protocol and enter the following parameters: • Mail Relay Host • Domain Masquerade Enter y to confirm your settings. The Utility Meter daemon will be restarted to update to the new settings. 6. Enter 5 to configure the customer contact email address. Enter the customer contact email address.
4. Set the customer contact email address: a. b. 5. Set the current UTC date and time: a. b. 6. If the date and/or time is different from what is displayed in the fields, enter the current date and/or time. You can click Refresh to update the date and time if the Setup tab has been opened for awhile. Click Submit. Set the hostname: a. b. 7. Enter the customer contact email address. If more than one email address is needed, separate them with semicolons.
3 Configuring Devices For a Superdome 2 server, both the Onboard Administrator (OA) and the partitions need to be added. See Section 3.1 for how to add the OA, and see Section 3.2 for how to add the partitions. 3.1 Adding PPU OA Devices 3.1.1 Adding PPU OA Devices from the Command Line Use the following procedure to add a PPU OA device using the command line: 1. 2. Login to the Utility Meter as user umeter (default password: h.lnxmtr).
5. 6. • Device Name • Device Type – Select PPUOA for a PPU Onboard Administrator. • Address (IP or FQDN) • Username • Password Click Submit. Verify the device was added by checking the List Devices table. You should see the device that you added in Step 4 listed. 3.2 Adding PPU Partitions 3.2.1 Adding PPU Partitions from the Command Line Use the following procedure to add a PPU partition using the command line: 1. 2. 3.
# umadmin list List of devices Device Name = deviceName Type = PPUOA Address = deviceAddress Device ID = deviceID Collection Status = New Device, not yet collected Submission Status = New Device, not yet collected Service Name = Utility_Meter_Configuration_Collection Device Name = deviceName Type = PPUPARTITION Address = deviceAddress Device ID = deviceID Collection Status = New Device, not yet collected Submission Status = New Device, not yet collected Service Name = Utility_Meter_Configuration_Collection
3.3 Verifying Connectivity There are two steps to verifying connectivity of the Utility Meter: • Running the end-to-end connectivity test (see Section 3.3.1: “Running the End-to-End Test”) • Checking the web portal for data arrival (see Section 3.3.2: “Checking the Web Portal for Data Arrival”) 3.3.1 Running the End-to-End Test This will test the connectivity of the Utility Meter to each device, and then test the connectivity of the Utility Meter to HP. Verify that each test is successful.
the test report is generated and when it can be viewed on the UPS portal. For email data transport, the delay can be longer due to the number of "hops" in the email routing before the data arrives at HP. You can test the connection from a PPU partition to the Utility Pricing Solutions (UPS) Web portal by performing the following procedure: 1. 2. Sign-in to the UPS portal at: http://www.hp.com/go/payperuse.
NOTE: The ID Number can be found in the tag in a PPU usage report. Figure 3-2 End-to-End Connectivity Verification Input Page 4. If you see the following page, then the PPU partition is properly connected to the UPS portal through the Utility Meter. Figure 3-3 End-to-End Connectivity Verification Page The date and time in the Time stamp field should be similar to the date and time you performed the meter connectivity verification test.
Figure 3-4 End-to-End Connectivity Verification Failure Page If you are having trouble with the connectivity verification, follow the information in Chapter 4: “Troubleshooting the Utility Meter”. 3.4 Deleting PPU Devices 3.4.1 Deleting PPU Devices from the Command Line Use the following procedure to delete a PPU device using the command line: 1. 2. 3. On the Utility Meter, open a browser and enter the Utility Meter's fully qualified domain name into the address bar.
5. 6. 28 Click Confirm in the Confirmation Required window. Verify the PPU partition was deleted by checking the List Devices table. You should no longer see the PPU device that you deleted in Step 4 listed.
4 Troubleshooting the Utility Meter This chapter explains how to troubleshoot the Utility Meter hardware and software if you are not seeing correct usage data on the Utility Pricing Solutions (UPS) Web portal at http://www.hp.com/go/payperuse. This chapter contains the following sections: • Section 4.1: “Troubleshooting Overview” • Section 4.2: “General Troubleshooting Information” • Section 4.3: “Utility Meter Software” • Section 4.4: “Troubleshooting a Device” 4.
• Communication fails between the OA and the Utility Meter. The traffic between the OA and the Utility Meter runs over port 443 (HTTPS). This port needs to be open on a firewall that is between the OA and the Utility Meter. • Communication fails between the Utility Meter and HP. The usage-data transport method (HTTPS or email) to HP may have failed. Ask the network specialist if the networks, proxy servers, and/or firewalls were inadvertently altered causing usage data to stop.
NOTE: Be sure to disable debug mode as soon as you are finished so that the debug information is no longer saved to the log files. 4.3 Utility Meter Software Here are suggestions for evaluating the Utility Meter software on the Utility Meter hardware. • Ensure you have the correct Utility Meter software by executing the following rpm command. # rpm -aq | grep meter umeter-9.2-69 • To verify the hostname for the Utility Meter, run the uname command: # uname -a Linux mysystem 2.6.18-128.
memory usage data collected 77580 kB [1.8%] Mon Jul 12 23:56:15 2010 To reinstall the Utility Meter software, see Chapter 2: “Installing and Configuring the Utility Meter Software”. 4.4 Troubleshooting a Device The most prominent reason why HP does not receive usage data from a Utility Meter is because the file-transfer connection between the Utility Meter and HP is broken.
Glossary CIM Refers to the Common Information Model. CLI Refers to Command Line Interface. OA Refers to the Onboard Administrator. Partition/Server A VSE partition (nPar or vPar) in a cell based server. PPU Refers to the HP Pay per use solution, which is a part of the HP Utility Pricing Solutions program. SMI-S Refers to the Storage Management Initiative Specification. UPS Refers to the HP Utility Pricing Solutions program.
Index Utility Pricing Solutions Web portal, 12 C configuring devices, 21 configuring the Utility Meter parameters, 17 D data transport methods, 12 directory structure, 11 I installing Utility Meter software from HP Software Depot, 15 M missing data rules, 12 missing usage reports, 12 O obtaining the Utility Meter software, 15 ordering the Utility Meter, 13 R recommended hardware, 10 S software back up, 11 supported PPU servers, 10 T troubleshooting troubleshooting troubleshooting troubleshooting a
