Enabling Monitoring of a Component or Domain

In PeopleTools 8.55, both the PPM (PeopleSoft Performance Monitor) agent and the JMX (Java Management Extensions) agents are enabled by default. While the PPM agent is required for component registration, the JMX agent is required for real-time monitoring in PeopleSoft Health Center. On initial access of PeopleSoft Health Center, Health Center completes the following tasks:

  • Registers a component or domain with the PPM agent.

  • Authenticates the registered component or domain using JMX agents.

A component or domain must be registered with the PPM agent for the component to appear on Health Center.

If you disable the PPM agent before a component is registered with PPM, then the component will not appear in Health Center. If the PPM agent is disabled after the component is registered, the component will still be accessible in Health Center, but it will no longer generate PPM PMU or Event data.

To enable or disable the PPM agent, you modify the value of the Enable PPM Agent parameter in the PSTOOLS section of PSADMIN. If you set the value to 1, the PPM agent is enabled; if you set the value to 0, the PPM agent is disabled.

See Disabling Performance Monitor Agents.

PeopleSoft Health Center prompts you to add the components or domains registered with the PPM agent to the monitoring application. The monitoring application authenticates these components or domains by prompting a sign on for each participating component or domain. This is a one-time authentication that is implemented through JMX agents. You can choose which components or domains you want to monitor by answering Yes to the Enable Monitoring option.

Note: Depending upon the PeopleTools 8.55 version that you are using, you may not see the authentication prompts because in later releases of PeopleTools 8.55 the participating components or domains are automatically authenticated.

Consider the following when you need to enter user name and password for a participating component or domain:

  • For the web server component (PIA domain), the JMX agent uses the same user name and password that you enter in the web server administration console.

  • For the Tuxedo components (application server and Process Scheduler domains), the JMX agent uses the user name and password that is entered in the Tuxedo domain configuration file.

After registering a component or domain, if you disable JMX agents, registered components will display an error message on the Application dashboard. The error message indicates that the component is unreachable for monitoring.

To enable or disable the JMX agents for the application server and Process Scheduler domains, you modify the value of the Enable Remote Administration parameter in the PSTOOLS section of PSADMIN. Set the value to 1 to enable the JMX agents; set the value to 0 to disable the JMX agents.

When you set Enable Remote Administration to 1, a lightweight rmiregistry daemon process starts on the machine. Multiple domains on the same machine can share the same rmiregistry process by using the same Remote Administration Port parameter value, but these multiple domains must have unique domain names. When the rmiregistry process is started, it is never destroyed until the machine is restarted.