Enabling the ASAPI Web Connector

Before configuring Apache to use the ASAPI Web Connector, ensure that your version of Apache supports DSOs. Then follow the procedure for enabling the Web Connector by including the asapi.conf file in your web server's httpd.conf file. The asapi.conf file was generated when you installed the Web Connector; it is located in the crystal/enterprise/PLATFORM_PATH/wcs/conf directory of your Web Connector installation.

To confirm that your web server supports DSOs

Enter the following command:

httpd -l

Note:    The parameter provided above is a lower-case L.

The module, indicated by mod_so, should appear in the list. For example:

{machinename@crunch bin}$ httpd -l
Compiled-in modules:
http_core.c
mod_so.c

If you do not see mod_so.c listed as one of the built-in modules, you will have to recompile your Apache server before enabling the Web Connector.

To recompile your Apache server with DSO support

From within the Apache source tree, rerun the configure script adding mod_so to the list of modules you enable. For example:

./configure --enable-module=so...

On Solaris you also need to enable the shared-core option:

./configure --enable-module=so --enable-rule=SHARED_CORE

For complete details, consult your Apache documentation.

To enable the ASAPI Web Connector

1. On the web server machine, open the Apache httpd.conf file in a text editor such as vi.
2. Add the following line to the file:

   Include INSTALL_ROOT/crystal/enterprise/PLATFORM_PATH/wcs/conf/asapi.conf

   Note:    For additional details on the configuration directives used in the asapi.conf file, see ASAPI Web Connector configuration directives.

3. Restart the Apache daemon using the command appropriate to the version that you are running.
4. Connect to Crystal Enterprise by opening your web browser and going to:

   http://webserver/crystal/enterprise/

   Here, the term webserver represents the name of the web server machine.

   Note:    If mod_wcs.so does not match your version of Apache, you will see the following error message when you attempt to restart the server.

   "API module structure 'wcs_connector_module' in file mod_wcs.so is garbled - perhaps this is not an Apache module DSO?"

   Crystal Enterprise supports the AP13 Apache API.