Configuring Tomcat for UIX Deployment

This topic describes the Apache Tomcat server configuration tasks you would perform to deploy ADF UIX web applications. See About Tomcat Directory Structure for UIX Deployment for a sample directory structure that is set up for deploying a UIX application in Tomcat.

The instructions here assume a Tomcat version 4.1.x has already been installed in the directory <tomcat_install>. To download and installing Tomcat, see jakarta.apache.org/tomcat.

To configure a Tomcat instance for UIX deployment:

1. Install the UIX JAR file and runtime dependencies.

   Oracle recommends that you install the UIX runtime files ( uix2.jar, regexp.jar, share.jar, and xmlparserv2.jar ) in the <tomcat_install> /common/lib directory. This enables multiple applications in the same Tomcat instance to share the dependent JAR files.

2. Set up the UIX installable resources.

   1. The UIX installable resources are distributed in the uix2-install.zip file, the contents of which will unzip into the cabo directory. Oracle recommends you unzip the contents into the <tomcat_install> /webapps directory.

   2. Create an empty web.xml file in <tomcat_install> /webapps/cabo/WEB-INF.

   See the "Configuration for ADF UIX" chapter of the ADF UIX Developer's Guide if you need more information about setting up a shared UIX installable resources application.

3. Install the UIX application resources in a subdirectory of <tomcat_install>/webapps , for example, <tomcat_install> /webapps/<myuixwebapp>.

   For WAR file deployments, place the WAR files in the root of <tomcat_install>/webapps. Tomcat automatically expands the WAR files upon starting up. The enterprise application name defined in a WAR deployment profile becomes the virtual path of the URL to the web application.

4. For unpacked application deployments, create the web application deployment descriptor file (web.xml) in <tomcat_install>/webapps/ <myuixwebapp>/WEB-INF.

5. Modify the configuration file <tomcat_install> /conf/server.xml.

   1. For each unpacked application deployment, add the line <Context path="/ <myuixwebapp> docbase=" <myuixwebapp> crossContext="true"/> where <myuixwebapp> is the web application directory name.

   2. For WAR file deployments, add the following line once only: <DefaultContext crossContext="true"/>

6. Start the Tomcat servlet engine by running the following command from the <tomcat_install> /bin directory:

   • Windows: startup.bat

   • UNIX: startup.sh

   You should see "Starting service Tomcat-standalone, Apache Tomcat/<version_number>."

7. Upgrade UIX, when needed.

   Note: Stop the Tomcat instance before upgrading. Restart Tomcat after upgrading UIX.

   1. Copy the files uix2.jar, regexp.jar, share.jar, and xmlparserv2.jar to the <tomcat_install>/common/lib directory.

   2. Unzip the contents of uix2-install.zip into the directory where the shared UIX resources are installed, e.g., <tomcat_install>/webapps.

   3. Delete the runtime cabo cache directories in each deployed web application directory, e.g., <tomcat_install>/webapps/ <myuixwebapp>/cabo.

Notes:

• By default, when you deploy WAR files with JDeveloper, the UIX runtime JAR files and installable resources are packaged with your application resources in the J2EE archives. To optimize your server setup, you may want to exclude the UIX runtime JARs and installable resources from the deployment profile.
• When you redeploy a WAR file, remember to delete the expanded web application directory before restarting Tomcat.

Related topics

Working with the Apache Tomcat Application Server
About Tomcat Directory Structure for UIX Deployment
Deploying to the Apache Tomcat Application Server

Copyright © 1997, 2004, Oracle. All rights reserved.