Skip Headers

Oracle® Real User Experience Insight Accelerator for PeopleSoft Guide Release 5.1 for Linux x86-64 Part Number E13491-02 |
Home | Book List | Contents | Index | Contact Us

Previous | Next
| View PDF

# 1 Installation and Configuration

This chapter describes the procedure for installing the PeopleSoft package, and configuring your application definitions within RUEI to enable the accurate monitoring of PeopleSoft installations. This chapter describes the procedure for installing the PeopleSoft Package, and configuring your application definitions within RUEI to enable the accurate monitoring of PeopleSoft installations. This chapter describes the procedure for installing the PeopleSoft Package, and configuring your application definitions within RUEI to enable the accurate monitoring of PeopleSoft installations.

## 1.1 Why Use This Accelerator Pack?

This accelerator package for RUEI enables out-of-the-box monitoring of PeopleSoft modules. This monitoring supports user session tracking, the discovery of end-user performance issues, and the identification of application issues associated with PeopleSoft.

This accelerator package automatically discovers all installed PeopleSoft modules, and translates network objects to business functions. This facilitates the measurement and monitoring of real-user transactions, from initial query to their commit as part of business transactions. Individual user actions are automatically matched to the correct site, portal, or node in order to provide contextual analysis. This state-of-the-art monitoring solution supports the creation of KPIs for critical packaged applications, and the analysis of real-user business transactions.

## 1.2 Overview

In order to facilitate the correct monitoring of PeopleSoft installations by RUEI, you need to do the following:

1. Install the package RPMs on the RUEI Reporter system.

2. Verify the scope of monitored traffic.

3. Create and configure the PeopleSoft suite(s) required for your PeopleSoft Installations.

4. Run the `create_PSFT_info.sh` script on the PeopleSoft production environment.

5. Verify the cookie technology.

6. Verify and evaluate the PeopleSoft suite configuration.

Each of these steps are discussed in more detail in the following sections.

## 1.3 Installing the Package RPMs

Important:

The upgrade of an existing PeopleSoft accelerator package to release 5.1 must be performed at the same time as the upgrade of the RUEI system to version 5.1.

Note it is assumed a working RUEI system has been installed and configured (as described in the Oracle Real User Experience Insight Installation Guide), and is fully operational. Install the PeopleSoft support package on the RUEI Reporter system using the following command as the `root` user:

    cd /root/RUEI/51
    rpm -Uhv ux-suites-psft-*.x86_64.rpm

Note the location of the RPM depends on where you unzipped the package.

## 1.4 Verifying the Scope of Monitoring

Often the PeopleSoft software is configured to use a non-standard port, such as 800. The port on which your PeopleSoft installation is running can be found by examining the login URL. This takes the following format:

    http(s)://hostname:portnumber/psps/...

Verify the `portnumber` is configured as one of the defined ports (HTTP or HTTPS). In addition, if a HTTPS port is specified, ensure a copy of the Web server's private SSL key is imported into the Collector system(s).

To verify the port number, do the following:

1. Select Configuration, then Security, and then Protocols. The currently monitored ports are displayed. An example is shown in Figure 1-1.

   Figure 1-1 Monitored Ports

   Description of "Figure 1-1 Monitored Ports"

2. Use the View menu to select each Collector. The System (localhost) item represents the local server system.

3. If the port number is not already listed, click the required protocol (HTTP or HTTPS). The dialog shown in Figure 1-2 appears.

   Figure 1-2 Edit Collector Ports

   Description of "Figure 1-2 Edit Collector Ports"

   To add a new port number, enter the required number in the Port number field, and click Add. To remove a port from the list, click the Remove icon to the right of the port number. When ready, click Save.

4. For each Collector, you are prompted to restart the Collector. This is necessary in order to make the changes effective. Note you can also restart the selected Collector by clicking the Restart Collector icon shown in Figure 1-1.

5. For HTTPS traffic, you should also verify that, for each Collector, the required SSL keys are installed by selecting Configuration, then Security, and then SSL keys. Use the View menu to select a Collector. If the host name does not match one of the already listed SSL keys, import the required SSL key. The procedure to this is fully described in the Oracle Real User Experience Insight User's Guide. In addition, you should verify the key is not expired.

## 1.5 Creating the PeopleSoft Suite Definition

Within the RUEI Reporter, create and configure the suite definition(s) required for your PeopleSoft-based applications. Do the following:

1. Select Configuration, then Applications, and Suites. Click New Suite. The dialog shown in Figure 1-3 appears.

   Figure 1-3 PeopleSoft Suite Definition

   Description of "Figure 1-3 PeopleSoft Suite Definition"

2. Specify a name for the suite. The name must be unique across suites, services, and applications, and is restricted to a maximum of six characters. Note the suite cannot be renamed later.

3. Use the remaining fields to specify the scope of the suite. This is defined in terms of partial page URLs. Note that as you enter this information, you can see the effect of your definition through the Filter preview column. The use of blank filters is not permitted. While the use of a wildcard character (*) is permitted, all other specified characters are interpreted as literals. When ready, click Next. The dialog shown Figure 1-4 appears.

   Note:

   Filter definitions should be mutually exclusive across suites, applications, SSO profiles, and services. For example, do not define a suite filtered on the domain "us.oracle.com" and then another suite, application, SSO profile, service filtered on "us.oracle.com/application_servlet". The use of non-mutually exclusive filter definitions can lead to unpredictable results.

   Figure 1-4 Suite Type Dialog

   Description of "Figure 1-4 Suite Type Dialog"

4. This dialog allows you to specify the Oracle Enterprise architecture upon which the suite is based. The number of options available in this menu depends on the suite packages currently installed. Select the option "PeopleSoft". When ready, click Finish. The suite definition you have specified is displayed. An example is shown in Figure 1-5.

   Figure 1-5 Suite Overview

   Description of "Figure 1-5 Suite Overview"

## 1.6 Running the create_PSFT_info.sh Script

In order for RUEI to correctly translate the PeopleSoft business logic within your environment, do the following:

1. Copy the `create_PSFT_info.sh` script to the home directory of the PSFT server. It is located in the `/var/opt/ruei/processor/local/download/psft` directory of the RUEI system.

2. Run the `create_PSFT_info.sh` script as any user on the PSFT server.Foot 1 This script assigns an identification to the identified page IDs within the environment. The `create_PSFT_info.sh` script must be run with the following required parameter:

       create_PSFT_info.sh connect-string

   where `connect-string` is the string used to authorize the script to access the PeopleSoft database. The script reads from the APPLSYS schema, and generates .`txt` files in the current directory. For example:

       create_PSFT_info.sh "APPS/APPS@dliild-PSFT-:1522/dli03"
       create_PSFT_info.sh "APPS/APPS@PSFT"

   In multiple instance environments, run the script for each required instance, and separately preserve their created .`txt` files. In addition, create a separate suite definition for each instance, as described in Section 1.5, "Creating the PeopleSoft Suite Definition".

3. The script creates a number of .`txt` files in the directory where the script is executed. All relevant .`txt` files are collected and stored in a .`zip` file. Copy this .`zip` file to a location that can be used for uploading the files to the RUEI Reporter system.

4. Select Configuration, then Applications, then Suites, and select the suite you defined earlier in Section 1.5, "Creating the PeopleSoft Suite Definition". The dialog shown in Figure 1-6 appears.

   Figure 1-6 Upload Suite Configuration File

   Description of "Figure 1-6 Upload Suite Configuration File"

5. Specify the name of the .`zip` file containing the generated .`txt` files. If you manually create .`txt` files, you should use the same structure present in the .`zip` file. To protect against empty definitions, the upload will fail when it contains empty .`txt` files. When ready, click Upload.

## 1.7 Verifying the Cookie Technology

Within RUEI, session information is based on cookies. The cookies are used to connect hits to a specific visit. In general, the cookie is also connected to the user login page which allows RUEI to include a user name to all subsequent hits with the same cookie.

There are already some cookies available in PeopleSoft. Specifically, the cookie PS_TOKEN is used to track users from login to logout. To enable RUEI to monitor and track users over the complete session, please ensure the cookie path is set to "/".

Verifying the Cookie Configuration

To verify your cookie configuration, do the following:

1. Clear all cookies in the browser.

2. (Re)login to the PeopleSoft application.

3. View a few pages in PeopleSoft.

4. Logout.

5. Wait for at least 10 minutes.

6. Open the RUEI Reporter environment.

7. Select Browse data, open the All sessions group, select Session diagnostics, and locate the recorded session (by user ID or time). You can filter on applications.

8. Open the session and verify that:

   - There are more pageviews reported than just the login. This verifies the session ID is preserved after the login.

   - At least some PeopleSoft application activity has been recorded.

When not all hits are connected with the same cookie (these are reported as anonymous pages), it is recommended you investigate where the problem is located, and resolve it in the appropriate manner. For example, the domain or path option of the cookie.

## 1.8 Verifying and Evaluating Your Configuration

To ensure the quality of the data being collected and reported by RUEI for your PeopleSoft-based applications, it is strongly recommended you verify their reported details. You should pay particular attention to the number of associated pages detected for the defined suite(s).

Select Browse data, then select the All pages group, and then the Applications sub-group. Within the individual dimensions, such as Pageviews and hits, you can see pageviews are reported for several applications. The suite name in the definition is shown between brackets. An example is shown in Figure 1-7.

Figure 1-7 Suite Pageviews

Description of "Figure 1-7 Suite Pageviews"

Note:

The unique pages identified counter and the Last page identified indicator (shown in Figure 1-5) are disabled. Similarly, the manual page naming facility (described in the Oracle Real User Experience Insight User's Guide) is not available.

You can also open an overview of the monitored network traffic by selecting System, the Status, and then Data processing. This provides you with immediate information about hits, pages, and session processing, as well as the system load.

For further information on the user of this and other monitoring facilities, see the Oracle Real User Experience Insight User's Guide.

## 1.9 Known Limitations

Currently, the Oracle Real User Experience Insight accelerator for PeopleSoft does not work with all PeopleSoft functionality. In particular, the following known limitations exist:

- Reporting is based on the last activated area. Hence, when an end user is browsing simultaneously in multiple browser windows, the reported page name may contain incorrect information.

- Currently, the `create_PSFT_info.sh` script only runs on Unix PeopleSoft servers.

- An error is not immediately reported if an invalid connect string is specified when running the `create_PSFT_INFO.sh` script. You will need to press Enter several times before the error is reported.

Footnote Legend

Footnote 1: The script can also be run in the acceptance environment if it is equivalent to the production environment.