Status: Unverified
GOAL:
How to set up the servlet engine JRun 3.0 to work with the Progress AppServer Internet Adapter (IntAdap)
FACT(s) (Environment):
Progress 9.1x
JRun 3.0
SYMPTOM(s):
AppServer Internet Adapter (AIA)
FIX:
After installing the JRun Java Servlet you must make sure that the servlet engine is working properly.
Test JRun example servlets:
http://hostname:8100/demo
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 http://www.allaire.com.
Use the following steps to set up JRun 3.0 after starting it:
1. Start your favorite web browser and select
http://hostname:8000 or whatever port for Management Console you set during your install.
2. Login using the administrator name and password entered during the install.
3. Use the tree view in the left pane, expand the JRun Default Server.
4. Select the Java Settings link.
5. Edit the Classpath (by clicking the link) and add the <progress-install-dir>/java/aia.zip file.
Add the entire path as a new line in the input field dialog.
6. Select the Update button.
JRun has a problem with directory names that include spaces (such as program files). You can work around this problem by either:
Installing in a directory with a name that does not include spaces, or Refer to the Program Files directory as Progra~1.
JRun also has problems with directories that have more than 8 character or directories that are not unique in the first 8 characters.
E.g.
e:\progress9
e:\progress91
e:\progress91a
with progress 9.1x installed in the e:\progress91 directory will fail with either:
- InstallDir argument is not specified
- Class not found
- Could not instantiate ...
7. Edit the Librarypath (by clicking the link) to add the <progress-install-dir>/lib directory.
8. Select the "External Web Server" link in the left panel.
Note: If you have already entered the information during the installation, continue to step 10.
9. This will prompt you to add an External Web Server. Enter the information for the web server you are using.
10. Use the tree view in the left panel to expand the Web Applications view.
11. Use the tree view in the left panel to expand the Default Application view.
12. Select Servlet Definitions and click the Edit button to add a definition.
13. Add a new servlet definition:
a) Enter Aia in the Name box.
b) Enter com.progress.aia.Aia in the ClassName box.
c) Add the following values in the Init Arguments box:
InstallDir=<progress-install-dir>
instanceName=Aia1
(Aia1 is defined in the ubroker.properties file.)
PropertyFileName=<progress-install-dir>/properties/ubroker.properties
These names use Java naming conventions. They, therefore, are case sensitive. The system will not work if improperly entered.
14. Select Servlet URL Mappings.
15. Add the following mapping:
/aia/ in the Virtual Path/Extension box
Aia in the Servlet Invoked box (the one you just defined in the above step).
16. On UNIX only, edit the "<jrun-install-dir>/bin/jrun" file:
- Add DLC=<progress-install-dir>; export DLC
- Add WRKDIR=<path-to-working-dir>; export WRKDIR.
- Add LD_LIBRARY_PATH=<progress-install-
dir/lib:$LD_LIBRARY_PATH just before the export
LD_LIBRARY_PATH already in the file.
17. Select the JRun Default Server again.
You might have to exit from Jrun, then reconnect to it if it does not appear to restart.
18. Select the [restart server] button in right panel. Or restart the default server from the Programs Group on Windows NT, or <jrun-install.-dir>/bin/jrun -start on UNIX.
19) Test your configuration with:
http://hostname:port/aia/Aia.
You can also use the following URL:
http://hostname/scripts/jrun.dll/aia/Aia .
If JRun is installed correctly, you will get an AIA OK message..