Kbase P30600: How to setup the Web Services Adapter (WSA) with Tomcat
| Autor |
Progress Software Corporation - Progress |
| Acesso |
Público |
| Publicação |
4/19/2010 |
|
Status: Verified
GOAL:
How to setup the Web Services Adapter (WSA) with Tomcat
GOAL:
How to configure the Web Service Adapter (WSA) with Tomcat
FACT(s) (Environment):
OpenEdge 10.x
Tomcat 4.1
Tomcat 5.5
All Supported Operating Systems
FIX:
PREREQUISITES:
Progress AppServer
Database
ProxyGen
A. Install the Progress WSA product
B. Install a Java 2 SDK
I. Installation / Configuration of Tomcat
1. Download the full binary version of Tomcat 4.x from www.jakarta.apache.org
2. Run the Tomcat install program and follow the installation instructions.
3. Start Tomcat. "Control Panel, Services, Apache Tomcat 4.1."
4. Copy the directory \wsa located in <OpenEdge directory>\servlets into the directory <Tomcat directory>\webapps. So you should have <Tomcat directory>\webapps\wsa .
5. (OPTIONAL) Modify the <TOMCAT_Install>\conf\server.xml file to create a logger for the WSA instance.
For Tomcat 4.1, locate the following text:
<!-- Tomcat Root context -->
<!--
<Context path="" docBase="ROOT" debug=0"/>
-->
For Tomcat 5.5, locate the following text:
<!--
<Valve className="org.apache.catalina.valves.FastCommonAccessLogValve"
directory="logs prefixs="localhost_access_log." suffix=".txt"
pattern="common" resolveHosts="false"/>
-->
Add the following context immediately after the section shown above:
<Context path="/wsa" docBase="wsa" debug="0" reloadable="false">
<Logger className="org.apache.catalina.logger.FileLogger" prefix="wsa_log." suffix=".txt" timestamp="true" />
</Context>
6. Restart Tomcat. During the startup process, Tomcat will add the adapter as a web application.
7. To validate the configuration was successful, check the following.
i. 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.
ii. Starting Tomcat will automatically start the wsa, check the Progress WRKDIR for the wsa1.was.log.
iii. In a browser enter the following URL::8080/wsa/wsa1">http://<hostname>:8080/wsa/wsa1 The correct response is an html page entitled "WSA Web Services" and contains 'status:wsa1:OK".
iv. In the event of a failure, check the Tomcat log files located in <Tomcat-install-dir>/logs for errors.
8. At this point the WSA has been successfully configured.