Configuring other supported CGI web servers

The CGI Web Connector allows you to connect Crystal Enterprise to web servers that support the Common Gateway Interface (CGI). Depending upon your web server, you typically configure CGI applications in one of two ways: either you specify a particular directory (the cgi-bin) as one that allows programs to execute commands or scripts, or you specify certain file types that are globally executable, regardless of the directory in which they are located. The default web applications provided with Crystal Enterprise—the Crystal Enterprise web desktop and the Crystal Management Console (CMC)—require the latter method.

In Crystal Enterprise, the actual CGI Web Connector program is wcscgi.cgi (also provided as wcscgi.exe on Windows). The program handles requests for .csp, .cwr, and .cri files. Consult your web server documentation to see how to specify certain file types as being globally executable by a particular interpreter; then associate all .csp, .cwr, and .cri files with the wcscgi.cgi script.

The Crystal Enterprise web desktop and the CMC do not contain all .csp, .cwr, and .cri files to a single cgi-bin directory. Therefore, these default applications will not function properly if your web server requires you to specify executable files by directory. In such cases, however, you can still deploy your own web applications that reference .csp scripts from the cgi-bin, so long as you map the Crystal Enterprise file types in the cgi-bin to the wcscgi.cgi script.

The CGI Web Connector is provided for use with web servers that support the CGI standard. The CGI connector obtains configuration information through environment variables. During installation, the setup script customizes the wcscgi.cgi script for your installation and saves the file in the following directory of your Web Connector installation:

C:\Program Files\Crystal Decisions\Enterprise 10\win32_x86

This script sets up the environment variables and the library path and executes the connector binary.

To configure the CGI Web Connector on Windows

1. Stop your web server.
2. If you do not already have a cgi-bin virtual directory set up on your web server, create one and map it to the actual directory where the wcscgi.cgi and wcscgi.exe files were installed (the default is C:\Program Files\Crystal Decisions\Enterprise 10\win32_x86).

   Note:    If you already have a cgi-bin virtual directory set up on your web server, or if your web server restricts your ability to map the cgi-bin to the actual win32_x86 directory, copy the wcscgi.cgi and wcscgi.exe files into the actual directory that is already mapped to the cgi-bin.

3. If you created a new cgi-bin virtual directory, ensure that it is marked as executable on the web server. You should also check that your file and directory permissions allow the wcscgi.cgi file to be executed when users make requests to the web server.
4. Configure the following virtual directories on your web server:
   • /crystal must be mapped to C:\Program Files\Crystal Decisions\Enterprise 10\Web Content
   • /viewer must be mapped to C:\Program Files\Common Files\Crystal Decisions\2.5\crystalreportviewers10
   • /crystalreportviewers10 must be mapped to C:\Program Files\Common Files\Crystal Decisions\2.5\crystalreportviewers10
5. Restart your web server.
6. Ensure that the Crystal Enterprise servers are started and enabled.
7. Depending upon your web server configuration, you may not be able to access Crystal Enterprise and the Crystal Management Console from the links on the Crystal Enterprise Launchpads. For more information, see Using Crystal Enterprise and the CMC with CGI.

Note:    If you performed the full stand-alone installation, no additional configuration is required. If you installed the Web Connector and the Web Component Server (WCS) on different machines, you must provide the Web Connector with information about the remote WCS. For details, see Configuring the Web Connector for a remote WCS.