Installation and Upgrade Guides › Web Agent Installation Guide › Password Services › How to Configure the ServletExec Servlet Engine for JSP Password Services on an Oracle iPlanet Web Server in the UNIX Operating Environment

How to Configure the ServletExec Servlet Engine for JSP Password Services on an Oracle iPlanet Web Server in the UNIX Operating Environment

To configure the ServletExec Servlet Engine for JSP Password Services on a Oracle iPlanet Web server in the UNIX operating environment, use the following process:

1. Use the Oracle iPlanet Web server to make the following changes to the web server instance on which your SiteMinder Web Agent runs:
   1. Add the following legacy servlet attributes:
      • Servlet Name: PSWDChangeServlet
      • Servlet Code: PSWDChangeServletServlet
      • Classpath: web_agent_home/jpw/jpw.jar

      web_agent_home

      Indicates the directory where the SiteMinder Agent is installed.

      Default (Windows 32-bit installations of SiteMinder Web Agents only): C:\Program Files\netegrity\webagent

      Default (UNIX/Linux installations): user_home_directory/netegrity/webagent

      Default (Windows 64-bit installations [SiteMinder Web Agents for IIS only]): C:\Program Files\netegrity\webagent\win64

      Default (Windows 32-bit applications operating on 64-bit systems [Wow64 with SiteMinder Web Agents for IIS only]): C:\Program Files\netegrity\webagent\win32

   2. Add the following virtual path to the Servlet Virtual Path Translation of the Legacy Servlets:

      /siteminderagent/pwservlet/PSWDChangeServlet and Servlet Name: PSWDChangeServlet
      

   3. Disable the Oracle iPlanet servlet engine.
2. Install the ServletExec ASAPI software.
3. Use a text editor to update the ServletExec_installation_directory/se-instance_name/StartServletExec file with the following modifications:
   1. Find PORT="8888", and change the port of communication with web server to any free port (for example, PORT="7777").
   2. Extend the CLASSPATH definition by adding the following entries to the end of the CLASSPATH:

      web_agent_home/jpw/jpw.jar

      web_agent_home/java/jsafe.jar

   3. Extend the document directories definition by adding the directory entries after the following line:

      $SENAME $HOMEDIR $MIMEFILE $DOCROOTDIR -port $PORT $SEOPTS -addl "/siteminderagent/jpw=web_agent_home/jpw""

      Note: There are two quotation marks at the end of the entry.

4. Start the ServletExec Servlet engine, and then use its Administrative interface to do the following:

   Note: You can access the ServletExec documentation on the New Atlanta Web site.

   1. Add the following servlets:
      • Servlet Name: PSWDChangeServlet
      • Servlet Class: PSWDChangeServlet
   2. Add the following Servlet Alias:
      • alias: /siteminderagent/pwservlet/PSWDChangeServlet
      • Servlet Name: PSWDChangeServlet
5. Make the following changes to the magnus.conf file of the Oracle iPlanet web server on which your Web Agent runs:
   1. For the following line, change the IP address and port number to match the address for the Agent system that you already defined:

      Init fn="ServletExecInit" instance_name.instances="IP_address:7777"
      

6. Add the following entry to the obj.conf file the Oracle iPlanet server instance on which your Web Agent runs:

   NameTrans fn="assign-name" from="/siteminderagent/pwservlet/PSWDChangeServlet" name="instance_name"
   

   Insert the entry into the following block:

   <Object name="default">
   

   AuthTrans fn="SiteMinderAgent"
   

   NameTrans fn="assign-name" from="/servlet/*" name="instance_name"
   

   NameTrans fn="assign-name" from="/siteminderagent/pwservlet/PSWDChangeServlet"
   

   name="instance_name"
   

   -----
   

   -----
   

   </Object>
   

7. Restart the Oracle iPlanet web server, and then start the ServletExec Servlet engine.