Any web server with the CGI Web Connector

If you are using the CGI Web Connector, the virtual path mapping is made in the wcscgi.cgi script, regardless of the type of web server you are running.

First, ensure that the following line appears in the wcscgi.cgi script:

WCSHOST1=machinename:portnumber; export WCSHOST1;

This line sets the WCSHOST1 environment variable, which specifies the host machine that is running the Web Component Server (WCS). Replace machinename with the fully qualified domain name (or IP address) of the machine that is running the WCS. Replace portnumber with the port that the WCS is listening on (by default, this is port 6401). You may specify additional WCS machines by defining similar environment variables with names WCSHOST2, WCSHOST3, and so on.

Second, ensure that the following line appears in the wcscgi.cgi script:

WCSPATHMAP1="/crystal;csp;WCS_INSTALL_ROOT/webcontent"; export WCSPATHMAP1

This line defines how the CGI Web Connector handles a request for a Crystal Server Page (.csp files). Any .csp request made to http://webserver/crystal must be mapped relative to the webcontent directory on the WCS. The virtual directory on the web server is specified first (/crystal); the file extension is specified second (csp); and the absolute path of the Crystal Enterprise web content directory on the Web Component Server is specified last (WCS_INSTALL_ROOT/webcontent).

To map different paths or different file extensions, add a new environment variable with the prefix "WCSPATHMAP". For instance, to make unmanaged Crystal reports available on your web site, you would add a line similar to this:

WCSPATHMAP2="/crystal;rpt;WCS_INSTALL_ROOT/webcontent"; export WCSPATHMAP2