Progress
Version 9
Product Update Bulletin
Installing and Configuring Web Servers and Java Servlet Engines
AIA and AIA/S support the Sun Java Servlet specification Version 2.1 and requires a Web server that is compatible with a Java servlet engine (JSE). The Web server and servlet engine are not provided by Progress. To use AIA, you must install and configure a Web server and a JSE. Table C–1 lists the Web servers, servlet engines, and platforms on which AIA has been qualified. Other JSEs might work, but have not been qualified. If you encounter problems using a JSE other than those listed in Table C–1, you should test with one of the qualified JSEs. For more recent information, see the Release Notes and the Progress Knowledge Base on the Web
(http://www.Progress.com/support)
.
A JSE must be installed for each Web server that you are using. How the JSE is installed and configured to run AIA or AIA/S depends on the JSE and the Web server. The information you provide during the installation and configuration varies depending on the Web server and JSE. However, the following reflects some of the tasks you must perform and the information you must provide when you install and configure a JSE for the AIA:
- Add Install-Dir
/java/aia.zip
to the JSE CLASSPATH.- On UNIX platforms only, add Install-Dir
/lib
to the JSE LIBRARYPATH.- Create a servlet instance for each AIA entry in the
ubroker.properties
file, and use com.progress.aia.Aia for theClassName
property.Then use the following values for the
Init Arguments
for each instance of the servlet:
- InstallDir = Directory where Progress is installed
- instanceName = Name that you specified for the AIA instance in the
ubroker.properties
file.- PropertyFileName = Location of the
ubroker.properties
file. This would typically be Progress Install-Dir/properties/ubroker.properties.
NOTE: The values you enter are case sensitive. So you must enter the values to meet the requirements of the platform you use.- Optionally set up a virtual path extension to point to AIA. For example, you could use a virtual path of
/aia/Aia
. Progress Software strongly recommends that you define a virtual path.- On UNIX only, you must add the following environment variables to the script that starts the JSE:
You must restart your JSE and Web server for these changes to take effect. After you have completed these steps, test the AIA configuration using a Web browser with the following URL:
:
Where path identifies the virtual path and servlet name used to invoke the JSE and the AIA and must include the following information:
The specification of the path depends on your Web server and JSE. For more information, see the "Administering and Configuring an AppServer Internet Adapter" section and the documentation for your Web server and servlet engine.
If you used all the recommended settings, the URL is:
For instructions on installing and configuring a specific JSE, see the documentation for that JSE. For more specific information about configuring the AIA with JSEs, see the Release Notes and the Progress Knowledge Base on the Web
(http://www.Progress.com/support)
. For information about the configuration tasks you must complete to use the AIA with WebClient, see the Progress Knowledge Base on the Web(http://www.Progress.com/support).
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |