Enabling the Required Elements on the Monitored System

This section covers enabling the required elements on the monitored system, which is the system for which you intend to collect performance data. A monitored system requires the following items to be in place:

  • PeopleSoft application database.

  • Web server agent.

  • Application server domain manager and agents.

  • Process Scheduler server domain manager and agents.

  • Valid monitor servlet URL value.

This step applies to:

Product

Step Required?

Performance Monitor

Yes

Usage Monitor

Yes

As long as your PeopleSoft application is running against your PeopleSoft database, no further database configuration is required for the Performance Monitor.

Note: The database must be running on PeopleTools 8.44 or higher.

Note: The database must be running on PeopleTools 8.51 or higher for Usage Monitor.

This step applies to:

Product

Step Required?

Performance Monitor

Yes

Usage Monitor

Yes

Specifying a monitor URL enables the Performance Monitor agents and identifies the monitor servlet.

The agents on the monitored system check the monitor URL value periodically. When the monitor URL value is set to NONE, the Performance Monitor components on the monitored system are disabled.

The monitor URL value must reflect the URL of the monitor servlet that is running on the monitoring system.

To specify the monitor URL:

  1. Select PeopleTools, Performance Monitor, Administration, Specify Monitor.

  2. On the Specify Monitor page, enter the appropriate value in the Monitor URL edit box.

    The format of the URL is http[s]://host[:port]/monitor/[site]/orNONE.

    For example, enter http://server2.example.com/monitor/ps/.

    Where ps is the name of the PeopleSoft site.

  3. Click Ping Test to ensure that you entered a valid URL and that the URL is available.

  4. Click Save and Ping PPM to save the URL into the URL catalog, and to ensure that the associated agents are registered and able to share data with PPMI URL.

    If the URL you enter is different than the previous value, the system saves the new value to the URL catalog, performs registration, and displays status of the registered agents.

    In the case of a new registration, you must wait at least the duration of the Agent Heartbeat Interval.

    If the agents have successfully registered, the PPMConsole (a new browser window) displays a list of all registered agents along with the agent configuration information. If no agents have registered, no list appears.

    Note: In order for the new browser window (PPMConsole) to appear, the PPMConsole needs to be enabled on the Global Administration page.

    See Viewing Monitor Servlet Diagnostics.

    See Setting Global System Options.

This step applies to:

Product

Step Required?

Performance Monitor

Yes

Usage Monitor

Yes

No additional installation procedure is required.

When the monitor URL value is supplied, agents on every PeopleSoft site automatically become active and begin relaying performance data to the monitoring system.

Note: Ensure that the Enable PPM Agents option is selected on the General tab of the appropriate web profile. By default, this option is enabled.

Note: If you start the web server in safe mode, then the monitoring agents in the web server are disabled.

This step applies to:

Product

Step Required?

Performance Monitor

Yes

Usage Monitor

Yes

The following components run and are monitored on the application server of the monitored system:

  • Domain monitor: PSMONITORSRV.

  • PSAPPSRV agents.

  • PSQCKSRV agents.

  • PSQRYSRV agents.

  • PSSAMSRV agents.

  • PSANALYTICSRV.

No installation or configuration procedures are required.

When the monitored system is enabled, agents in every instrumented server process automatically become active and begin relaying performance data to the monitoring system.

Note: Ensure that the EnablePPM Agent parameter in the [PSTOOLS] section of PSADMIN is set to 1 (enabled). If the EnablePPM Agent parameter is commented out or set to 0, then the agents are disabled for this server domain.

Additional Usage Monitor Application Server Settings

Make sure that the Usage Monitoring State parameter is set correctly for the application server domain.

See Usage Monitoring State.

This step applies to:

Product

Step Required?

Performance Monitor

No

Usage Monitor

Yes

Select the Enable Usage Monitoring check box on the System Defaults page (PeopleTools, Performance Monitor, Administration, System Defaults).

To Verify the Usage Monitor Configuration:

  1. On the System Defaults page, set the Buffer Size to 50.

    Note: Until the Buffer Size value is reached, no Usage Monitor data will be written to the database.

    Important! This buffer value of 50 is only for verifying the Usage Monitor configuration, ensuring that data will be quickly written to the Usage Monitor tables. When you are using the Usage Monitor, you need to increase the Buffer Size value to a more appropriate "production" value. The default is 2500. Refer to the System Defaults page documentation for further details on the Buffer Size field.

    Note: For Usage Monitor data collection, the Agent Filter Level does not need to be set to a particular value. Usage Monitor data will be collected with the level set to 01-Stanbdby, as long as the Enable Usage Monitor check box is selected. Setting the Agent Filter Level value to 01-Standby is the recommended setting for a Usage Monitor-only monitoring system.

  2. Shutdown and restart the application server domain and the PeopleSoft Internet Architecture.

  3. Login to that application with your browser and navigate through a few pages and menus in the application.

  4. With your SQL query tool, submit the following query on the monitoring database:

    SELECT * FROM PSPMTRANS35_VW
    
  5. Verify that data is present in the view and that the timestamps correspond to the time you verified the Usage Monitor configuration.

  6. Repeat the previous steps when setting the Buffer Size value to your production value.

This step applies to:

Product

Step Required?

Performance Monitor

Yes

Usage Monitor

No

The following components run and are monitored on the Process Scheduler server of the monitored system:

  • Domain monitor (PSMONITORSRV).

  • PSMSTPRC agents.

No installation or configuration procedures are required.

When the monitored system is enabled, agents in instrumented server processes automatically become active and begin relaying performance data to the monitoring system.

Note: Ensure that the EnablePPM Agent parameter in the [PSTOOLS] section of PSADMIN is set to 1 (enabled). By default, it is set to 1 (enabled) in the delivered domain templates. If the EnablePPM Agent parameter is commented out or set to 0, then the agents are disabled for this server domain.