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

Note: This section applies to IPv4 only.

Note: The configuration steps provided here for Apache HTTP Server version 2.4 were tested on Linux, but it should work on Windows as well.

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

To configure Apache 2.2 or 2.4 using mod_jk for PPM:

  1. Navigate to <PPM_Home>/integration/webserverplugins/apache-2.2/Windows/x86-32 or <PPM_Home>/integration/webserverplugins/apache-2.4/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 PPM. The Ajp13 protocol keeps an open socket and controls the communications between 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. Check to make sure that include conf/extra/httpd-ssl.conf is not commented out in the httpd.conf file.

  4. Navigate 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).

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

  6. Configure the uriworkermap.properties file to specify mappings between a given URL (or URL pattern) and worker name. (For detailed information and instructions, see Configuring 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.

  7. Restart your Apache HTTP Server 2.2 or 2.4 and check to see whether your configuration works.