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)