|
|
|
Installing Reflection for the Web with WebSphere Application Server
Technical Note 1779
Last Reviewed 30-May-2008
Applies To
Reflection for the Web 2008 (All Editions)
Reflection for the Web version 8.0 through 9.x
WebSphere Application Server version 5.0.2 or higher
Summary
Technical Note 1779
Last Reviewed 30-May-2008
Applies To
Reflection for the Web 2008 (All Editions)
Reflection for the Web version 8.0 through 9.x
WebSphere Application Server version 5.0.2 or higher
Summary
This technical note provides steps and suggestions for installing Reflection for the Web on a WebSphere Application Server.
Before You Begin
Before installing Reflection for the Web, you must have all of the following installed and configured on your host.
- WebSphere Application Server 5.0.2 or higher.
- Java Developer Kit 1.5 or higher; JDK 1.4 or higher for Reflection for the Web 9.x; or JDK 1.3 or higher for Reflection for the Web version 8.x.
- The most recent WebSphere cumulative and group program temporary fixes (PTFs) must be applied.
- Reflection for the Web requires 220 MB of free disk space in the hosts /tmp file during installation.
- If you want to use security (HTTPS, SSL) with the WebSphere Application Server (WAS), refer to your IBM documentation to properly configure the WAS.
Installing Reflection for the Web
After the WebSphere Application Server has been properly installed and tested, follow the steps below to install Reflection for the Web.
Prepare the rweb.war File
Follow these steps to prepare the rweb.war file:
- Copy the /nonautomated/rweb.war file located with the downloaded product files (or on the Reflection for the Web CD) to a temporary folder on your PC.
- During download, the rweb.war file may be named rweb.war.zip. If so, rename rweb.war.zip to rweb.war.
Note: When renaming the file, you may receive an error stating that the file may become unstable. Click Yes to proceed.
Update the WebSphere Server Settings
Follow the steps below to update the WebSphere Server settings:
- Open the WebSphere Administration Console. By default, this is accessed from http://<myserver>:9060/admin or http://<myserver>: 9060/ibm/console.
- On the left-navigation bar, expand Applications, and then click Install New Application.
- In the main window, select the "Local file system” radio button and enter the path to the rweb.war file. For example:
C:\Temp\rweb.war –or– /u/local/rweb.war
- Select the “Show me all installation options and parameters” radio button.
- In the Context root entry field, enter /rweb, and then click Next.
- Select the "Generate Default Bindings" check box, leave all other values at default, and then click Next.
- Click Next through the Install New Application dialog box, accepting defaults.
- Select the rweb.war check box, make sure the Virtual Host is set to default_host, and then click Next.
- Print the Summary page for your records, and then click Finish.
The new rweb.war application is installed and the Administration Console screen opens. If you expand the Applications menu and select Enterprise Applications, the application state for rweb should be Stopped.
Click Save to update the master configuration.
Update the web.xml File
There are two copies of the web.xml file, located in the following directories:
/WAS_install_root/installedApps/<cellname>/rweb.ear/rweb.war/WEB-INF/web.xml- and -
/WAS_install_root/config/cells/<cellname>/applications/rweb.ear/deployments/rweb/rweb.war/WEB-INF/web.xmlNote: If this is a WebSphere Application Server Network Deployment, there is an additional web.xml that must be updated:
/IBM/WebSphere/AppServer/profiles/Dmgr01/config/cells/<dellname>/applications/rweb_war.ear/deployments/rweb_war/rweb.war/web.xml
In both (or all three) files, locate the <param-name>ReflectionData</param-name> section and modify the file to include the data in red below, entering your path to ReflectionData (for example, C:\ReflectionData or /u/local/ReflectionData), and substituting your own sslport value for 443:
<context-param id="ContextParam_1065567022078"> <param-name>ReflectionData</param-name> <param-value><PathTo>ReflectionData</param-value> </context-param> <context-param id="ContextParam_1065567022079"> <param-name>sslport</param-name> <param-value>443</param-value> |
Reflection for the Web stores configuration information in the ReflectionData directory. If this is a UNIX installation, ensure that rights are set so that Reflection for the Web can write to the ReflectionData directory.
Note: In Reflection for the Web 2008, the sslport parameter is located in the PropertyDS.xml file, which is located in the ReflectionData folder. If you want to use a port other than default port 443; you must edit PropertyDS.xml after Reflection for the Web 2008 is started in WebSphere.
Once you have updated and saved both (or all three) of the web.xml files, return to the Administrative Console window and follow the steps below.
- Expand the Applications menu item, and then click Enterprise Applications.
- In the Enterprise Applications dialog, select the rweb check box, and then click Start. The application status will change to a started, indicated by a green arrow in the Status field.
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: http://myserver:default_port/context_root
For example: http://rweb.atm.com:9080/rweb
