Supported web servers 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.

The relevant lines in the wcscgi.cgi script are as follows:

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 if you are load-balancing over two Web Component Servers, for example.

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

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

  This line defines how the CGI Web Connector handles a request for a Crystal Server Page (.csp files) that is requested from the /crystal virtual directory structure on the web server. Any .csp request made to http://webserver/crystal must be mapped relative to the web content 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 (webcontent).

  The default webcontent value is:

  C:\Program Files\Crystal Decisions\Enterprise 10\Web Content

• WCSPATHMAP2="/crystalreportviewers10;csp;viewers"; export WCSPATHMAP2

  This line defines how the CGI Web Connector translates file paths for each Crystal Server Page (.csp file) that is requested from the /crystalreportviewers10 virtual directory structure on the web server.

  Any .csp request made to http://webserver/crystalreportviewers10 must be mapped relative to the viewers directory on the WCS. The virtual directory on the web server is specified first (/crystalreportviewers10); the file extension is specified second (csp); and the absolute path of the viewers directory on the Web Component Server is specified last (viewers).

  The default viewers value is:

C:\Program Files\Common Files\Crystal Decisions\2.5\crystalreportviewers10

To map different paths or different file extensions, add a new environment variable with the prefix "WCSPATHMAP".