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)