The Tomcat Java Servlet Engine (JSE) includes its own Web server. This Web server should be used to test the Tomcat to AIA setup, prior to using the Apache Web server. The Tomcat Web server uses port 8080 by default, when Tomcat is started.
This solution begins with the assumptions that:
- Tomcat has been install and the Tomcat home page is displayed with the following URL, http://localhost:8080.
- A local installation of Progress / OpenEdge is present on the machine (this can be the free AIA deployment component if Tomcat is on a different machine to the main Progress / OpenEdge installation).
*Alternatively steps 1-3 below can be skipped if the "aia" directory is copied from DLC\servlets\ to TOMCAT_HOME/webapps/.
1. Create three new directories in the TOMCAT_HOME/webapps directory:
/aia
/aia/WEB-INF
/aia/WEB-INF/lib
2. Create a new file named "web.xml" in the TOMCAT_HOME/webapps/aia/WEB-INF directory.
Add the following XML to the file and substitute the path to the Progress installation for PROGRESS_HOME:
<?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>
3. Copy PROGRESS_HOME/java/aia.jar into the TOMCAT_HOME/webapps/aia/WEB-INF/lib directory,
If you are running Progress Version 9.x the file name is aia.zip. Copy this file and rename the new copy of "aia.zip" to "aia.jar".
4. In OE 9.x connect to the AdminServer with the Progress Explorer Tool and open the AppServer Internet Adapter folder. Under the "General" tab folder makes sure the "HTTPS enabled" box is not checked if you are not using HTTPS. Click on the "Advanced Features" folder and check the box for "Internal Administrative Command" .
In OE versions with OE Explorer/Management go to Resources-> AppServer Internet Adapter-> Configuration.
Another option is to manually modify the ubroker.properties file.
[AIA]
httpsEnabled=0
[AIA.Aia1]
allowAiaCmds=1
5. Start tomcat.
6. From a local browser, test the servlet with this URL: http://localhost:8080/aia/Aia
The correct response is "Aia1 OK" page.
