How to setup Tomcat 4.1.x with 9.1D AppServer Internet Adapter on Linux.

How to setup Tomcat 4.1.x with 9.1D AppServer Internet Adapter on Linux.
How to setup AIA with Tomcat 3.3.x and Tomcat 4.x

These are the steps to set it up:

NOTE: Assume that Tomcat is installed in TOMCAT_HOME directory and the Progress AppServer component(s) are installed in PROGRESS_HOME.

1) Create a new file "apps-aia.xml" in the TOMCAT_HOME/conf directory; this defines a "context" for "aia" which will be used in a URL to access AIA.

This is an example of this file:

<?xml version="1.0" encoding="ISO-8859-1"?>
<webapps>
<Context path="/aia" docBase="webapps/aia" debug="0"
reloadable="true"></Context>
</webapps>

2) Create three new directories in the TOMCAT_HOME/webapps
directory:

webapps/aia (new dir)
webapps/aia/WEB-INF (new dir)
webapps/aia/WEB-INF/lib (new dir)

3) Create a new file named "web.xml" in the TOMCAT_HOME/webapps/aia/WEB-INF directory.
Here's an example of this file --
Change PROGRESS_HOME to point to the root directory of the progress installation.
<?xml version="1.0" encoding="ISO-8859-1"?>

<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN"
"http://java.sun.com/j2ee/dtds/web-app_2_2.dtd">

<web-app>
<servlet>
<servlet-name>
Aia
</servlet-name>
<servlet-class>
com.progress.aia.Aia
</servlet-class>
<init-param>
<param-name>InstallDir</param-name>
<param-value>PROGRESS_HOME</param-value>
</init-param>
<init-param>
<param-name>instanceName</param-name>
<param-value>Aia1</param-value>
</init-param>
<init-param>
<param-name>propertyFileName</param-name>
<param-value>
PROGRESS_HOME/properties/ubroker.properties
</param-value>
</init-param>
</servlet>

<servlet-mapping>
<servlet-name>
Aia
</servlet-name>
<url-pattern>
/Aia
</url-pattern>
</servlet-mapping>
</web-app>

4) Copy PROGRESS_HOME/java/aia.zip into the TOMCAT_HOME/webapps/aia/WEB-INF/lib directory, then rename the new copy of "aia.zip" to "aia.jar".

5) You will need to make some modifications to the TOMCAT_HOME/bin/catalina.sh script. Tomcat requires a minimum Java 2 run time environment.

- catalina.sh
Add the following environment variables.

TOMCAT_HOME=where_you_installed _tomcat; export TOMCAT_HOME
JAVA_HOME=path to java installation; export JAVA_HOME
        WRKDIR=specified_at_progress_install; export WRKDIR

6) Add the $DLC/lib directory to the LD_LIBRARY_PATH environment and to your $PATH environment.
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$DLC/lib; export LD_LIBRARY_PATH
PATH=$LD_LIBRARY_PATH:$PATH; export PATH

# The LD_LIBRARY_PATH variable is required by AIA;

7) Modifications to PROGRESS_HOME/properties/ubroker.properties.

Change "allowAiaCmds=0" to "allowAiaCmds=1" in the AIA section of the ubroker.properties. This is set to zero initially for security purposes.

The default AIA instance is setup to redirect HTTP request to HTTPS. If you are not using Secure AIA disable the redirection.

In the [AIA] section change httpsEnabled=1 to httpsEnabled=0".


8) Start tomcat using the catalina.sh script. $TOMCAT_HOME/bin/catalina.sh start

9) Ensure that the Tomcat admin page is viewable from a browser.
        http://hostname:8080

10) To test that AIA is configured correctly go to:

        http://hostname:8080/aia/Aia

If AIA is configured correctly the page will display:

        Aia1 OK
        Connection Pool (numCurrentConnections=0, numTotalConnections=0)

If the above is not displayed please review the confiquration to ensure everything is set correctly.

The standalone webserver that comes with TOMCAT 4.1.18 is confiqured for
mod_jk. If you are intergrating tomcat with an APACHE webserver or IIS webserver the server must have the mod_jk module for apache, and the mod_jk isapi for IIS installed and confiqured. The mod_jk is a module that allows the webserver to communciate with the JSE. Without the mod_jk the webserver will not communicate with the JSE.