Running ActiveGrid Server under the IBM HTTP Server

Running ActiveGrid Server under the IBM HTTP Server
The ActiveGrid Server has been tested to work under the IBM HTTP Server 6.0.2.3. This means that instead of using the Apache Server that ships with ActiveGrid Server, we enable ActiveGrid’s runtime and server features to run natively in the IBM Server. This appendix explains how to set up this configuration. It contains the following sections:
Configuring the Server
To run the ActiveGrid Server on the IBM HTTP Server follow these steps:
1.
Add the following line to the end of the IBM HTTP Server's httpd.conf file (IBMIHS_INSTALL_DIR/conf/httpd.conf):
Include AG_SERVER_INSTALL_DIR/local/conf/activegrid.conf
2.
Edit the IBM HTTP Server's envvars file (IBMIHS_INSTALL_DIR/bin/envvars) as follows:
Edit the LD_LIBRARY_PATH line to add a reference to ActiveGrid Server’s common/lib directory. Put this reference in front of the entry for IBM’s lib directory:
LD_LIBRARY_PATH="AG_SERVER_INSTALL_DIR/3rdparty/common/lib:IBMIHS_INSTALL_DIR/lib:$LD_LIBRARY_PATH"
export LD_LIBRARY_PATH
Set the PYTHONHOME variable to the Python contained in the ActiveGrid Server installation:
PYTHONHOME=AG_SERVER_INSTALL_DIR/3rdparty/python
export PYTHONHOME
3.
Remove or rename the version of libgcc_s.so.1 that was included in the ActiveGrid installation. The libgcc_s.so library included with ActiveGrid Server conflicts with the version that the IBM HTTP Server expects.
cd AG_SERVER_INSTALL_DIR/3rdparty/common/lib
mv libgcc_s.so.1 libgcc_s.so.1.bak
Starting and Stopping the Server
To start the server, type:
IBMIHS_INSTALL_DIR/apachectl start
To stop the server, type:
IBMIHS_INSTALL_DIR/apachectl stop
Enabling Distributed Sessions
This step is necessary only if you are planning to use ActiveGrid’s distributed session feature. In the httpd.conf file, add the ServerName directive to specify the machine’s hostname and port:
ServerName HOSTNAME:PORT
Working with Existing mod_python Applications
The ActiveGrid Server requires ActiveGrid’s own version of mod_python. If you already have mod_python installed on the IBM HTTP Server, you must remove it from the Apache configuration.
If you have existing mod_python based applications, configure them to run under ActiveGrid’s version of mod_python. If your applications require third-party Python libraries, then you might need to install these directly into the Python library directory. Python is located in INSTALL_DIR/3rdparty/python.
 

ActiveGrid
Installation and Deployment Guide
Version 2.0