Share this page

# Configure the Sun Java System web server

To configure the Sun Java System Web Server to run as the external Web server for the PPM Server:

1. Connect to the Sun Java System administration server and create a new server named "PPM".

   This creates the `https-PPM` directory. The `https-PPM` directory contains two files: `magnus.conf` and `obj.conf.`

2. Stop the PPM Server. (For instructions, see Start and stop the PPM Server on a single-server system.)

3. Place the configured `workers.properties` file (see Configure the Workers Properties file) in the `<Sun_Home>/https-<Web_Server_Name>/config` directory.

4. Copy the `nsapi_redirector.so` plug-in to any directory on the machine that runs the Sun Java System Web Server.

   The Web server must have permissions to read and execute this file.

5. Add the following two lines to the `magnus.conf` file (the text can wrap, but each "`init fn=`" must be a continuous line with no spaces):

       Init fn="load-modules" shlib="<Path_To_NSAPI_Redirector>/nsapi_redirector.so" funcs="jk_init,jk_service"

       Init fn="jk_init" worker_file="<Sun_Home>/https-<Web_Server_Name>/config/workers.properties" log_level="error" log_file=<Path_To_Log_Files>/ppm_server.log

6. If you are using the 64-bit version of Sun Java System Web Server, do the following:

   1. Set the LD_LIBRARY_PATH_64 environment variable to
      `/usr/local/lib/sparcv9`.

   2. Navigate to the `/webserver/config` directory, open the `magnus.conf` file, and then add the following lines to the file:

          Init fn="load-modules" shlib="/sun/webserver7/https-https-ppm1/config/nsapi_redirector.so" funcs="jk_init,jk_service"

          Init fn="jk_init" worker_file="<Sun_Home>/https-<Web_Server_Name>/config/workers.properties" log_level="debug" log_file="/sun/webserver7/https-https-ppm1/logs/itg_server.log" shm_file="/sun/webserver7/https-https-ppm1/logs/jk_shm"

7. In the `obj.conf` file, do the following:

   1. Add the following line at the beginning of the "Object" section (that is, after `<object name=default>`).

          NameTrans fn="assign-name" from="/itg/*" name=<PPM_Servlet>

          NameTrans fn="assign-name" from="/dashboard/*" name=<PPM_Servlet>

   2. Place the following text after the `</Object>` section:

          <Object name="ppm_servlet">

          Service fn="jk_service" worker=<Load_Balancer>

          </Object>

      The `<PPM_Servlet>` strings must match.

   Note: The `worker` attribute specifies the name of the JK worker used to serve requests with URLs that match the `path` attribute, which is `/itg/*` in this case.

   Caution: Check the start and end of each line in the `magnus.conf` and `obj.conf` files to make sure that there are no extra spaces in either of these files.

8. Enable content compression.

   For information on how to enable dynamic content compression, see Enable dynamic compression on an external web server.

(Optional) Enable Cookie Logging on the Sun Java System Web Server

1. Stop the Sun Java System Web Server.

2. In the `magnus.conf` file, find the line that initializes flex. The line begins with the following text.

       Init fn=flex-init

3. Append the following string to the end of this line:

       %Req->headers.cookie.JSESSIONID%

   The resulting modified line is:

       Init fn=flex-init access="$accesslog" format.access=

       "%Ses->client.ip% - %Req->vars.auth-user%[%SYSDATE%]

       \"%Req->reqpb.clf-request%\" %Req->srvhdrs.clf-status%

       %Req->srvhdrs.content-length%"

       JSESSIONID=%Req->headers.cookie.JSESSIONID%

4. Restart the Web server.

1. Stop the Sun Java System Web Server.

2. In the `magnus.conf` file, find the line that initializes flex. The line begins with the following text.

       Init fn=flex-init

3. Append the following string to the end of this line:

       %Req->headers.cookie.JSESSIONID%

   The resulting modified line is:

       Init fn=flex-init access="$accesslog" format.access=

       "%Ses->client.ip% - %Req->vars.auth-user%[%SYSDATE%]

       \"%Req->reqpb.clf-request%\" %Req->srvhdrs.clf-status%

       %Req->srvhdrs.content-length%"

       JSESSIONID=%Req->headers.cookie.JSESSIONID%

4. Restart the Web server.

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: