Skip Headers
Oracle® Real User Experience Insight User's Guide
Release 6.0.1 for Linux x86-64

Part Number E16359-02
Go to Documentation Home
Go to Book List
Book List
Go to Table of Contents
Go to Index
Go to Feedback page
Contact Us

Go to previous page
Go to next page
View PDF

H WebLogic Portal (WLP) Support

This appendix provides a detailed discussion of the support available for the accurate monitoring of WebLogic Portal (WLP)-based applications. Note that WLP support is provided as part of the default RUEI installation. No separate installation procedure needs to be applied.

H.1 Introduction

RUEI supports out-of-the-box monitoring of WLP applications. It automatically discovers WLP Web applications, and translates network objects to business functions. Using this support, individual user actions are automatically matched to the correct Web application, desktop, portal, book, and page to provide contextual analysis.

RUEI supports the monitoring of file-based portals as well as streaming portals. For the latter, the Disc framework must be enabled. For the monitoring of file-based portals with the Disc framework not enabled, additional information must be uploaded about the configuration of the monitored portal. This is described in Section H.3, "Synchronizing RUEI with your WLP Environment". Note that the monitoring of streaming portals that do not use the Disc framework is not supported.

The monitoring support described in the rest of this appendix has been verified against applications based on WLP version 10.3.

H.2 Creating WLP Suite Definitions

You can create suite definitions for WLP-based applications in the same way as for any other supported Oracle Enterprise architecture. The procedure to create suites is described in Section 6.4, "Working With Suites".

The procedure to define a WLP suite instance is briefly summarized as following:

  1. Select Configuration, then Applications, then Suites, and click New suite.

  2. Specify a name for the suite instance. The name must be unique across suites, services, SSO profiles, and applications, and is restricted to a maximum of six characters. Note that it cannot be renamed later. Use the remaining fields in the dialog to specify the scope of the suite. See Section 6.4, "Working With Suites" for information on this. When ready, click Next.

  3. Select the "WebLogic Portal" option from the Suite type menu. When ready, click Next. Upon completion, the suite definition you have specified is displayed. An example is shown in Figure 7-12.

    Figure H-1 Example WLP Suite Overview

    Description of Figure H-1 follows
    Description of "Figure H-1 Example WLP Suite Overview"

H.3 Synchronizing RUEI with your WLP Environment

If the monitored suite instance is a file-based portal with the Disc framework not enabled, RUEI needs to understand how the portal is implemented within your environment. Do the following:

  1. Copy the script from the /var/opt/ruei/processor/local/download/wlp directory to the location where you intend to run the script. Copy to the same location the .portal file used by the monitored application.

  2. Run the script on the Report system. This script creates translations for the monitored environment. The script must be run with the following required parameter:

    pearl -portal file.portal

    where file is the name of the .portal file used by the monitored application.

    In multiple instance environments, run the script for each required instance, and separately preserve their created .txt files. Create a separate suite definition for each instance, as described in Section H.2, "Creating WLP Suite Definitions". In addition, be aware that if you make any changes to the monitored application, you need to re-run the script, and re-import the generated .zip file.

  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 H.2, "Creating WLP Suite Definitions,". Click Upload Configuration. The dialog shown in Figure H-2 appears.

    Figure H-2 Upload Suite Configuration

    Description of Figure H-2 follows
    Description of "Figure H-2 Upload Suite Configuration"

  5. Specify the name of the .zip file containing the generated .txt files. To protect against receiving empty definitions, the upload will fail when it contains empty .txt files. When ready, click Upload.

H.4 Specifying the Cookie Technology

As explained previously, session information is based on cookies. The procedure to specify the cookie technology used by your applications is fully explained in Section 7.1, "Specifying Cookie Technology".

When creating a WLP suite instance, a preconfigured cookie for the WLP environment is automatically created. This is implemented as a custom cookie, with the name JSESSIONID. Because WLP is based on the WebLogic technology, it is likely that the preconfigured cookie is suitable for your WLP applications. 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, you should ensure the cookie path is set to "/".

H.5 Configuring User Authentication

RUEI supports out-of-the-box monitoring of WLP applications that employ user authentication based on the REST framework. However, if the monitored portal uses some other user authentication mechanism, then this needs to be configured. The procedure to do so is described in Section 6.2.9, "Defining User Identification".

H.6 Verifying and Evaluating Your WLP Definitions

To ensure the quality of the data being collected and reported by RUEI for your WLP-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 shown in Figure H-3 is for a streaming portal.

Figure H-3 Suite Pageviews

Description of Figure H-3 follows
Description of "Figure H-3 Suite Pageviews"

H.7 Suite Definition Mappings

A WLP application can be identified with a hostname. Generally, a WLP 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.

Table H-1 shows how the dimensions of a WLP application are reported in RUEI.

Table H-1 WLP Definition Mappings.

Dimension level Content

For streaming portals:

web-app portal/desktop (suite_name)

For file-based portals:

portal (suite_name)

Application. page-group

For streaming portals:

suite_name.web-app portal/desktop » book

For file-based portals:

suite_name.portal » book

For streaming portals:

suite_name.web-app portal/desktop » book » page.action

For file-based portals:

suite_name.portal » book » page.action


Figure H-4 shows an example of how a streaming portal is reported in RUEI.

Figure H-4 Example of WLP Application Page Reporting

Description of Figure H-4 follows
Description of "Figure H-4 Example of WLP Application Page Reporting"

H.8 Known Limitations

Currently, RUEI does not support all WLP functionality. In particular, the following known limitations exist.