Kbase 20344: AIA V9.1X and JRun 2.3.3 Installation and Configuration
| Autor |
Progress Software Corporation - Progress |
| Acesso |
Público |
| Publicação |
04/12/2008 |
|
Status: Verified
GOAL:
How to install and configure the Jrun 2.3.3 Java Servlet Engine to work with the Progress AppServer Internet Adapter (AIA).
FACT(s) (Environment):
Progress 9.1x
FIX:
1) Install JRun using its installation program.
- Answer all the questions as they are asked (you must know
the web server you are going to configure JRun with during
the install)
- Select the native connector type (not Java) during
installation.
- For most other questions, take the default.
- On Windows NT, the install is GUI.
- On UNIX, the install is character based, unless you have
the DISPLAY environment variable set before you start the
install. If you don't, the installation program asks if
you want the GUI install.
2) Start the JRun.
- On Windows NT, go to:
START > PROGRAMS > JRun > Start Jrun
(NT Service or NT application)
- On UNIX, run the start command:
jrun-install-dir/jsm-default/jsmctl
3) Test at least one of the JRun example servlets.
(at"http://hostname:port/servlet/HelloWorldServlet)">http://hostname:port/servlet/HelloWorldServlet)
If this test does not work, do not continue until you get it
working. One cause of a failure might be Enable Servlets is
set to [yes] in the web server manager.
4) Click on the JRun icon in Systray (it looks like a gear).
5) Click on the Administrator start button.
On UNIX, run the jrun-install-dir/jsm-default/jsmctl admin
(This is a Java GUI Administrator and must be run on a
terminal with motif support)
Now the configuration tool for both Windows NT and UNIX are
the same once they are initialized.
(After configuration, you must restart your web server and
start the JRun Java servlet engine).
6) Select "jse" ServiceID on the first tab.
7) Click on the Service Config button.
8) Select the Mappings tab.
9) Click on the Add button.
10) Enter a new VirtualPath/Extension.
Add add "/aia/" in the VirtualPath/Extension and "invoker"
in the Servlet Invoked columns.
11) Click on the Save button to save the changes.
12) Select the Aliases tab.
13) Click on the Add button to add a new Servlet name.
a) Enter Aia in the Name column.
b) Enter com.progress.aia.Aia in the ClassName column.
c) Double click on the Init Arguments column to get a new
dialog box.
d) Select Add, and enter InstallDir in the Name column and
progress-install-dir in the Value column.
e) Select Add, and enter instanceName in the Name column and
Aia1 in the Value column.
f) Select Add, and enter propertyFileName, in the Name
column and progress-install-perties/ubroker.properties
in the Value column.
14) Click on the OK button to end adding Init Arguments.
15) Click on the [Save] button to save changes.
16) Click on the [Close] button to return to the main administration page.
17) Select the General tab and then the Java sub-tab.
18) Add the location of your aia.zip file to the Java CLASSPATH
text box.
19) On UNIX only, add the progress-install-dir/lib to the
Library path text box.
20) Click on the Save button to save changes.
21) Click on the Close button to exit the Jrun administrator.
22) On UNIX only, edit the jrun-install-dir/jsm-default/jsmctl
file.
a) Add DLC=progress-install-dir; export DLC.
b) Add WRKDIR=path-to-working-dir; export WRKDIR.
c) Add CLASSPATH=progress-install-dir/lib:$CLASSPATH;
export CLASSPATH
23) Restart the JRun process.
On Windows NT, click the JRun icon (a gear) in the systray,
then click on Restart.
On UNIX, run jrun-install-dir/jsm-default/jsmctlrestart.
24) Test yo.ur configuration with:
href="http://hostname:port/VirtualPath/ServletName"
or
href="http://hostname:port/aia/Aia."
If JRun is installed and configured correctly, you should get an AIA OK message..