Status: Verified
GOAL:
How to set up JRun 4.0 with Progress AIA 9.1x and OpenEdge 10.x
FACT(s) (Environment):
AppServer Internet Adapter (AIA)
Progress 9.1x
OpenEdge 10.x
FIX:
JRun from Macromedia is a J2EE application server and integrated development environment for building and deploying server-side Java applications.
After installing the JRun Java application server you must make sure that the engine is working properly. Test at least one of the JRun sample applications (http://hostname:8200/). If this test does not work, don't go further until you get it working. If you have a configuration problem, please refer to JRun documentation at www.macromedia.com.
Follow these steps to set up JRun 4.0 after the installation:
1) Install the JRun 4.0.
2) Start your web browser and select http://hostname:8000 or whatever port for JRun 'admin' server you have set during your install.
3) Log in using the administrator name and password entered during the install.
4) In the left pane treeview choose 'default' (JRun Web Server)
5) Choose 'Settings'
6) In the 'Java VM Settings' dialog box add in the 'New classpath' <progress-install-dir>\java\aia.zip where <progress-install-dir> is the Progress install directory.
If deploying the 10.x version, the file to be used is <OpenEdge-install-dir>\java\aia.jar
7) Click on the 'Update' button
NOTE the following:
A) JRun has a problem with directory names that include spaces, as in:
'Program files'. You can work around this problem by either:
-- Installing in a directory with a name that does not include spaces, or
-- referring to the 'Program Files' directory as 'Progra~1'.
B) JRun also has problems with directories that have more than 8 character or directories that are not unique in the first 8 characters. The examples:
D:\Progress9
D:\Progress91d
with Progress 9.1D installed in the D:\progress91d directory will fail with either:
-- "InstallDir argument is not specified"
-- "Class not found," or
-- "Could not instantiate ..."
8) Stop the 'default' Web server -- it is necessary to stop 'default' Web server using the 'JRun Launcher' from the Macromedia program group.
9) Create the 'aia' directory in the: <JRun-Install-Dir>\servers\default
-> <JRun-Install-Dir>\servers\default\aia
10) Create <JRun-Install-Dir>\servers\default\aia\WEB-INF
11) In the <JRun-Install-Dir>\servers\default\aia\WEB-INF create the file named 'web.xml' :
<?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>D:/dlc91d</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>D:/dlc91d/pr.operties/ubroker.properties</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>Aia</servlet-name>
<url-pattern>/Aia</url-pattern>
</servlet-mapping>
</web-app>
12) With OpenEdge 10.x, if not using secure AIA, change the https-enabled from the default setting of 'true' to 'false'. To do this either edit the ubroker.properties file or use Progress Explorer.
13) Change the 'D:\dlc91d' in web.xml to reflect your own <progress-install-dir> or <OpenEdge-install-dir>
14) Start the 'default' JRun Web server (using the 'JRun Launcher')
15) Test with the: http://localhost:8100/aia/Aia
If the AIA is configured correctly, then the 'AIA OK' message will appear.
If error 404 appears when testing this URL, set the Internal Administrative Command to 'true' in the Advanced Features of AIA in Progress Explorer. Restart 'default' Web server using the 'JRun Launcher' and re-test.
Keep in mind that you are now using the integrated JRun Web server (port 8100 in the URL). You may choose to use an external Web server, such as Apache, IIS, or iPlanet. You can configure JRun to connect to an external Web server by running the JRun Web Server Connection tool on the system hosting the external Web server.
Windows users can select Start > Programs > Macromedia JRun 4 > Web Server Configuration.
All users can use the command line by opening a console window to jrun_root/lib and issuing the following command:
java -jar wsconfig.jar
For more information on installing a Web server connector, see the "Installing JRun" documentation..