ASAPI Web Connector configuration directives

This section provides additional details on some of the directives found in the asapi.conf file.

Apache takes its configuration information from Apache configuration directives, which are typically found in the httpd.conf file. During installation, the Crystal Enterprise setup.sh script creates a file called crystal/enterprise/PLATFORM_PATH/wcs/conf/asapi.conf, which contains custom Apache configuration directives for the ASAPI Web Connector. Use the Include command to include this file in your Apache httpd.conf file. This ensures that Apache loads the ASAPI Web Connector configuration automatically at startup. For procedural details on including this file in the Apache httpd.conf file, see Enabling the ASAPI Web Connector.

For security reasons, these custom directives are only accessible from within the server's .conf files. This prevents a user from re-directing the ASAPI Web Connector through an .htaccess file or other files defined by the AccessFileName directive.

The WCSHosts directive indicates the list of WCS hosts to connect to. The WCSHosts directive should be followed by the full list of WCS hosts, and there should be only one WCSHosts directive per virtual server. For example:

# WCS hosts to connect to, in order of priority
WCSHosts machinename:port machinename:port

The Alias directives define the virtual directories that allow your web server to serve up Crystal Enterprise web content.

# Alias the crystal and viewer directories
Alias /crystal /INSTALL_ROOT/crystal/webcontent
Alias /viewer /INSTALL_ROOT/crystal/viewers

Note:    Alias directives 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.)

Additional Path Mapping configuration can be done through the AddPathMap directive. There can be many AddPathMap directives in your Apache configuration. The AddPathMap directive takes three arguments: the URL prefix you wish to map, the file extension to map, and the Windows path to map to. These must be separated by a space (rather than by a semicolon in the case of CGI). For example, this entry would map a virtual directory on the web server to a Windows machine:

# Path Mapping
AddPathMap /crystal csp "C:\Program Files\Crystal Decisions\Web Content"

The ASAPI connector contains a third directive, which performs the same function as the LD_LIBRARY_PATH directive in the CGI wcscgi.cgi file. It is the CrystalSharedDir directive and should point to the lib directory in your installation. The setup.sh script should have set this up for you in the asapi.conf file.

# Install Directory 
CrystalSharedDir /usr/local/crystal/lib