Configuring PPU Software
» Table of Contents |  | | » Index | | |
| | |
| ||
| ||
After you have successfully installed the PPU 8.x software, you need to configure the PPU software connection to the utility meter. The utility meter must be configured on every partition in the complex (including virtual partitions on HP-UX systems).
| |
| |
| |
 | NOTE: The following configuration procedure assumes your utility meter has been installed on the PPU system’s network by your HP service representative. If the utility meter is not installed, contact your HP service representative. |
| |
| |
| |
You may need to perform up to three steps to configure a partition. At a minimum, you must set the name of the utility meter. If you want to specify a name other than your partition’s hostname as the system identifier, you must perform additional steps. If you want to set a cap, or maximum, for the number of active cores (HP-UX and OpenVMS systems only), you must also perform additional steps.
To summarize, in order to configure the PPU software you must do the following:
Configure the utility meter (required)
Configure the system identifier of the partition (optional)
Configure the cap limiting the number of active cores on the partition (optional; HP-UX and OpenVMS only)
To configure the utility meter, execute the following command on each partition:
/usr/sbin/ppuconfig -m meter
Where meter is the fully-qualified hostname or IP address of the utility meter. This command/option performs a communication test to the utility meter and starts the ppud daemon.
To configure the utility meter, open a command window on each Windows partition on the server and execute the following command:
C:\Program Files (x86)\Hewlett-Packard\ppu>
ppuconfig -m meter
Where meter is the fully-qualified hostname or IP address of the utility meter. This command/option performs a communication test to the utility meter and starts the PPU Service. The command assumes that PPU was installed in the default location.
| |
| |
| |
 | IMPORTANT: The PPU 8.x software is inoperable if the Utility Meter software is not version 7.3 (or higher). |
| |
| |
| |
To configure the utility meter, execute the following DCL command on each partition:
$ ppu config/meter_address=meter
Where meter is the fully-qualified hostname or IP address of
the utility meter. After the utility meter is defined, you must
start the PPU_SERVER process. Use the DCL command below to start the server:
$ ! note the location of PPU$ROOT is not required to be
$ ! SYS$SPECIFIC but it must be consistent with the
$ ! definition in SYSTARTUP_VMS.COM
$ !
$ DEFINE/SYS/EXEC/TRANS=CONCEAL PPU$ROOT ’F$TRNLNM("SYS$SPECIFIC")
$ @SYS$STARTUP:PPU$STARTUP
%RUN-S-PROC_ID, identification of created process is 00000438
8 cores are now active
The system identifier of a partition enables you to track your PPU system. The default system-identifier is the hostname of your partition. If you want to protect the identity of the hostname for your partition, you can change the system identifier to any value you choose. Examples of a system identifier are: an asset number, an HP support tag, or a description of a physical location.
To set the system identifier of the partition, execute the following command:
/usr/sbin/ppuconfig -s system_id
Where system_id is an identifier for your partition.
| |
| |
| |
| NOTE: You can set the utility meter and system identifier with the single command: /usr/sbin/ppuconfig -m meter -s system_id |
| |
| |
| |
The system identifier of a partition enables you to track your PPU system. The default system-identifier is the hostname of your partition. If you want to protect the identity of the hostname for your partition, you can change the system identifier to any value you choose. Examples of a system identifier are: an asset number, an HP support tag, or a description of a physical location.
To set the system identifier of the partition, execute the following command:
C:\Program Files (x86)\Hewlett-Packard\ppu>
ppuconfig -s system_id
Where system_id is an identifier for your partition.
| |
| |
| |
| NOTE: You can also set the utility meter and system identifier
with a single command: C:\Program Files (x86)\Hewlett-Packard\ppu> ppuconfig -m meter -s system_id |
| |
| |
| |
The system identifier of a partition enables you to track your PPU system. The default system identifier is the hostname of your partition. If you want to protect the identity of the hostname for your partition, you can change the system identifier to any value you choose. Examples of a system identifier are: an asset number, an HP support tag, or a description of a physical location.
To set the system identifier of the partition, execute the following DCL command:
$ ppu config/system_id=system_id
Where system_id is an identifier for your partition.
| |
| |
| |
| NOTE: You can set the utility meter and the system identifier
with the single command: $ ppu config/system_id=system_id/meter_address=meter |
| |
| |
| |
You can specify the number of active cores on each partition in your PPU system. To cap the number of active cores for a given partition, execute the following command:
HP-UX: /usr/sbin/ppuconfig -rc number
OpenVMS: $ PPU CONFIG/CAP=number[/RECONCILE]
Where number is the maximum number of active cores you want in the partition.
The -r option on the HP-UX command and the /RECONCILE qualifier on the OpenVMS command causes the cap to take effect immediately (limiting the number of active cores without waiting for a reboot).
| |
| |
| |
| NOTE: You cannot limit the number of active cores with the -c option in a virtual partition environment (vpar). |
| |
| |
| |
See “ppuconfig (1M) Manpage” for details on specifying a cap limiting the number of active cores.
You can use the ppuconfig command (with no options) to view the settings for the utility meter and system identifier, and if a cap limiting the number of active cores is set.
Example 3-1 Viewing system settings using the ppuconfig command
Use the following commands to verify general system settings:
HP-UX:
/usr/sbin/ppuconfig
OpenVMS:
$ PPU CONFIG
Windows Server 2003:
C:\Program Files (x86)\Hewlett-Packard\ppu> ppuconfig
You should see output similar to:
Utility Meter IP/Hostname: meter1.corp.com
System Identifier: superdome1
Cores to be active at next reboot (cap): all
Cores that can be activated without reboot: 0
Active Cores: 4
See the “ppuconfig” descriptions in the appropriate system-specific Appendix (B or C) for details of the ppuconfig command.
After specifying the utility meter (required), system identifier (optional), and active core limit cap (optional), execute the following command to verify the PPU software is communicating with the utility meter:
HP-UX:
/usr/sbin/ppuconfig -t
OpenVMS:
$ PPU CONFIG/TEST
Windows Server 2003:
C:\Program Files (x86)\Hewlett-Packard\ppu> ppuconfig -t
You should see output similar to:
Round trip communication with the utility meter succeeded.
If you do not receive a similar message, correct the utility meter configuration according to the error message received.
If you receive the correct message, your partition is properly configured to communicate with the utility meter, and no further configuration of the PPU software is necessary.
To verify the utility-meter connection to HP, go to the PPU portal (see “PPU
Web Portal” for details) and confirm that a PPU test usage-report has been posted to the portal. The usage report is available from the meter connectivity verification link. You need to enter the System Serial Number and system unique ID.
The existence of the report verifies that communication is established from the PPU software, to the utility meter, and ultimately to HP.
| |
| |
| |
| NOTE: The PPU Agent is the software component that provides information to the utility meter. On HP-UX systems, this component is the ppud daemon. On Windows systems, this component is the PPU Service. On OpenVMS this is the PPU_SERVER process. The PPU Agent must be running on each partition in the complex (including virtual partitions on HP-UX systems). If the PPU Agent is not running on a partition, utilization information for that partition is not sent to HP, which may assume 100 percent utilization of the partition core(s). |
| |
| |
| |
The ppud daemon is started when you specify a utility meter using the ppuconfig -m meter command. It also is started by init at reboot and is respawned if its process is stopped.
| |
| |
| |
| NOTE: If the ppud daemon is killed, it is automatically respawned by init. See “ppud (1M) Manpage” for details of the ppud daemon. |
| |
| |
| |
To verify the ppud daemon is running, execute the following command:
/usr/bin/ps -e | grep ppud
You should see the ppud daemon listed as an active process on the partition. If it is running, and the utility meter is properly configured, utilization information is sent to HP and your partition is correctly configured.
If the ppud daemon is not listed as an active process, inspect the /etc/inittab file for an entry similar to the following (look toward the bottom of the file):
ppud:23456:respawn:/usr/lbin/ppud # Pay per use daemon
If the entry does not exist in the /etc/inittab, start the ppud daemon by specifying the utility meter with the following command:
/usr/sbin/ppuconfig -m meter
Where meter is the fully-qualified hostname or IP address of the utility meter. This command/option performs a communication test to the utility meter and starts the ppud daemon.
The ppud daemon performs periodic operations based on the time of day. The daemon is spawned by init and obtains its time zone specification from the /etc/default/tz file. By default the time zone is set to EST5EDT. You can specify which time zone the ppud daemon uses to interpret its current time by modifying the entry in the /etc/default/tz file. Refer to the environ(5M) manpage for details of the TZ format.
The PPU Service starts when the PPU software is installed (using the process described in “Installing PPU Software”), or when you specify a utility meter using the ppuconfig -m meter command. Thereafter it starts automatically each time the partition boots.
To verify the PPU Service is running:
Click Start > Programs > Administrative Tools > Services.
Verify that the HP Pay Per Use service appears in the list of services, and its status is listed as “Started” (meaning it is active).
If the PPU Service is running, and the utility meter is properly configured, utilization information is sent to HP and your partition is correctly configured.
To verify the PPU server is running, you may use the PPU CONFIG command.
$ PPU CONFIG
Utility Meter IP/Hostname: meter1.corp.com
System Identifier: superdome1
Cores to be active at next reboot (cap): 5
Cores that can be activated without reboot: 3
Active Cores: 5
ERROR" The Pay per use server (PPU_SERVER) is not running.
Alternatively, you can use the DCL PIPE command to verify the PPU_SERVER process is running. The SEARCH-I-NOMATCHES message listed below indicates the server is not running:
$ pipe show sys | search sys$pipe PPU_SERVER
%SEARCH-I-NOMATCHES, no strings matched
$ pipe show sys | search sys$pipe PPU_SERVER
00000438 PPU_SERVER HIB 10 2470 0 00:00:00:33 967 1408