Enabling the CGI Web Connector for iPlanet on UNIX

This section shows how to configure iPlanet Enterprise Server on UNIX 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/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 supported 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/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
   

2. Add these type lines to the bottom of the iPlanet mime.types file.
3. Ensure that the magnus.conf file (for iPlanet 6) or init.conf file (for iPlanet 7) contains the line:

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

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

   # Add to NameTrans part
   

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

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

   NameTrans fn=pfx2dir from=/crystalreportviewers10 dir="/crystal_root/viewers"
   

   These lines map the web server virtual directories.

5. Add the NameTrans lines to the <Object name="default"> section of the iPlanet obj.conf file (for iPlanet 6) or servername-obj.conf (for iPlanet 7, where servername is the name that you gave to the server instance you created when you configured iPlanet 7).

   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="/crystal_root/enterprise/platform/wcs/bin/wcscgi.cgi" type="magnus-internal/csp"
   

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

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

   These lines map Crystal file types to the CGI Web Connector.

7. Add the Service lines to the <Object name="default"> section of the iPlanet obj.conf file (for iPlanet 6) or servername-obj.conf (for iPlanet 7) after any existing Service lines.
8. Restart your iPlanet Enterprise Server.
9. Connect to the Crystal Enterprise User Launchpad by opening your web browser and going to:

   http://webserver/crystal/enterprise10/

   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 Crystal Enterprise and the CMC with CGI.