HTTPS installation instructions

This section describes installation requirements for Web servers hosted on an HP-UX machine, including environment variable settings, and which files to copy from your EAServer installation to the Web server host.

  1. On the Web server host, set the JAGUAR and JAGUAR_CLIENT_ROOT environment variables to point to the EAServer installation directory. When you copy files and subdirectories to this directory, you must maintain the existing directory structure. In other words, you must copy files that are located in $JAGUAR/db on the EAServer host to a $JAGUAR/db subdirectory on the Web server host.

    You may need to edit the $JAGUAR/bin/setenv.sh or setenv.bat file to set the correct EAServer path.

  2. Copy the subdirectories and files listed in Table 4-5 from the EAServer host to the Web server host, maintaining the directory structure:

    Table 4-5: Subdirectories and files to copy from EAServer to Web server host

    Root directory

    Subdirectories and files to copy

    $JAGUAR

    • db/*

    • bin/setenv.sh

    • bin/sasecmgr

    • easmgr/*

    • java/lib/easclient.jar

    • java/lib/easj2ee.jar

    • java/classes/easri.jar

    • jdk/jdk1.3

    $JAGUAR/lib or $JAGUAR/devlib

    • libjcc.sl

    • libjcomm_r.sl

    • libjctssecct.sl

    • libjinsck_r.sl

    • libjintl_r.sl

    • libjspks_r.sl

    • libsybcki_r.sl

    • libjsybscl_r.sl

    • libjtcl_r.sl

    • libjtml_r.sl

    • libjutils.sl

    NoteFor production, copy libraries from the $JAGUAR /lib directory. The libraries in $JAGUAR/devlib are for debugging only.

  3. Copy Apache-specific files. Whether or not you are running an Extended API (EAPI) version of the Apache Web server determines which libraries you need to copy from the $JAGUAR/lib or devlib directory to the location the Web server normally searches for files. To determine which version of the Apache Web server is running, enter the httpd -V command. If the output from this command contains “-D EAPI,” you have an EAPI version of Apache and must copy and use the appropriate files:

    • Files required for EAPI versions of the Apache Web server:

      libjeaseapi_mod.sl

      libjeasproxyeapi_mod.sl

    • Files required for non-EAPI versions of the Apache Web server:

      libjeas_mod.sl (for Apache version 1.3.26) or libjeas2_mod.sl (for Apache version 2.0)

      libjeasproxy_mod.sl

    In addition, for EAPI versions of Apache, modify the LoadModule directive in the httpd.conf file as follows:

    Apache 1.3.26:

    LoadModule easredirector_module libexec/libjeaseapi_mod.sl
    

    Apache 2.0:

    LoadModule easredirector_module lib/libjeas2eapi_mod.sl
    

    If you do not set this directive, the redirector may not run, and you may see a warning similar to this on the screen and in the connector log file:

    [warn] Loaded DSO libexec/libjeas_mod.sl uses plain Apache API, this module might crash under EAPI! (please recompile it with -DEAPI)
    
  4. Copy iPlanet 4.x-specific files. Copy the following file from the $JAGUAR/lib or devlib directory to the location the Web server normally searches for files:

    libjeas_httpd40.sl

  5. Copy Sun Java System-specific files. Copy the following file from the $JAGUAR/lib or devlib directory to the location the Web server normally searches for files:

    libjeas_httpd40.sl

  6. Append $JAGUAR_CLIENT_ROOT/lib to the LD_LIBRARY_PATH environment variable.

See “Enable HTTPS connections” to enable your Web server redirector to establish HTTPS connections with EAServer.