Status: Unverified
GOAL:
How to deploy AIA with SunOne 6.1 Enterprise Web Server
FIX:
Deploying AIA on SunOne 6.1 Enterprise Web Server
The SunOne 6.1 Web Server has built-in support for JSE and JSP applications. So deploying AIA into the SunOne 6.1 Web Server does not require a separate JSE (like Tomcat or ServletExec) to support the AppServer Internet Adapter (AIA).
Modify Aia1 in ubroker.properties file:
Modify ubroker.properties file to force the Aia1 to not redirect to HTTPS and to Allow Administrative Commands, so we can use a browser to test the loading of the AIA servlet.
1) Move to $DLC/properties
2) Edit ubroker.properties
3) Add to the [AIA.Aia1] section
httpsEnabled=0
allowAiaCmds=1
(You can also make these changes with Progress Explorer.)
The following steps are specific for deploying AIA on SunOne 6.1 and should not be used for other JSE?s.
Create a WAR file:
SunOne 6.1 Web Server requires a WAR (WebARchive) file to properly deploy a servlet, so first create a WAR file.
1) Move to your $DLC/servlets/aia/WEB-INF directory.
2) UNIX only: Edit the web.xml file fixing the back slashes in the propertyFileName section (change $DLC\properties\ubroker.properties to $DLC/properties/ubroker.properties ? where $DLC is the full path to your Progress install).
3) Now move to your $DLC/servlets/aia directory
4) Run this command to make the WAR file:
jar cvf aia.war WEB-INF
Modify ?start? file of web server:
The web server needs some Progress environment variables to properly initiate the AIA servlet.
1) Move to your <SunOneInstallDirectory>/https-<hostname> directory
2) Make a back up copy of the ?start? script
3) Modify the ?start? script at the top
a. Add DLC=<path to progress install>; export DLC
b. Add WRKDIR=<path to working directory; export WRKDIR
4) Modify the ?start? script at the LD_LIBRARY_PATH
a. Add $DLC/bin to the end of the LD_LIBRARY_PATH
5) Restart the web server (either through the Admin Web Page or by running ?stop? and then ?start? scripts
Deploy the AIA WAR file:
Now we must use the SunOne Administration pages to deploy the AIA WAR file.
1) Open the SunOne Administration page (http://hostname:port)
2) Enter Administrator name and password
3) Select the [Manage] button to manage your server
4) Select the ?Virtual Server Class? tab
5) Select the ?http-<hostname>? link below TREE VIEW OF SERVER section
6) Select the ?Web Applications? tab
7) Select ?Deploy Web Application?
8) Change WAR File On: to Server Machine and click the [GO] button
9) Add the path to the WAR file (full path on the server machine including aia.war)
10) Add ?Application URI:? /aia
11) Change ?Installation Directory:? to
<SunOneInstall>/https-<hostname>/webapps/aia
12) Click [OK]
13) Restart your web server
Test your AIA servlet:
.
Now you can test the loading of your AIA servlet with a web browser.
1) http://hostname:port/aia/Aia
Using a 4GL client your can now run a quick round trip to the AppServer
1) start the AppServer
2) run client code to run AppServer code using
CONNECT("-URL http://hostname:port/aia/Aia?AppService=asbroker1")
.