Install the client run time on a workstation

These instructions describe how to install the client runtime support for WebSphere application clients on your workstation machines.

Note: Although you can install the WAS on an HP_UX system, the WebSphere application client is not supported on HP-UX systems. See Supported hardware, software, and APIs Link outside Information Center for more information on supported product platforms.

Follow these steps to install the client runtime support:

  1. (Optional) If you want to develop Java pluggable application clients, first install the Sun Microsystems Java 2 Platform, Standard Edition (J2SE) on your workstation. The application client runtime support requires J2SE version 1.3.1_03 or later, but not including version 1.4 or later.

  2. (Optional) If you plan to install application clients with the embedded messaging client feature on Version 9 of the Sun Solaris Operating Environment, see Install application clients on Version 9 of Sun Solaris before continuing with these instructions.

  3. Insert the IBM WAS Application Clients for Windows NT, Windows 2000, AIX and Solaris CD-ROM into the CD-ROM drive on your workstation.

    Note: Do not use the WAS for iSeries CD-ROM (which also came in your WAS package).

  4. From a command prompt or a graphical file manager, navigate to the root directory of the CD-ROM. Run the client installation wizard for your specific platform:

    • AIX: install.sh
    • Solaris: install
    • Windows 32-bit: install.exe

    The WAS client install wizard appears.

  5. Select the language for the installation and click OK.

  6. If you have an earlier version of the WAS client installed on your machine, an information window appears. Click Yes to all to overwrite this older version.

  7. For the Software License Agreement, click Yes.

  8. Select a setup type and click Next

  9. Select the features you want to install and click Next.

    Note: If you choose the Applet client (Windows only), and you have an existing development kit or runtime environment installed, click Yes to overwrite the existing development kit or runtime environment registry entries. If you click No, you return to the Custom Features panel, where you can clear Applet client. You must use the Applet client with the runtime environment provided by WAS.

  10. If you want to install the samples development environment, click Yes

  11. Select the destination folder for the installation. This is the directory on the workstation to contain the client runtime installation. Click Next.

  12. If you are prompted to create the destination folder, click Yes.

  13. Enter the host name of the server matching hosting the WebSphere application server to which your applications connect, and click Next. If you do not know the host name, you can enter any name and correct it after the install. To correct the host name after the install, edit the following files updating the file as indicated below:

    • install_root/install/InstallInfo
      Specify the correct host name value for the HOSTNAME property.
    • install_root/bin/setupClient.bat (.sh if running on Unix platform)
      Specify the correct host name value for the DEFAULTSERVERNAME environment variable.

  14. Specify the port number on which the naming service for the application server is listening. Click Next. If the application server is using the default port 2809, you do not need to enter a port number here. If you do not know the name service port on which the application server listens, you can correct the port after the install. To correct the port value specified during install, modify the following files as indicated below:

    • install_root/install/InstallInfo
      Specify the correct port value for the PORT property.
    • install_root/bin/setupClient.bat (.sh if running on Unix platform)
      Specify the correct port value for the DEFAULTPORTNUMBER environment variable.

  15. A progress window appears. If you chose to install the applet client, an information window appears. Click Yes to overwrite the existing JRE registry entry.

  16. The installation dialog is displayed, indicating the progress of the installation process. The installation program copies all files to the workstation and performs any necessary configuration. The Setup Complete panel is displayed when the installation is complete. Click Finish.