Apache Requester Installation and Configuration (Magic xpa 3.x)

Apache Module Requester Setup

Magic xpa 3.1 includes requesters for the Apache Web Server version 2.2 and version 2.4. The requester module mod_V2.2_mgrequest031.so should be placed in the modules directory of the Apache installation (default: /usr/local/httpd/modules) with execute permissions.

The installation includes the following requesters:

• mod_V2.2_mgrequest031.so – to be used with Apache 2.2

• mod_V2.4_mgrequest031.so – to be used with Apache 2.4
  

1. Add the following lines to the Apache configuration file, httpd.conf.

LoadModule mgrequest031_module

modules/mod_V2.2_mgrequest031.so

<Location /mgrequest031>

SetHandler mgrequest031-handler

</Location>

SetEnv MGREQ_INI_PATH <directory>

2. For AIX: Add the $MAGIC_HOME/lib to the $LIBPATH environment variable.
   
   For Linux and Solaris: Add the $MAGIC_HOME/lib to the $LD_LIBRARY_PATH environment variable.

3. Restart the Apache Web server.

The Apache requester is configured using the MGREQ.INI file. The directory location of the MGREQ.INI file is specified by the MGREQ_INI_PATH setting in the Apache configuration file, httpd.conf.

Example

SetEnv MGREQ_INI_PATH /usr/local/httpd/conf

The Apache requester uses the /usr/local/httpd/conf/ MGREQ.INI file.

To use this requester, call Magic xpa using a URL, such as: http://server/mgrequest031?appname=...

You should also modify the MAGIC.INI file to read: InternetDispatcherPath= /mgrequest031

Using an Apache Web Server with a non-default port

If you would like to use Apache with a non-default port (port number other than 80), you should change the setting shown below in the MAGIC.INI file:

InternetDispatcherPath= http://server:port/cgi-bin/mgrqcgi031

instead of

/cgi-bin/mgrqcgi031