ppu(5) File Formats Manual 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. Depending on the type of contract a PPU system is under, utilization can be either
of the actual percentage utilization of each core, or a count of the number of active cores in the system. 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 systems must be configured to use a utility meter. Utility meter configuration is accomplished using the command (see ppuconfig(1M)).
The data that is sent to HP is aggregated and sent to billing; it is also posted on the Utility Pricing Solutions portal for viewing at
http://www.hp.com/go/payperuse.
PPU can be run in an HP Integrity Virtual Machines environment (HPVM). In this case, the usage information for billing purposes is still
the overall usage for the VM Host. However, you can examine the usage report at the portal to see a detailed breakdown of the usage for
each virtual machine (also called a "guest").
In an HPVM environment, PPU needs to be installed and configured only on the VM Host, not on the guests. The command will report an error
if invoked on a VM guest.
For more information see the Pay per use User's Guide located at /usr/share/doc/PayPerUseUserGuide.pdf.
SEE ALSO ppud(1M), ppuconfig(1M)ppu(5)
Check Out this Related Man Page
ppuconfig(1M)ppuconfig(1M)NAME
ppuconfig - configure Pay per use daemon
SYNOPSIS DESCRIPTION
is a tool for configuring communication between the Pay per use daemon (see ppud(1M)) and a utility meter. A utility meter must be speci-
fied for a Pay per use system before the daemon will collect and send utilization data to HP. In the absence of this data, HP may assume
100% utilization and bill for the system accordingly.
If is invoked without any options, the current settings will be displayed.
After initially configuring the utility meter with the command, use the ppuconfig -t command to perform a round trip communication test
with the meter and to perform other validation checks. If the daemon is not running, this command will start the daemon.
When is used to modify the configuration information related to the utility meter, it is not necessary to restart the daemon. When config-
uration information is modified also use to verify the new configuration.
can be used to place a cap on the number of active cores, thereby limiting the maximum utilization reported to HP. This option is not
allowed in a virtual partition environment.
For more information see the Pay per use User's Guide located at /usr/share/doc/PayPerUseUserGuide.pdf
Options
recognizes the following command-line options and arguments:
Specifies the number of cores that should be active on this partition the
next time it boots. Upon the next partition reboot, cores may be deactivated until this value is reached. Specification of the
value "all" means that all cores that can be active, should be active. "all" is the default cap.
To specify a cap and make it take effect immediately, specify the option in conjunction with the option.
Note: the option does not apply to virtual partitions. To limit the number of active cores in a virtual partition, use the vpar-
modify(1M) command to assign or unassign cores.
Specifies that the hostname should be used as the system identifier for
the Pay per use system when reporting usage information.
Specifies the utility meter that the Pay per use system should use for
reporting usage data. The meter can be specified as a fully qualified hostname or IP address. A non-blank value is required.
Reconcile.
Instructs to activate or deactivate cores to get to the specified cap value. will only deactivate cores from the default proces-
sor set (pset 0) and will never deactivate the last core in a cell or the last core in the partition.
Note: this option does not apply to virtual partitions.
Specifies the system identifier that the Pay per use system should use
when reporting. This can be any value that helps you identify this system (for example, a tracking number, asset number, physi-
cal location, etc). Until a system identifier is specified, the hostname will be used by default. This identifier is transmit-
ted to HP and shows up on the Utility Pricing Solutions portal (http://www.hp.com/go/payperuse) to help you identify your system.
Perform a communication test between Pay per use software and the
configured utility meter. Perform other validation checks to make sure PPU information can be acquired. Start the ppud daemon
if it is not running.
RETURN VALUES
exits with one of these values:
Success
Failure;
error message sent to
EXAMPLES
The following example shows configuration of the utility meter to a system called alpha.corp.com followed by a communication test of that
meter.
ppuconfig -m alpha.corp.com
ppuconfig -t
The following example shows how to cap the number of active cores to three and make it take effect immediately.
ppuconfig -rc 3
The following example shows how to remove a cap from the system and always have all cores active.
ppuconfig -c all
The following example shows how to set the system ID for this system. The system ID can be any text that helps you better identify your
system.
ppuconfig -s "rp8410 in bldg 7 1st floor system room: ID#234879"
AUTHORS
ppuconfig was developed by HP.
FILES
/etc/ppu/ppu_config
File containing utility meter configuration data. If this file is removed, the daemon will not be started at system boot and
utilization data will not be transmitted to HP.
/var/ppu/PPUReport.xml
File created every 30 minutes containing a report of the core utilization over the last 30 minutes for this partition.
SEE ALSO ppud(1M), ppu(5)ppuconfig(1M)