Share this page

# 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. Add the following lines of text to the `httpd.conf` file:

       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.

https://admhelp.microfocus.com PPM 8942
Tips to improve your search results... OpenText™ Project and Portfolio Management Help Center PPM Help 26.2-26.3 All View Local Help Center View Online Help Center Version: