Installing and configuring Web servers and Java container

A Java container must be installed for each Web server that you are using. How the Java container is installed and configured to run AIA depends on the Java container and the Web server. The information you provide during the installation and configuration varies depending on the Web server and Java container. However, some of the tasks you must perform and the information you must provide when you install and configure a Java container for the AIA are as follows:

Add OpenEdge-Install-Directory/java/aia.zip to the Java container CLASSPATH.

On UNIX only, add OpenEdge-Install-Directory/lib to the Java container LIBRARYPATH.

Create a servlet instance for each AIA entry in the ubroker.properties file, and use com.progress.aia.Aia for the ClassName property. Use the following values for the Init Arguments for each instance of the servlet:

InstallDir — Directory where OpenEdge 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 OpenEdge-Install-Directory/properties/ubroker.properties.

Optionally set up a virtual path extension to point to AIA. For example, you could use a virtual path of /aia/Aia. Progress Software Corporation strongly recommends that you define a virtual path.

Note: The values you enter are case sensitive, so you must enter the values to meet the requirements of the platform you use.

On UNIX only, you must add the following environment variables to the script that starts the Java container:

Add:

DLC=OpenEdge-Install-Directory; export DLC

Add:

WRKDIR=OpenEdge-working-directory; export WRKDIR

This is the path to the work directory you specified when you installed OpenEdge.

Add:

LD_LIBRARY_PATH = OpenEdge-Install-Directory/lib:$LD_LIBRARY_PATH; export LD_LIBRARY_PATH

Depending on your operating system, the library path variable might differ (for example, LIBPATH, SHLIB_PATH, and so on).

You must restart your Java container 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:

Table 8. Syntax
http://Host:Port/Path

Host

Identifies the machine where the Web server is running.

Port

Identifies the port number for the Web server.

Path

Identifies the virtual path and servlet name used to invoke the Java container and the AIA and must include the following information:

A virtual path that the Java container has configured within the Web server to recognize and pass directly to the Java container instead of looking for that directory on the Web server

Name of the Java servlet to be invoked by the Java container

The specification of the Path depends on your Web server and Java container. For more information, see ConfiguringAIA components and the documentation for your Web server and servlet engine.

If you used all the recommended settings, the URL is:

http://Host:Port/aia/Aia

For instructions on installing and configuring a specific Java container, see the documentation for that Java container. For more specific information about configuring the AIA with Java container, see the Release Notes and the Progress Knowledge Center 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 Center on the Web (http://www.progress.com/support).

In this section:

Enabling the Web server or Java container for SSL operation