Apache (ASAPI Web Connector)

If you are using Apache with the ASAPI Web Connector, the virtual path mapping is made in the asapi.conf file (so long as you used the Include command in your httpd.conf file to reference the Crystal Enterprise asapi.conf file, as outlined in Enabling the ASAPI Web Connector).

The relevant lines are as follows:

• WCSHosts WCSLIST

  This line defines the Web Component Server(s) that the ASAPI module must communicate with. WCSLIST is a list of one or more WCS hosts, specified as machinename:portnumber (separate multiple entries with spaces).

  Note:    There can be only one WCSHosts directive per virtual server.

• AddPathMap /crystal csp "webcontent"

  This line defines how the ASAPI module translates file paths for each Crystal Server Page (.csp file) 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

• AddPathMap /crystalreportviewers10 csp "viewers"

  This line defines how the ASAPI module 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/crystalreportviewers 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

Note:    Additional Path Mapping configuration can be done through the AddPathMap directive. There can be many AddPathMap directives in your Apache configuration. These must be separated by a space (rather than by a semicolon in the case of CGI).

You must instruct Apache to reinitialize its child worker processes after you modify WCSHosts entries in the Web Connector configuration files. You can generally do this with one of the following commands:

kill -HUP `cat <absolute path to httpd.pid file>`
kill -USR1 `cat <absolute path to httpd.pid file>`

Consult the Apache documentation for more information.