CSP Gateway Configuration Guide - InterSystems Documentation

Atypical Configurations for UNIX®, Linux, and Mac OS X
B.2.2 Atypical Option 1: Apache API Module with NSD (mod_csp22.so)
If the CSP module is supplied with your distribution as a pre-built shared object (mod_csp22.so or mod_csp2.so), then
proceed to the section on configuration. To build the shared object from the supplied source file mod_csp.c choose Method
1 or Method 2 below. Method 1 is preferred.
Use module mod_csp22.so for Apache Version 2.2.x and mod_csp2.so for Apache Version 2.0.x.
Be sure to read the following instructions regarding the creation of shared objects in conjunction with the specific documentation
contained within your Apache distribution. Note that the instructions given here assume that the root directory for
the Apache installation is apache. In practice, this directory name usually has the Apache version number appended to it.
The module source file supplied (mod_csp.c) is fully compliant with both Apache v2.2.x and Apache V2.0.x.
B.2.2.1 Method 1: Building the CSP Module as Shared Object with apxs (APache eXtenSion) Tool
The following command builds and installs the shared library, mod_csp.so, in the Apache /modules directory using the
Apache extension tool, apxs. It also adds a directive to load the module to the Apache configuration file /conf/httpd.conf.
apxs -I -a –c mod_csp.c
To be consistent with the instructions in this document you may want to rename this module mod_csp2.so for Apache
Version 2.0.x.
Alternatively, mod_csp2.so may be built directly as follows:
apxs –c –o mod_csp2.so mod_csp.c
Install the shared-object produced binary in the following directory: /opt/cspgateway/csp/bin.
B.2.2.2 Method 2: Building the CSP Module as Shared Object Manually
Perform the following steps to manually build the CSP module as a shared object:
1. Install the module source file mod_csp.c in the following directory: /usr/apache/src/modules/extra
2. Return to the /usr/apache/src directory and edit the Configuration file. Near the end of this file, locate the following
line:
# AddModule modules/example/mod_example.o
After this line, add the following line:
ShareModule modules/extra/mod_csp.so
3. Configure the build process using the following command:
./Configure
4. Build the shared object using the following command:
make
5. This produces the shared object mod_csp.so in directory: /usr/apache/src/modules/extra.
To be consistent with the instructions in this document you may want to rename this module as mod_csp2.so for Apache
Version 2.0.x and mod_csp22.so for Apache Version 2.2.x. This guide also uses /opt/cspgateway/csp/bin as the default
install directory for this module.
126 CSP Gateway Configuration Guide