Previous Topic: How to Configure the ServletExec Servlet Engine for JSP Password Services for an IIS Web Server

Next Topic: Uninstall a Web Agent

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.


Copyright © 2010 CA. All rights reserved. Email CA about this topic