Setting Up the Performance Monitor

This chapter provides an overview of the configuration of the Performance Monitor and discusses how to:

Enable the required elements on the monitoring system.
Enable the required elements on the monitored system.

Configuration of the Performance Monitor

The configuration of the Performance Monitor involves enabling the required elements on the monitored system and the monitoring system.

When you have installed the PeopleTools CD and transferred the appropriate files to your web server, application server, and Process Scheduler server, all of the required elements are in place. You do not need to install additional modules for the Performance Monitor.

Note. If you are setting up a self-monitoring system, the monitored system and the monitoring system reside on the same host machine.

Enabling the Required Elements on the Monitoring System

This section covers the configuration of your monitoring system, which includes:

Setting up the Performance Monitor database.
Setting up the application server.
Setting up the web server for the monitoring system.
Creating a PPMI user ID.
Specifying the PPMI URL and PPMI user ID.
Specifying the Integration Gateway URL.

Setting Up the Performance Monitor Database

The monitoring database requires the use of at least the PeopleTools System (PTSYS) database for the production monitoring system. Set this database up using the instructions in the PeopleTools 8.49 Installation Guide.

Note. For the self-monitoring configuration, use the application database for your system. The application must be running on at least PeopleTools 8.44.

See Also

Enterprise PeopleTools 8.49 Installation for your platform.

Setting Up the Application Server

The application server on the monitoring system requires that the following server processes be enabled:

Typical application server processes included in a default configuration.
PSPPMSRV.

Default Server Processes

A typical default application server configuration is suitable for Performance Monitor activity.

The PSAPPSRV server process is the main server process of the PeopleSoft Application Server.

At least two PSAPPSRV server processes must be enabled. This ensures that the monitoring system can publish notifications of configuration changes through the PeopleSoft Integration Broker gateway. You can enable more PSAPPSRVs to meet increased demand.

PSPPMSRV

The PSPPMSRV process receives the performance data from the monitor servlet and inserts it into the monitoring database.

The following table describes the ways that you can enable this server process using the PeopleSoft Server Administration interface (PSADMIN).

Method	Description
Quick Configure menu	You can use the Quick Configure menu in PSADMIN to enable the PSPPMSRV server process. Enable the Perf Collator option.
Custom Configuration menu	After you have scrolled through all of the configuration sections of the PSADMIN menu, the system prompts you to enable a variety of options. One of these prompts relates to enabling the PSPPMSRV server process. When prompted with the following: Do you want Performance Collators configured? (y/n) Enter y to indicate Yes.

Method

Description

Quick Configure menu

You can use the Quick Configure menu in PSADMIN to enable the PSPPMSRV server process. Enable the Perf Collator option.

Custom Configuration menu

After you have scrolled through all of the configuration sections of the PSADMIN menu, the system prompts you to enable a variety of options. One of these prompts relates to enabling the PSPPMSRV server process. When prompted with the following:

Do you want Performance Collators configured? (y/n)

Enter y to indicate Yes.

To add additional PSPPMSRV server processes, use the [PSPPMSRV] configuration section in PSADMIN and adjust the settings. The [PSPPMSRV] configuration section contains the following parameters.

Min Instances (minimum instances)	Enter the minimum number of PSPPMSRV server processes that you want to start when the application server boots.
Max Instances (maximum instances)	Enter the maximum number of PSPPMSRV server processes that you want to start when the application server boots.

Note. For the PSPPMSRV server process, the values assigned to Min Instances and Max Instances must be equal. For example, if you want three PSPPMSRV server processes to start, set Min Instances=3 and Max Instances=3. Unlike PSAPPSRV, Tuxedo does not handle load balancing between PSPPMSRVs. Decide how many PSPPMSRV instances you need operating within the appropriate number of domains and boot all of them.

If you have more than one PSPPMSRV configured, the monitor servlet automatically implements load balancing across the multiple PSPPMSRVs. Also, if you configure multiple application server domains, each with its own PSPPMSRVs, the monitor servlet automatically implements load balancing and failover across the domains.

Setting Up the Web Server for the Monitoring System

By completing the internet portion of the PeopleSoft Multi-Platform Installer program, you have installed all of the elements that Performance Monitor requires on the web server. No additional installation procedures are required.

Performance Monitor servlets are not activated unless PSPPMSRVs register with them. Agent connections to a monitor are rejected until a PSPPMSRV on the monitoring system registers.

The Performance Monitor servlets that run on the web server of the monitoring system are:

Monitor servlet.
PPMI servlet.

Note. Make note of the URL of the web server for the monitoring system. On the monitored system, you need to specify the appropriate URL to which to send performance data.

Note. If you elect to implement a production monitoring system, you should set up the monitoring system itself in self-monitoring mode so that you can detect alarm events that are generated from the monitoring web server. That is, while the monitoring system monitors one or more PeopleSoft application systems, it also monitors itself.

If you need to configure multiple web servers for scalability and failover, you need to configure a cluster.

See Also

Setting Global System Options

Creating a PPMI User ID

The PSPPMSRV application server process acts as the PPMI client when you record PeopleSoft performance data. To register as a client, the PSPPMSRV requires the appropriate permissions in PeopleTools Security.

Warning! Setting up PSPPMSRV authentication is required.

To set up PPMI authentication:

Create a user profile with the name of your choice using PeopleTools Security.
Add the deliveredPeopleTools Perfmon Client role to the user profile.

The PeopleTools Perfmon Client role contains the PTPMCLNT permission list.
Select PeopleTools, Performance Monitor, Administration, Global Administration and enter the user profile that you created and the associated password in the PPMI User ID and PPMI Password text boxes.

Specifying the PPMI URL and PPMI User ID

PSPPMSRV processes must register with the PPMI servlet using the PPMI URL. The PSPPMSRV processes use the PPMI URL that is stored in the monitoring system's database to locate the PPMI servlet for registration.

The PSPPMSRV servers periodically read the PPMI value to determine the PPMI URL. When it is set to NONE, the monitoring system is disabled, which means that the PSPPMSRVs do not insert performance data into the monitoring database.

The PPMI user ID is required to authenticate the PSPPMSRV so that it can subscribe to performance data.

To specify the PPMI URL and PPMI user ID:

Make sure that you have created a PPMI user ID with the appropriate permissions (as described in the previous section).
Select PeopleTools, Performance Monitor, Administration, Global Administration.
On the Performance Monitor Administration page, enter the appropriate value in the PPMI URL edit box.

The format is: http[s]://host[:port]/ppmi/[site]/

For example: http://server1.peoplesoft.com/ppmi/ps/.

Where psis the name of the PeopleSoft site.
Specify the PPMI user ID and password.
Click Save.
Click Ping Test to ensure that the URL that you entered is valid and the URL is available.

Specifying the Integration Gateway URL

A gateway URL needs to be specified so that the monitoring system can notify the monitor servlet of configuration changes. The monitoring servlet in turn notifies the monitored agents of these changes when they next communicate with the servlet.

When specifying the gateway URL:

Select LOCAL gateway.
Enter this URL in the following format: http://host[:port]/PSIGW/PeopleSoftListeningConnector.

Setting Up the Process Scheduler Server for the Monitoring System

To invoke Performance Monitor Application Engine programs to maintain the performance data, set up a Process Scheduler server that connects to your monitoring database.

To set up a Process Scheduler server, follow the instructions that are provided in your Enterprise PeopleTools Installation Guide.

See Enterprise PeopleTools 8.49 Installation for your platform.

The delivered PeopleSoft Application Engine programs that you schedule to run as part of Performance Monitor administration enable you to:

Maintain the current PMU table (the PSPM_REAPER program).
Archive or delete historical performance data (the PSPM_ARCHIVE program).
Manage the lookup tables in the Performance Monitor interface (the PSPM_LOOKUP program).

See Also

Enterprise PeopleTools 8.49 Installation for your platform.

Administering the Performance Monitor

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.

Setting Up the Database of the Monitored System

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.

Specifying the Monitor URL

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:

Select PeopleTools, Performance Monitor, Administration, Specify Monitor.
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]/or NONE.

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

Where ps is the name of the PeopleSoft site.
Click Save.
Click Ping Test to ensure that you entered a valid URL and that the URL is available.

Setting Up the Web Server of the Monitored System

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.

Setting Up the Application Server

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). 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.

Setting Up the Process Scheduler Server

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.