Configuring PeopleSoft Health Center

Before you can begin using the PeopleSoft Health Center, you need to configure the following elements or verify that these elements are set correctly:

  • Configure Integration Broker.

  • Set the Performance Collator property.

  • Enable the PPM agents.

  • Enable and configure the JMX agents.

  • (Optional) Set the Mobile Application Platform session time-out.

PeopleSoft Health Center's user interface runs on the Mobile Application Platform (MAP), which depends on Integration Broker. Hence, Integration Broker must be configured correctly before you can use the Health Center.

See Integration Broker Administration for instructions on setting up the Integration Broker.

To set the Performance Collator property:

  1. Run PSADMIN and choose the domain that you want to configure.

  2. Select 4) Configure this domain.

    To configure the domain, the domain needs to be shut down.

  3. Enter y to the question: Do you want to continue (y/n).

  4. Toggle 10) Perf Collator to set it to Yes.

  5. Select 14) Load config as shown.

  6. Restart the domain.

To enable the PPM agents:

  1. Run PSADMIN and choose the domain that you want to configure.

  2. Select 6) Edit configuration/log files menu.

  3. Select 1) Edit domain configuration file.

  4. In the configuration file, in the PSTOOLS section, locate the EnablePPM Agent parameter and set the value to 1.

    If you set the value to 0, the PPM agents are disabled.

  5. Save the changes you made in the configuration file.

  6. Restart the domain.

The PPM agents must be able to register with the system before the PeopleSoft Health Center detects anything to monitor.

For more information on PPM agents, see Enabling the Required Elements on the Monitored System.

To enable JMX agents:

  1. Run PSADMIN and choose the domain that you want to configure.

  2. Select 6) Edit configuration/log files menu.

  3. Select 1) Edit domain configuration file.

  4. In the configuration file, in the PSTOOLS section, locate the following parameters and set the values:

    • Enable Remote Administration - Set the value to 1.

    • Remote Administration Port - Set the value to 10100.

      Note: In order to prevent the Java RMI stack from using random ports for the PHC RMI Server, PHC sets a specific port for it, which is the Remote Administration Port value incremented by 1. For example, if the Remote Administration Port is 10100, then port 10101 will be used for PHC's RMI server. When you plan the port usage, this needs to be taken into account.

      Also, in an environment where a firewall is enforced, for a monitored Application server or Process Scheduler domain, the ports assigned for the Remote Administration Port and for the PHC RMI server have to be opened for communication, so that the remote monitoring system's JMX connection can be established. For example, if the monitored domain has the value 10100 set for the Remote Administration Port and the value 10101 is assigned to the PHC RMI server, then the firewall needs to allow ports 10100 and 10101 for communication.

    • Remote Administration Userid - Enter a user ID, for example, admin.

    • Remote Administration Password - Enter an encrypted password. To encrypt the password, use the PSCipher utility.

      For more information on encrypting passwords, see Encrypting Passwords Using the PSCipher Java Utility.

  5. Save the changes you made in the configuration file.

  6. Restart the domain.

The Mobile Application Platform (MAP) time-out is set for 5 minutes by default. If you want to watch a Health Center dashboard for extended periods of time without getting logged off from PIA, it is advisable to set the time-out for a longer period of time, for example, 60 minutes.

To modify the session time-out on the MAP Security page:

  1. Navigate to PeopleTools > Mobile Application Platform > MAP Administration > MAP Security.

  2. In the Session Timeout field, replace the default 5 minutes with an appropriate number, such as 60 minutes.

  3. Click Save.