DevPortal

How do I Install WebGate for Apache HTTP Server?

Pre-installation Considerations

Before installing WebGate, you should configure Apache Server for dynamic shared object (DSO) support, since the plug-in is built as a DSO that is loaded when the Apache HTTP Server starts.

To verify that DSO is enabled on Apache Server, run httpd -l at the prompt for Unix-based systems. For Windows, run apache -l at the <install-root>/Apache/ directory.

All modules loaded on the Apache Server are listed. Look for mod_so.c. If mod_so.c is not present, contact your system administrator to enable DSO support for Apache Server.

How do I Install WebGate on Apache Server?

To install WebGate on Apache Server, extract the contents of the archive into a convenient location on your local system. Let it be called <webgate_home>.
  1. Copy pramatiplugin.props into the <APACHE_ROOT>/conf/ directory.
  2. Open <APACHE_ROOT>/conf/httpd.conf in any text editor to view the Apache Server configuration file. Add the following information in the LoadModule and AddModule sections respectively, in the configuration file: LoadModule webgate_module /path/to/webgate_home/WGApachex.xWin.dll and AddModule mod_webgate.c

    Note: Ignore this for Apache version 2.0.

  3. Requests can be redirected to Pramati Server based on a URI pattern. To do this, specify the URI pattern as shown in the example below:

    4. <Location /bankWeb/*>SetHandler webgate-handler</Location>
    <Location /bankWeb/im/*>SetHandler webgate-handler</Location>
    <Location /bankWeb/im/*/*>SetHandler webgate-handler</location>

    In the <Location> tag above, wild cards (*) can be used in the URI pattern. The * indicates all files under that directory.

    Alternatively, the <LocationMatch> tag can also be used: <LocationMatch /bankWeb>SetHandler webgate-handler</LocationMatch>

    In the above configuration snippet, all URI requests that contain the sub-string "/bankWeb" in its URI would be redirected to the webgate-handler. Note that in the <LocationMatch> entry, wildcards (*) cannot be used.

  4. Save the configuration file and start/restart Apache Server.
WebGate is now plugged into Apache Server and lets you load dynamic content from applications deployed on Pramati Server.

If you are using the WebGate plug-in 2.0, the following paths should be added to your system’s path for Windows, and the LD_LIBRARY_PATH for Unix-based systems.

Table 1: Path to be added for an Operating system
Operating System File Path
Windows <JAVA_HOME>/jre/bin/client
Unix/Linux <JAVA_HOME>/jre/lib/i386:/jre/lib/i386/client
Solaris <JAVA_HOME>/jre/lib/sparc

How do I Determine WebGate Plugin Version?

To determine the version of the WebGate plugin, please take a look at the log file. Here’s a snippet from the log file that shows the version of the plugin as 2.1 and the build:

WebGate Plugin with Enhanced LoadBalancer for Apache2.2 Version 2.1 09-06-2006

Related Topics:

© Pramati Technologies 2007 Runs on Pramati Server | Feedback | Legal