HTTPS installation instructions

This section describes installation requirements for Web servers hosted on a AIX machine, including environment variable settings and which files to copy from an 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 file to set the correct EAServer path.

  2. Copy all of the files for your Web server from the EAServer host to the Web server host described in “Copy libraries from EAServer to your Web server”. 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.so.a

    • libjctssecct.so

    • libjsybscl_r.so.a

    • libjspks_r.so.a

    • libjintl_r.so.a

    • libjsybcki_r.so.a

    • libjinsck_r.so.a

    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 of this command contains the line -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.so

      libjeasproxyeapi_mod.so

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

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

      libjeasproxy_mod.so

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

    LoadModule easredirector_module libexec/libjeaseapi_mod.so
    

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

    [warn] Loaded DSO libexec/libjeas_mod.so uses plain Apache 1.3 API, this module might crash under EAPI! (please recompile it with -DEAPI) [Thu Sep 26 11:27:53 2002] [notice] [pid 12702] read_external_config:using configuration file:[/apache1326/conf/conn_config] 
    
  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.so.a

  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.so.a

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

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