PREREQUISITES:Ensure the following components are installed before proceeding.
- Progress AppServer
- Database
- ProxyGen
- Java 2 SDK
Uninstall previous WSA versions (if applicable)1. Stop Tomcat.
2. Move the
<Tomcat directory>\webapps\wsa directory to a backup directory which is located
outside of the Tomcat installation directory.
3. Do the same for any other WSA instances, t
o a backup directory (located outside of the Tomcat installation directory). For example move the:
<Tomcat directory>\webapps\wsatestInstallation / Configuration of Tomcat1. (
If Tomcat is not yet installed) Download a full binary version of Tomcat from
http://tomcat.apache.org2. (
If Tomcat is not yet installed) Run the Tomcat install program and follow the installation instructions.
3. Stop Tomcat.
4. Copy the directory
<OpenEdge directory>\servlets\wsa (including all sub-directories)
into the directory
<Tomcat directory>\webapps. So, you should have
<Tomcat directory>\webapps\wsa (including all sub-directories there).
To do this copy command on Linux, for example, the following may be used:
$ sudo cp -pr $DLC/servlets/wsa /var/lib/tomcat6/webapps
5. Start Tomcat
(during the startup process, Tomcat will add the Adapter as a web application).
6. To validate the configuration was successful, check the following:
-
A new directory named wsa1 was created in the "<TomCat Directory>\webapps\wsa" directory. The wsa1 directory will initially contain two files: default.props and DeployedServices.ds.
-
Starting Tomcat will automatically start the WSA. To check that Tomcat has started, enter the following URL in a browser: http://<Tomcat-Server-Hostname>
The default Tomcat response is an html page entitled "It works" and contains "This is the default web page for this server".
-
To check that wsa1 (default) Web Services Adapter is working, enter the following URL in a browser: http://<Tomcat-Server-Hostname>:8080/wsa/wsa1
The correct response is an html page entitled "WSA Web Services" and it contains "status:wsa1:OK".
NOTE: If Tomcat is configured to use a port other than 8080 then modify the above to use the appropriate port.
-
In the event of a failure, check Progress WRKDIR\wsa1.wsa.log and Tomcat log files located in <Tomcat-install-dir>\logs for errors and ensure that the WSA instance has been defined in the $DLC/properties/ubroker.properties file.
7. At this point the WSA has been successfully configured.
