The OpenEdge Web Services Adapter (WSA) component comes with a sample WSA Web application, which is installed, by default, within the OpenEdge hierarchy. This works in development environments. But in production environments, where OpenEdge might be uninstalled and reinstalled frequently, the sample WSA Web application might be deleted. For this reason, Progress Software Corporation recommends that in production environments, you copy or move the WSA sample Web application to a disk location outside the OpenEdge hierarchy—perhaps to the Web application directory of the Java container where the WSA runs.
To copy the WSA sample Web application:
1. Change the directory to OpenEdge-Install-Directory/servlets.
2. Copy the entire WSA subdirectory tree to its final destination. Use the command for your operating system, as shown in the following table.
Table 12. Moving the installed sample Web application
On this operating system . . .
Use this command . . .
Windows
xcopy /E /I .\wsa destination-directory
UNIX
cp -r -p ./wsa destination-directory
3. Update your Java container configuration files to refer to the new WSA sample Web application directory. For more information, see Configuring the Java container to recognize the WSA. In general, you need to restart the Java container (or Web server) for the new configuration settings to take effect.
4. If you plan to deploy Web services to WSA instances created in the new sample Web application directory, destination-directory/wsa, you can proceed with deployment immediately after completing 3. In this case all Web services are deployed to a WSA instance directory within destination-directory/wsa. However, if you want to specify a separate Web service deployment directory for any WSA instance created for the Web application, you must update the Web application descriptor file to specify a new deployment directory for that instance. For more information, see Deploying and Managing OpenEdge Web Services.
