Kbase P91699: How to setup a second instance of the Web Services Adapter?
| Autor |
Progress Software Corporation - Progress |
| Acesso |
Público |
| Publicação |
28/03/2011 |
|
Status: Verified
GOAL:
How to setup a second instance of the Web Services Adapter?
GOAL:
How to setup more than one instance of Web Services Adapter?
GOAL:
How to create a new instance of the WSA?
GOAL:
How to setup more than one WSA using Tomcat?
GOAL:
How to run multiple instances of WSA in the same server?
FACT(s) (Environment):
All Supported Operating Systems
OpenEdge 10.x
FIX:
Setup your first instance of Web Services Adapter by using a copy of the <OpenEdge directory>\servlets\wsa directory. For an example please refer to Solution P30600, "How to setup the Web Services Adapter (WSA) with Tomcat on a Windows Platform." . To setup a second instance please follow these general guidelines:
1. Stop your Java Servlet Engine (JSE), e.g. Tomcat.
2. Make another copy of the <OpenEdge directory>\servlet\wsa directory (this copy will go into your JSE 's webapps subdirectory).
3. Rename the directory to the required name, e.g.: wsatest .
4. Set this up to run within your JSE, e.g.: <Tomcat directory>\webapps\wsatest .
5. In the Progress Explorer?s left pane, highlight the Web Services Adapter, and click New.
6. When the New Web Services Adapter dialog box appears:
a. Supply the new WSA instance?s name and URL, e.g.: wsatest and http://localhost:8080/wsatest/wsa1 .
b. Select Local or Remote, depending on whether the WSA is local or remote to the AdminServer.
c. Choose OK.
7. When the Progress Explorer?s left pane appears, it now contains the new WSA instance.
8. If the WSA instance is remote, perform the following additional steps on the system where the WSA is installed:
a. In the ubroker.properties file, copy and rename the section corresponding to the sample WSA instance provided (wsa1) to a new section
(in essence, cloning wsa1?s section to a new section).
b. Then, edit the properties in the new WSA instance?s section as desired.
9. Edit the web.xml file for this WSA instance (see the OpenEdge Application Server: Administration guide, section 5-13 for information on configuring the web.xml file). At a minimum you need to change the "instanceName" listed in the web.xml file to correspond to the one listed in the ubroker.properties file. For example for a WSA instance called "wsatest" ( [WSA.wsatest] section in the ubroker.properties), you would modify the web.xml as follows:
<init-param>
<param-name>instanceName</param-name>
<!-- Enter this WSA servlet instance's name that will be used to locate
its properties in the Progress ubroker.properties file -->
<param-value>wsatest</param-value>
</init-param>
10. Restart your JSE.