Installing the EGL runtime code for Java

The EGL runtime code for generated Java™ applications is in the Rational® Business Developer plugins directory. The plugins directory is located in the product shared resources directory.

The runtime code is located in the following plug-in JAR file:
   com.ibm.etools.egl.java.binaries_version.jar
version
Current version of the product.
The following distributed platforms are supported:

See product prerequisites for supported versions. EGL provides 32- and 64-bit support for AIX, HP-UX, and Solaris. Linux for zSeries support is 64–bit only.

The runtime code includes the following:
Do as follows:
  1. Extract the files to each system on which deployed EGL applications are to be run.
  2. Include the JAR files in the CLASSPATH of the deployment systems. Here are the files:
    • fda7.jar is required for all uses and is in com.ibm.etools.egl.java.runtime_version, where version is the product version.
    • fda6wrappers.jar is needed if you used Java wrappers in EGL version 6.x, are regenerating the wrappers in EGL 7.x, and wish to avoid updating the native Java code that invokes the wrappers. In this case, set the build descriptor option wrapperCompatibility to V6 at generation time, as noted in the help topic for that option.

      The file fda6wrappers.jar is in the same location as fda7.jar.

    • hpt.jar is needed in two cases:
      • You are running Web transactions; or
      • You used Java wrappers in VisualAge® Generator version 4.x or 5.x, are regenerating the wrappers in EGL 7.x, and wish to avoid updating the native Java code that invokes the wrappers. In this case, set the build descriptor option wrapperCompatibility to V4 or V5, as appropriate. For details, see the help topic for that option.

      The file hpt.jar is in com.ibm.etools.egl.java.runtime_version\webtrans, where version is the product version.

    • hpt.gateway is also needed if you are running Web transactions. The file is in the same location as hpt.jar.
    • vgjwgs.jar is needed if you are running Web transactions that were generated with VisualAge Generator 4.x.
  3. Copy any platform-specific code to a directory on each deployment system; and set environment variables for each of those systems as appropriate:
    For AIX (32- or 64-bit support)
    The files of interest are in the directory Aix or (for 64-bit support) Aix. Change the PATH and LIBPATH environment variables so they reference the directory that contains the platform-specific code you copied from the Web site.
    For HP-UX (32- or 64-bit support)
    The files of interest are in one of the following four directories:
    • For ITanium processors:
      • HPUXItanium
      • HPUX64Itanium (for 64-bit support)
    • For RISC processors:
      • HPUXRisc
      • HPUX64Risc (for 64-bit support)

    Change the PATH and LD_LIBRARY_PATH environment variables so they reference the directory that contains the platform-specific code you copied from the Web site.

    For iSeries
    The files of interest are in the directory iSeries. In qshell, change to the directory you just uploaded the files to and run the setup.sh script with the "install" option:
    > setup.sh install
    In addition, some other environment variables must be set. For information on how to set these environment variables, run the script with the "envinfo" option:
    > setup.sh envinfo
    If for some reason you delete a symlink that is created for you during install, you can recreate it with the "link" option:
    > setup.sh link

    You also need to set the LIBPATH environment variable.

    For Linux (Intel hardware)
    The required files are in the directory Linux. Change the PATH and LD_LIBRARY_PATH environment variables so they reference the directory that contains the platform-specific code you copied from the Web site.
    For Linux (zSeries hardware)
    The required files are in the directory Linux. Change the LD_LIBRARY_PATH environment variable so it references the directory that contains the platform-specific code you copied from the Web site. (EGL provides no executable programs for this platform, so it does not require the PATH variable.)
    For Solaris (32- or 64-bit support)
    The files of interest are in the directory Solaris or (for 64-bit support) Solaris64. Change the PATH and LD_LIBRARY_PATH environment variables so they reference the directory that contains the platform-specific code you copied from the Web site.
    For USS
    The files of interest are in the directory USS. Change the PATH and LIBPATH environment variables so they reference the directory that contains the platform-specific code you copied from the Web site.
    For supported Windows platforms
    The files of interest are in the directory Win32. Change the PATH environment variable so it references the directory that contains the platform-specific code you copied from the Web site.

Feedback