Technical Notes

Installing Reflection on an iSeries or AS/400 with WebSphere Application Server Express 6
Technical Note 2173
Last Reviewed 30-May-2008
Applies To
Reflection for the Web 2008 (All Editions)
Reflection for the Web version 8.0 through 9.6
WebSphere Application Server Express version 6.x
Summary

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

Before You Begin

Before installing Reflection for the Web, we recommend that you have all of the latest Cumulative Fixes for your i5/OS (OS/400) version as well as any Group Program Temporary Fixes (PTFs) for the following applications:

• WebSphere Application Server Express 6 Group Program Temporary Fixes (PTFs)
• Java Developer Kit 1.5 or higher for Reflection for the Web 2008; JDK 1.4 or higher for earlier versions
• IBM HTTP Server Group Program Temporary Fixes (PTFs)

Prepare the rweb.war File

Follow these steps to prepare the rweb.war file:

1. Expand (Unzip) the Reflection for the Web installation files, and then copy the rweb.war file from the /nonautomated folder to a temporary folder on your PC.
2. During download, the rweb.war file may be named rweb.war.zip. If so, rename rweb.war.zip to rweb.war.

3. Using an FTP client, transfer the rweb.war file (using binary transfer type), to the following IFS directory on your AS/400.

Verify that the QWAS6 Subsystem is Started

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

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

Configure the iSeries Express Server

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

1. Open the IBM WebSphere Application Server Express Administration Console and click IBM Web Administration for i5/OS. By default, this is accessed from http://<myserver>:2001.
2. On the Application Servers tab, expand Applications and click Create Manage Installed Applications.
3. Click the Manage Tab, and then the Application Server tab.
4. On the Manage Installed Applications panel, click Install.
5. On the Install New Application panel, browse to the rweb.war file. By default, this file is located in the /QIBM/UserData/WebSphere/AppServer/V6/Base/profiles/default/installableApps folder.
6. Select the radio button for "Application is contained in a WAR file" and wait for the page to update.
7. In the Context Root field, enter /rweb, and then click Next.
8. Verify the application name is rweb.war. If you would like to have the JSPs compiled on application startup, rather than the first time the page is viewed, check the box for Pre-compile JSPs. (Note that this extends the time for the rweb application to start under Websphere the first time after install.)
9. Click Next.
10. Choose your Virtual Host or click Next to accept the defaults.
11. Print the Summary page for your records, and then click Finish.

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

Note: It may take quite a while for the new rweb.war application to be created. The current state of the process is displayed in the upper-left corner of the window.

Update the web.xml Files

Reflection for the Web stores configuration information in the ReflectionData directory. You must create a ReflectionData directory, if one does not already exist, in a location that is accessible to Reflection for the Web (for example, /usr/local/ReflectionServer/ReflectionData). Ensure that rights are set so that Reflection for the Web can write to the ReflectionData directory.

Now, edit the web.xml file to specify the ReflectionData directory location and the SSL port value:

1. Navigate to the /usr/local directory and create a new directory named ReflectionData (if one does not already exist).
2. There are two copies of the web.xml file, located in the following directories:

3. Open each file, web.xml, in the text editor of your choice.
4. In each web.xml file, locate the <parm-name>ReflectionData</parm-name> section and modify the file to specify the ReflectionData directory location and the SSL port value, substituting your sslport value for 443. For example,

Starting Reflection for the Web

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

1. Select the Application Server tab.

2. Select Manage Installed Applications from the menu on the left.
3. Select the rweb application you just installed and click Start. Verify that RWEB has been started and has a status of Ready.

Reflection is now installed. To access Reflection for the Web, open a browser and enter the URL, WAS port, and context root to your server.

Syntax:

For example:

Related Technical Notes

1778	Installing Reflection Metering on an iSeries or AS/400 with WebSphere Application Server Express
1779	Installing Reflection for the Web with WebSphere Application Server
9988	Reflection for the Web Technical Notes