Kbase P124447: How to setup more than one WSA using Tomcat?
| Autor |
Progress Software Corporation - Progress |
| Acesso |
Público |
| Publicação |
3/29/2011 |
|
Status: Verified
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):
OpenEdge 10.1x
All Supported Operating Systems
Tomcat
FIX:
If the application requires testing and production on a same machine and with different settings like security, it will be interesting to have 2 WSA instances running inside Tomcat.
To configure 2 or more WSA's follow the steps bellow:
1 - Create 2 or more WSA instances in the Progress Explorer.
Each one of the adapters should have an specific context(directory), for instance:http://<server>/wsaTest/wsa1, and http://<server>/wsaProduction/wsa1
2 - Copy the Progress provided servlet under <install dir>\servlets\wsa to <tomcat-dir>\webapps directory and modify the WSA directory name to match the first name written in the WSA address on the WSA instance.
3 - Copy again the same directory and rename to the second name written in the WSA address on the WSA instance
In the end of this process the Tomcat webapps will have as many copies of the WSA as many adapters were created in the Progress explorer, and make sure the url written in the WSA match a directory under webapps
4 - for each directory created under webapps, open it, and edit the file web.xml under WEB-INF.
Look for this entry:
<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>wsa1</param-value>
</init-param>
Update the wsa1 to match the name of the adapter in the Progress Explorer. Although not mandatory, it's recommended to use the same name for the adapter, and the context.
Looking behind the scenes, what happens is that when Apache is started, Progress Adapter is initialized, and will try to open the ubroker.properties and find a session inside the file with the same name as the context. If not found, the startup will fail with an invalid session exception.
5 - To avoid security issues, also copy this session under
<login>...</login>
<security-role>
<role-name>PSCAdmin</role-name>
</security-role>
<security-role>
<role-name>PSCOper</role-name>
</security-role>
6 - Start TOMCAT.
7 - Go to Progress Explorer and configure each WSA with the desired settings. One of they ways to split production and testing on the same server, is to have 2 name services, which is the entry point for requests.
8 - Deploy desired webservices to the appropriated context.