Enabling the CGI Web Connector for iPlanet

This section shows how to configure iPlanet Enterprise Server to use the CGI Web Connector. This configuration consists of copying the contents of the cgi.netscape.conf file into the appropriate web server configuration files. The cgi.netscape.conf file was generated when you installed the Web Connector; it is located in the crystal/enterprise/PLATFORM_PATH/wcs/conf directory of your Web Connector installation.

Note:    The iPlanet configuration files are usually located in the servers/https-servername/config directory of your iPlanet installation. Here, https-servername represents the name of the web server that you want to configure for use with Crystal Enterprise. The relevant iPlanet files differ, depending upon which version of iPlanet Enterprise Server you are running.

For more information about the CGI binary itself (wcscgi.bin), and the environment variables that are defined in its configuration script (wcscgi.cgi), see Configuring other CGI web servers.

To configure the CGI Web Connector for iPlanet

1. On the web server machine, open the cgi.netscape.conf file from the crystal/enterprise/PLATFORM_PATH/wcs/conf directory of your Web Connector installation.

   Note the following type lines:

   #Add these lines to your mime.types file
   

   type=magnus-internal/csp exts=csp
   

   type=magnus-internal/cri exts=cri
   

   type=magnus-internal/cwr exts=cwr
   

   type=magnus-internal/rpt exts=rpt
   

2. Add these type lines to the bottom of the iPlanet mime.types file.
3. Ensure that the appropriate iPlanet configuration file contains the line:

   Init fn="load-types" mime-types="mime.types"

   Note:    If you are running iPlanet Enterprise Server version 6.x, this line must appear in the magnus.conf file. If you are running iPlanet Enterprise Server version 4.1, this line must appear in the obj.conf file.

4. Return to the cgi.netscape.conf file and note the customized NameTrans lines that correspond to the following template:

   # Directory alias for Crystal web content
   

   NameTrans fn="pfx2dir" from="/viewer" dir="INSTALL_ROOT/viewers"
   

   NameTrans fn="pfx2dir" from="/crystal" dir="INSTALL_ROOT/webcontent"
   

5. Add the NameTrans lines to the <Object name="default"> section of the iPlanet obj.conf file. Be sure to add these lines before the NameTrans fn="document-root" line.
6. Return to the cgi.netscape.conf file and note the Service lines:

   # Set the CGI handler for our mime types
   

   Service fn=query-handler path="INSTALL_ROOT/enterprise/PLATFORM_PATH/wcs/bin/wcscgi.cgi" type="magnus-internal/csp"
   

   Service fn=query-handler path="INSTALL_ROOT/enterprise/PLATFORM_PATH/wcs/bin/wcscgi.cgi" type="magnus-internal/cri"
   

   Service fn=query-handler path="INSTALL_ROOT/enterprise/PLATFORM_PATH/wcs/bin/wcscgi.cgi" type="magnus-internal/cwr"
   

   Service fn=query-handler path="INSTALL_ROOT/enterprise/PLATFORM_PATH/wcs/bin/wcscgi.cgi" type="magnus-internal/rpt"
   

7. Add the Service lines to the <Object name="default"> section of the iPlanet obj.conf file, after any existing Service lines.
8. Restart your iPlanet Enterprise Server.
9. Connect to Crystal Enterprise by opening your web browser and going to:

   http://webserver/crystal/enterprise/

   Here, the term webserver represents the name of the web server machine. If you are unable to use the links on the Crystal Enterprise Launchpad, see Using ePortfolio and the CMC with CGI.