Installing HATS LE

This page lists the prerequisites for HATS LE and the steps for installing it.

Prerequisites

Software requirements

To install HATS LE, first make sure that you have installed the required software:

Table 1. HATS LE prerequisite servers
WebSphere Application Server Version 5.02 Version 5.1
WebSphere Application Server (Base edition) for iSeries X X
WebSphere Application Server Network Deployment for iSeries X X
WebSphere Application Server-Express for iSeries X X

For information on the latest PTF level for each server, visit: http://www.ibm.com/servers/eserver/iseries/software/websphere/wsappserver

Supported browsers and limitations

Users interact with HATS LE applications through a browser. Table 2 shows the supported browser types.

Table 2. HATS LE supported browsers
Operating System Netscape 6.2 or higher Netscape 7.0 or higher Internet Explorer 5.2.3 or higher Internet Explorer 5.5 or higher Mozilla 1.2.1 or higher Opera 5.0 or higher Konqueror 3.1 or higher Safari 1.0 or higher
Windows(R) X X X X X
AIX(R) X X
Solaris X X
Linux X X X
Macintosh X X X X X
  1. Bidirectional applications (such as Hebrew and Arabic) are not supported on Netscape browsers.
  2. HATS LE Administration is only supported on Internet Explorer, Mozilla, and Netscape browsers.
  3. With Opera, and Konqueror browsers, the function keys (F1 - F24) and the PageUp and PageDown keys on the keyboard do not perform any function. To enable the use of these keys in your applications, include a host keypad with these keys to enable the end user to send them to the host.
    Note:
    Mozilla does support these functions although the behavior is different. The same behavior is also present when using a Netscape browser. The PageUp and PageDown functions will perform the action on the object selected (such as a drop-down list) first. Then, the actual action (PageUp or PageDown) will be sent to the host in the Mozilla/Netscape browser.
  4. Konqueror browsers do not support retrieving the keyCode. Using the keyboard support, and pressing the Enter key with this browser might interact incorrectly with the host application. For applications that will run in Konqueror browsers, we recommend that you include a host keypad with the Enter key.
  5. With the Safari browser, because of functional limitations, keyboard support is limited. For applications that will run in Safari browsers, we recommend that you include a host keypad with all the keys to enable the end user to send the keys to the host. For more information see Appendix A. Remapping the keyboard in a HATS LE application.

Please review the HATS LE Readme file for last-minute updates to prerequisites.

Installing HATS LE

Note:
Users of WebSphere Application Server Network Deployment Version 5.02 or 5.1 for iSeries: it is not recommended to install HATS LE to any WebSphere instances that have been federated from WebSphere Application Server to WebSphere Application Server Network Deployment.

To install HATS LE on WebSphere Application Server Version 5.02 and 5.1 for iSeries, WebSphere Application Server Network Deployment Version 5.02 and 5.1 for iSeries, or WebSphere Application Server-Express for iSeries Version 5.02 or 5.1 follow these steps:

  1. Start the WebSphere Administrative Console in your browser.
  2. In the left column, expand Applications and click Install New Application.
  3. Browse and find HATS5LE.ear from the local path.
  4. Continue clicking Next until you reach the Summary screen. Click Finish.
  5. Click the link to Save to Master Configuration.
  6. Click Save. You will return to the main page of the WebSphere Administrative Console.
  7. In the left column, expand Applications and click Enterprise Applications. In the right frame, click the check box next to HATS5LE.ear, and click Start.
  8. In the left column, expand Environment, click on Update Web Server Plugin then Click OK.

Uninstalling HATS LE

To uninstall HATS LE on WebSphere Application Server Version 5.02 and 5.1 for iSeries, WebSphere Application Server Network Deployment Version 5.02 and 5.1 for iSeries, or WebSphere Application Server-Express for iSeries Version 5.02 or 5.1 follow these steps:

  1. Start the WebSphere Administrative Console in your browser.
  2. In the left column, expand Applications and click Enterprise Applications. In the list to the right, click the check box next to HATS5LE.ear, and click Stop.
  3. Select the HATS5LE.ear again and click Uninstall. It will then be removed from the list.
  4. Click the Save link above to go to the save page.
  5. Click Save. You will return to the main page of the WebSphere Administrative Console.
Note:
In some cases, log files (created while running your application with runtime tracing turned on) are not deleted when uninstalling your HATS LE application. To avoid this problem, before uninstalling your application, completely stop the application server instance where the HATS LE application is running. If these files still exist after uninstalling your HATS LE application, manually delete them (including the "HATS5LE.ear" directory under the "installedApps" directory) before reinstalling HATS LE.