Deploying the connector to an existing Tomcat server

The following instructions explain how to deploy the web application of the Connector for Web Services to an existing Tomcat server.

To keep the Tomcat application 'clean' and avoid overwriting of your configuration, install the web applications in a directory structure outside the Tomcat file hierarchy.

Complete these steps:

Create directory structure.

On the server that runs Tomcat, create the following directory structure:


UNIX folder	Windows folder	Use
/infor/ese/warfiles	C:\infor\ese\warfiles	Temporary storage war files.
/infor/ese/c4ws/web	C:\infor\ese\c4ws\web	Connector for Web Services web application
/infor/ese/c4ws/conf	C:\infor\ese\c4ws\conf	Connector for Web Services configuration data

The previous directory structure is used here to demonstrate manual deployment of the WAR file to the Tomcat web server. You can, of course, use any other suitable directory structure.

The /infor/ese/ and C:\infor\ese\ folders are further referred to as the Enterprise Server Installer installation disk to the warfiles subdirectory of the Connector for Web Services.

Extract WAR files in application folders.
Manually extract the WAR file into its application folder, c4ws/web.

For UNIX, use these commands:
```
cd /infor/ese/c4ws/web
$JAVA_HOME/bin/jar xf /infor/ese/warfiles/c4ws.war
```
For Windows, use these commands:
```
cd /D C:\infor\ese\c4ws\web
%JAVA_HOME%\bin\jar.exe xf C:\infor\ese\warfiles\c4ws.war
```
Create a context file.
Create a c4ws.xml context file in the folder that contains the WAR files. Copy this XML file to the Conf/Catalina/localhost folder of your Tomcat installation, for example C:\infor\ese\apache-tomcat-8.0.21\Conf\Catalina\localhost for Windows.

Tomcat can deploy a web application using a context configuration XML file. If you use such a file, you can distribute the Tomcat software, the web applications and the configuration data over different folders. The context file is used to specify the location of the web applications and the location of the configuration data these applications use. We recommend that you use a context file to store the connector web applications and their configuration data in separate folders outside the Tomcat file hierarchy, to avoid that you overwrite your configuration data when updating Infor or Tomcat software or lose web applications when re-installing Tomcat.

The following c4ws.xml file is an example of a context file for the Connector for Web Services running on a Windows platform. The file indicates that the web application is located in C:\infor\ese\c4ws\web and that the configuration data is stored in C:\infor\ese\c4ws\conf.
```
<Context docBase="C:\infor\ese\c4ws\web">
  <Parameter name="configLocation"
    value="C:\infor\ese\c4ws\conf"
    override="false"/>
</Context>
```
Restart Tomcat.
Stop and restart Tomcat to ensure the web application is deployed.