SUMMARY:
This Solution provides guidelines for setting up the servlet engine
JRun 4.0 to work with the Progress AppServer Internet Adapter (AIA)
Version 9.1B or later.
EXPLANATION:
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.
SOLUTION:
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
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:\Progress91c
with Progress 9.1C installed in the D:\progress91c
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:/dlc91c</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:/dlc91c/properties/ubroker.properties
</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>Aia</servlet-name>
<url-pattern>/Aia</url-pattern>
</servlet-mapping>
</web-app>
12) Change the 'D:\dlc91c' in web.xml to reflect your own
<progress-install-dir>
13) Start the 'default' JRun Web server (using the 'JRun Launcher')
14) Test with the: http://localhost:8100/aia/Aia
If the AIA is configured correctly, then the 'AIA OK'
message will appear.
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.
Reference to Written Documentation:
http://www.macromedia.com/software/jrun/