|
Apache 2.2 |
For Apache 2.2, the preferred method is to use the Apache Load Module - Dynamic Shared Object (DSO) mod_inomads.so that is specifically designed for use with the Apache server. This module will intercept the iNomads requests and forward them directly to the NOMADS application.
By default, all launched iNomads processes will be launched within the constraints of the Apache server.
If you want to use a different user ID or authorization level, use the Launch Port option in the iNomads configuration file. When using Apache with iNomads, the pathnames must also be defined. See Configuring PxPlus Pathnames.
For more information about Apache, see Apache HTTP Interface.
The Apache 2.2 HTTP server is controlled by a variety of ".conf" files. If you are planning to use Apache as your Web engine, it is strongly recommended that you familiarize yourself with the documentation on Apache. The website http://httpd.apache.org has documentation and numerous resources that can assist you in setting up Apache.
In this document, the basic installation and setup of Apache are provided so it can run iNomads for both Windows and UNIX/Linux. These instructions are based on the version 2.2 of Apache and may vary on future releases. To find the most current version for Windows, select a mirror site at http://www.apache.org/dyn/closer.cgi/httpd/binaries/win32/ and then select the version you require.
To learn more about Apache HTTP configuration, see Apache Configuration.
Download the current Apache HTTP server from the Web.
During the installation process, you will be asked to declare your website and domain name. These are used by the install process to pre-set some of the configuration files.
For the purposes of testing iNomads, the following values are suggested:
|
|
Network Domain |
inomads.com |
|
|
Server Name |
local.inomads.com |
|
|
Adminstrator's Email Address |
your.name@youremail.com |
Once installed, you need to tailor a few files to make the configuration work. You will then need to edit/replace the httpd.conf file.
The following lines can be appended to httpd.conf and used to run the preferred interface:
#
# PxPlus iNomads setup
#
LoadModule inomads_module modules/mod_inomads.so
<Location /inomads>
SetHandler inomads
</Location>
#
# Use name-based virtual hosting. (optional)
#
NameVirtualHost *:80
#
# **** IMPORTANT NOTICE: Use forward slashes for all directory names and adjust the pathname as reqd
#
<VirtualHost *:80>
ServerName inomads.domain.com
DocumentRoot "C:/PVX Plus Technologies/PVX Plus/lib/_plus/inomads"
DirectoryIndex inomads
# Default to ISO-8859-1
AddDefaultCharset ISO-8859-1
# Redirect any attempt to view the .conf files to error 404
RedirectMatch 404 conf$
</VirtualHost>
<Directory "C:/PVX Plus Technologies/PVX Plus/lib/_plus/inomads">
Options FollowSymLinks
AllowOverride None
Order allow,deny
Allow from all
</Directory>
In addition, you will need to copy the following two files from lib\_plus\inomads\apache\module\windows:
Most UNIX systems come with Apache pre-installed; however, you will need to edit its configuration to use iNomads. Generally, the Apache configuration files are found in the /etc/apache or /etc/httpd directories on your server. To edit these files, you will likely require root access.
Load Module Setup
The first step you will need to do is to compile the "mod_inomads" component on your UNIX/Linux system to make sure it matches the current Apache and hardware you are using.
The source of this file is in the inomads/apache/module sub-directory, but it must be compiled on your target system to make sure its internal structures match the version of Apache you are running. This can be done by changing to the module sub-directory and entering the following (on Apache2, apxs may be called apxs2):
apxs -i -a -c mod_inomads.c
The pre-compiled DLL that PxPlus provides for Apache is for Apache 2.2; however, PxPlus supplies the source, which can be compiled for any version of Apache (*plus/inomads/apache/module/mod_inomads.c).
The source is generally only needed on a UNIX system where the CPU and/or #bits vary from install to install. For Windows, a pre-compiled version is supplied. This avoids the issue of users needing a separate 'C' compiler, which is not included with the OS (UNIX/Linux generally come with compilers).
During initialization, Apache will process all '.conf' files found in the 'conf.d'. To simplify the configuration of the Load Module interface, copy the file found in lib/_plus/inomads/apache/unix-inomads.conf to the conf.d directory as inomads.conf.
#
# PxPlus Apache HTTP interface Load Module definition
#
#
# **** IMPORTANT NOTICE: Use forward slashes for all directory names
#
<Location /inomads>
SetHandler inomads
</Location>
<VirtualHost *:80>
ServerName inomads.domain.com
DocumentRoot "/pxplus/lib/_plus/inomads"
DirectoryIndex inomads
# Default to ISO-8859-1
AddDefaultCharset ISO-8859-1
# Redirect any attempt to view the .conf files to error 404
RedirectMatch 404 conf$
</VirtualHost>
# This directory definition allows the system to access the inomads files
<Directory "/pxplus/lib/_plus/inomads">
Options FollowSymLinks
AllowOverride None
Order allow,deny
Allow from all
</Directory>
You may need to edit the file to define the starting directory for iNomads, which should be the *plus/inomads in your install.
Once all the configuration changes have been made, you will need to start/restart the Apache server to have the changes take effect. On many Linux systems, this can be done by entering the following command:
service httpd restart
The above describes a very generic Apache configuration. Depending on your configuration and if you are using Apache for other services, your setup may differ.