Configure Apache HTTP Server Version 2.2 Using mod_jk (IPv4 Only)

Note: This section applies to IPv4 only.

Note: We recommend that you use mod_proxy, which is bundled with Apache and uses HTTP protocol for communication between PPM and Apache. For details, see Configure Apache HTTP Server version 2.2 or 2.4 using mod_proxy.

This section provides the procedure for configuring Apache HTTP Server Version 2.2 using mod_jk to work with OpenText PPM.

To configure Apache 2.2 using mod_jk for OpenText PPM:

  1. Go to <PPM_Home>/integration/webserverplugins/apache-2.2/Windows/x86-32, and then copy the mod_jk.so file to the Apache module directory (usually <Apache_Home>/modules).

    Note: The Jakarta Tomcat Connector (mod_jk) is used to connect Apache Web Server and OpenText PPM. The Ajp13 protocol keeps an open socket and controls the communications between OpenText PPM (its built-in Tomcat component) and Apache.

  2. Instruct Apache to load the Jakarta Tomcat Connector (mod_jk). You can use the Apache LoadModule configuration directives in the httpd.conf file, which is located in <Apache_Home>/conf (where <Apache_Home> is the Apache installation directory).

  3. LoadModule jk_module <Relative_Modules_Path>/mod_jk.so 
    JkWorkersFile <Relative_Conf_Path>/workers.properties 
    JkMountFile <Relative_Conf_Path>/uriworkermap.properties 
    JkLogFile <Relative_Logs_Path>/jk.log
    JKLogLevel ERROR

    Caution: If you plan to enable SSL on Apache, then you must also do the following:

    Add the JkMountCopy On to the virtual host directive in the httpd-ssl.conf file.

  4. Check to make sure that include conf/extra/httpd-ssl.conf is not commented out in the httpd.conf file.

  5. Go to the <PPM_Home>/integration/webserverplugins/configuration directory, and then copy the workers.properties and uriworkermap.properties to the Apache configuration directory (usually <Apache_Home>/conf).

  6. Configure the workers.properties file. (For detailed information and instructions, see Configure the Workers Properties file.)

  7. Configure the uriworkermap.properties file to specify mappings between a given URL (or URL pattern) and worker name. (For detailed information and instructions, see Configure the uriworkermap.properties File on Microsoft IIS and Apache-Based Servers.

    Note: Make sure that the name of the worker mapped to /itg/* pattern in the uriworkermap.properties file matches the name of the worker defined in the workers.properties file. This worker must also be listed in the worker.list directive of the workers.properties file.

  8. Restart your Apache HTTP Server 2.2 and check to see whether your configuration works.