Attachmate Worldwide  |   Contact Us  |   NetIQ.com
Home » Support » Solution Library

Technical Notes

Installing Reflection Metering on an iSeries or AS/400 with WebSphere Application Server Express
Technical Note 1778
Last Reviewed 30-May-2008
Applies To
Reflection for the Web 2008
Reflection for the Web version 8.0 through 9.6
WebSphere Application Server Express version 5 or higher
Summary

This technical note provides steps and suggestions for installing Reflection for the Web metering on an iSeries or AS/400 with WebSphere Application Server Express.

Prerequisites

Before installing Reflection for the Web, you must have all of the following installed and configured on your AS/400 host.

  • Reflection for the Web
  • WebSphere Application Server Express 5 or higher
  • Java Developer Kit 1.5 or higher for Reflection for the Web 2008; JDK 1.4 or higher for Reflection 9.x; or JDK 1.3 or higher for Reflection 8.x
  • IBM HTTP Server
  • The cumulative and group PTFs (Program Temporary Fixes) for your OS level for the following areas:
WAS Express
Database
Java
IBM HTTP Server

Configure the iSeries Express Server

Follow the steps below to configure the iSeries Express Server for Reflection:

  1. Open the iSeries HTTP Server with IBM WebSphere Application Server Express Administration Console and click IBM WebSphere Application Server. By default, this is accessed from http://<myserver>:2001.

Note: The IBM WebSphere Application Server screens may vary slightly, depending on the OS Level and PTFs you have installed.

  1. Click the Manage tab, and then click the Application Servers tab.
  2. On the Application Servers tab, expand Common Tasks and Wizards, click Create Application Server, and then click Next.
  3. In the Application server name field, enter RMETERING, and then click Next.

Note: Use upper case characters. You can use any name for the application server, but we recommend using RMETERING.

  1. Choose "Select an existing HTTP server (powered by Apache)," and then click Next.

Note: You can choose to create a new HTTP server, but this technical note discusses using an existing HTTP server only.

  1. Select APACHEDFT and click Next.
  2. In the 'First port in range field,' enter a starting port number, and then click Next.

Note: We recommend using port 3013 (if this port is not already in use). This reserves ports 3013-3024 for Reflection.

  1. In the Select Business Sample Application window, click Next to accept the defaults.
  2. Print the Summary page for your records, and then click Finish.

The new WebSphere application server is created, and a management screen for your version opens. For example, if you are using Websphere Application Server Express version 5, the "Manage Application Server-Express, 'V5'" screen displays.

Note: Do not start the server.

Installing Metering

After the WebSphere application server has been created, follow the steps below to install Reflection for the Web metering to your new Express Server.

Obtain the rwebmeter.war File

Follow these steps to obtain Reflection rwebmeter.war file:

  1. Verify that there is a /ReflectionData directory in the OS/400 system root (this should have been created while installing Reflection for the Web). If not, use Qshell, WRKLNK, or an FTP client, to create the directory. Make sure the directory is not protected.
  2. Copy the rwebmeter.war file from the /nonautomated directory in the Reflection for the Web downloaded product files (or the product's CD-ROM) to the <WAS_install_root>/RMETERING/installableApps directory on your OS/400 system. By default, this path is:
/QIBM/UserData/WebASE/ASE5/RMETERING/installableApps

Note: If you transfer the file using FTP, use the Binary transfer type.

Update the WebSphere Express Server Settings

Follow the steps below to update the WebSphere Express Server settings:

  1. Open the iSeries HTTP Server with IBM WebSphere Application Server Express Administration Console. By default, this is accessed from http://<myserver>:2001.
  2. Click IBM WebSphere Application Server, select the Manage tab, and then select the RMETERING server from the Server drop-down menu (top-center of page).
  3. On the left-navigation bar, expand Applications, and then click Manage Installed Applications.
  4. In the main window, click Install.
  5. Select 'Application is contained in a WAR file,' and then browse to and select the rwebmeter.war file.

Note: Make sure to select the rwebmeter.war file, not the folder where it resides.

  1. In the Context root entry field, enter /rwebmeter, and then click Next.
  2. In the Provide Options to Perform the Installation window, click Next to accept the defaults.
  3. Select the Virtual host for your application. It is recommended that you use the default, default_host.
  4. Click Next.
  5. Print the Summary page for your records, and then click Finish.

The new rwebmeter.war application is installed and the Manage Installed Applications screen opens.

Note: It may take quite a while for the new rwebmeter.war application to be created. The current state of the process is displayed. The state will be Installing until it is complete, when it will change to Stopped.

Verify that the QASE5 Subsystem is Started

Before proceeding, make a terminal session connection to your AS/400 and use the WRKACTJOB command to verify that the QASE5 subsystem is started.

If QASE5 is not started, refer to your WebSphere documentation for directions on starting the subsystem. QASE5 must be started before you proceed.

Update the web.xml File

Follow the steps below to update the web.xml file.

  1. Open the web.xml file in
/<WAS_install_root>/RMETERING/installedApps/<my_host_RMET
ERING>/rwebmeter.war.ear/rwebmeter.war/WEB-INF/
  1. Locate the following line:
<parm-value>rwebdata_location_placeholder</param-value>

and modify the file to include the fully qualified path to the /ReflectionData/log directory (the data in red below):

<parm-value><install path>/ReflectionData/log</param-value>
  1. Save the file.

Once you have updated and saved the web.xml file, return to the Manage Installed Applications window and follow the steps below.

  1. From the Server drop-down menu (top-center of window), select All Servers.

Check the HTTP server's status. By default, this is APACHEDFT. (The status is displayed in the Status field.) If the server is not running, click Start.

  1. On the All Application Servers tab, select the RMETERING application server.

Check the RMETERING application server's status. (The status is displayed in the Status field.) If the server is not running, click Start.

  1. Click the Application Servers tab.
  2. In the left-menu bar, expand Applications, and then click Manage Installed Applications.
  3. Verify that the rwebmeter.war application is running. If not, select the rwebmeter.war application and click Start.
  4. Once the servers and application are started, make a terminal session connection to your AS/400 and use the WRKACTJOB command to view the QASE5 subsystem. Verify that the RMETERING job has been started and has a status of Ready.

Reflection metering is now installed.

Enabling Metering

Follow the steps below to enable Reflection for the Web metering in the Administrative WebStation.

  1. Go to http://<AS400 server>:3010/rweb/AdminStart.html.

Where <AS400 server> is the fully qualified name of your server. For example, http://myhost.atm.com:3010/rweb/AdminStart.html.

  1. Log in and then click Administrative WebStation.
  2. Click Settings.
  3. On the Metering tab, enter the following:
    Field name
    		Enter
    Metering web server name
    		Your fully qualified host name. For example, myhost.atm.com.
    Metering web server port
    		3022
    Metering servlet context
    		rwebmeter
  1. Click Add to Table.

Configuring Metering and Running Reports

There are two interfaces: Metering Configuration, which enables you to specify what gets metered, and Metering Reports, which enables you to configure and run a metering report.

Meter Configuration

To access Meter Configuration, open a browser and enter the following URL.

Syntax:

http://<myserver>:<default_port>/<context_root>/AdminStart.html

For example:

http://AS400.atm.com:3022/rwebmeter/AdminStart.html

Meter Reports

To access Meter Reports, open a browser and enter the following URL.

Syntax:

http://<myserver>:<default_port>/<context_root>/

For example:

http://AS400.atm.com:3022/rwebmeter

Note: You can also run a default report (with no configuration options) from within the Administrative WebStation by clicking Reports > Usage Metering, selecting a metering server, and then clicking the Show Reports button.

Related Technical Notes
9988 Reflection for the Web Technical Notes

Did this technical note answer your question?

Yes    No    Somewhat     Not sure yet

Additional comments about this tech note:

Need further help? For technical support, please contact Support.