K PeopleSoft Support
This appendix provides a detailed discussion of the support available for the accurate monitoring of PeopleSoft-based applications. This support is only available if you have a valid Application Management Suite for PeopleSoft licence. For more information, contact your Oracle representative.
Introduction to PeopleSoft
The monitoring support provided by this version has been verified against PeopleSoft applications based on PeopleTools version 8.48 and 8.49. Earlier versions, although not tested, should also work.
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
/pspt/...
Verify the portnumber
is configured as one of the defined ports (HTTP or HTTPS). In addition, if a HTTPS port is specified, ensure that a copy of the web server's private SSL key is imported into the Collector system(s).
Creating PeopleSoft Suite Definitions
You can create suite definitions for PeopleSoft-based applications in the same way as for any other supported Oracle Enterprise architecture. The procedure to create suites is described in Creating Suite Definitions.
Running the create_PSFT_info.sh Script
In order for RUEI to correctly translate the PeopleSoft business logic within your environment, do the following:
Verifying the Cookie Technology
When creating a PeopleSoft suite instance, a preconfigured cookie for the PeopleSoft environment is automatically created. This is implemented as a custom cookie, with the name PS_TOKEN
. Probably this will be suitable for your PeopleSoft environment. However, depending on the configuration of your environment, you may need to modify this. In addition, 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:
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.
Hostnames and URL Prefixes
A PeopleSoft Implementation, and the PeopleSoft instance, can be identified with a hostname. Generally, a PeopleSoft suite can be accessed in two ways: using only the hostname, or using the fully-qualified hostname (including the domain). Generally, you only need to specify the domain.
Database Tables
The following PeopleSoft database table is used by the create_PSFT-Info.sh
script to retrieve information about the customizations:
-
PSPRSMDEFN: portal_name, portal_prntobjectname, portal_objname, portal_label, and portal_urltext are used to fill the
PSFT_object2portallabeltree.txt
andPSFT_porturltext2portallabeltree.txt
files. -
PSPNLFIELD: populates the
PSFT_pnlfield2label.txt
file. -
PSPNLGROUP: populates the
PSFT_pnl2itemlabel.txt
file.
Data Items
The PeopleSoft-specific data items shown in Table K-1 are reported by RUEI.
Table K-1 Dimensions
Item | Description |
---|---|
PeopleSoft Content Code |
The content for this request. |
PeopleSoft End Node Code |
The end node of PeopleSoft. |
PeopleSoft Folder Path Code |
The folder path for this request. |
PeopleSoft ICaction |
The name of the action performed. |
PeopleSoft ICaction Code |
The ID of the action performed. |
PeopleSoft Node |
Name of the node that contains the content for this request. |
PeopleSoft Node Code |
ID of the node that contains the content for this request. |
PeopleSoft Panel Item |
The panel item for this request based on mapping PSFT_pnl2itemlabel that is created from target environment table called PSPNLGROUP. |
PeopleSoft Panel Item ID |
The panel item based on 'Page' parameter. |
PeopleSoft Portal |
Name of the portal where the end user was browsing. The portal definition contains metadata that describes how to present the content (template pagelets and so on). |
PeopleSoft Portal Code |
ID of the portal where the end user was browsing. The portal definition contains metadata that describes how to present the content (template pagelets and so on). |
PeopleSoft Site |
The site name specified during PeopleSoft Pure Internet Architecture setup. This enables you to set up multiple sites on one physical Web server. The site name is ultimately mapped by the Web server to the appropriate configuration properties file. |
PeopleSoft Site Code |
The site name specified during PeopleSoft Pure Internet Architecture setup. This enables you to set up multiple sites on one physical Web server. The site name is ultimately mapped by the Web server to the appropriate configuration properties file. |
Resources
You may find the following source useful:
-
Configuring HTTP server to use SSL in Oracle applications (note 341904.1).
Known Limitations
Currently, RUEI 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. -
Applications that make use of a Rich Internet Application (RIA) framework (such as Ajax) may have reduced replay capability.
Footnote Legend
Footnote 1:The script can also be run in the acceptance environment if it is equivalent to the production environment.