Configuring 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

    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"

    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.

  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.