Deploying to the Apache Tomcat Application Server

Deploy your packaged application to the Apache Tomcat Application Server through an application server connection. A packaged application will contain a deployment profile that names the files to be deployed, describes their organization, and specifies the target server.

The target Tomcat server must be installed locally or mapped to a network drive.

To deploy to the Apache Tomcat Application Server:

Create a connection to the target application server.
If the project is a Business Components UIX JSP project, add required Cabo resources to it.
If your project uses ADF Business Components, install the ADF runtime libraries on the server.
If the project is a UIX web application, configure the server for UIX deployment.
Select the deployment profile in the Navigator, right-click, and choose Deploy to | <application server connection> to package the application as an archive file and deploy it via the selected application server connection.
Stop and restart the Tomcat server.

Notes:

Make sure that you have the tools.jar library in the Tomcat classpath. This file is located in <jdev_install> /jdk/lib and must be of the version of the JDK being used to run Tomcat. Otherwise, you may encounter problems when running applications in Tomcat.
When developing a Business Components project to be deployed to Tomcat, you must select a connection type and the corresponding SQL dialect, type maps or domains. For more information, see Developing Business Components for Oracle Lite and Non-Oracle Data Sources .
The recommended deployment for web applications is <Tomcat_install>/webapps/<subdirectory> . Set this option in the General page of the WAR File deployment profile.
If deploying a UIX application, first deploy a WAR file to the target server, then complete the deployment configuration on the server according to the documentation for Tomcat. See Configuring Tomcat for UIX Deployment for an overview of the server configuration tasks.
The system administrator of the Tomcat application server must assign a context path to your application in the conf/server.xml file:
```
<DefaultContext crossContext="true"/>         
```
This will allow the WAR file in the root of <tomcat-install>/webapps to detect the /cabo/ shared installables. See Tomcat system administration documentation for more information.
You may get the following error message when running a JSP application deployed to Tomcat:
Only one of the two parameters ... or ... should be defined.

Because Tomcat does not release tags after pooling, subsequent uses of the same tag with incompatible attributes defined will cause this error.

To avoid the error, you must disable tag pooling in Tomcat:
1. Open the file <tomcat_home>/conf/web.xml in a text editor.
2. Find the following element:
```
<init-param>

  <param-name>enablePooling</param-name>

  <param-value>true</param-value>

</init-param>            
```
3. Change the value of <param-value> to false .