Installation and Upgrade Guides › Web Agent Installation Guide › Password Services › How to Configure the ServletExec Servlet Engine for JSP Password Services on a Sun Java System Web Server in the UNIX Operating Environment

How to Configure the ServletExec Servlet Engine for JSP Password Services on a Sun Java System Web Server in the UNIX Operating Environment

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

1. Use the Sun Java System 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 Web Agent is installed.

        Default (Windows installations): C:\Program Files\CA\webagent

        Default (UNIX installations): /opt/ca/webagent

   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 Sun Java System 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 Sun Java System server instance 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 Sun Java System 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 Sun Java System web server, and then start the ServletExec Servlet engine.