Enabling the CGI Web Connector for Apache

This section shows how to configure Apache to use the CGI Web Connector. This configuration consists of including the cgi.apache.conf file in your web server's httpd.conf file. The cgi.apache.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.

The configuration directives within the cgi.asapi.conf file ensure that Apache passes Crystal Enterprise scripting requests to the Web Connector. Additional directives set the ExecCGI option on the appropriate Crystal Enterprise directories and map the various virtual directories to the actual directories on the web server.

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 enable the CGI Web Connector for Apache

1. On the web server machine, open the Apache httpd.conf file in a text editor such as vi.
2. Add the following line to the file:

   Include /crystal_root/enterprise/platform/wcs/conf/cgi.apache.conf

   The cgi.apache.conf file uses the Alias directives, which are valid only if the mod_alias module is enabled on your installation of Apache. (This module is typically enabled at runtime, in the httpd.conf file.)

3. Restart the Apache daemon using the command appropriate to the version that you are running.
4. Connect to Crystal Enterprise 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 Troubleshooting path mappings.