About Tomcat Directory Structure for UIX Deployment

This topic describes a sample directory structure for deploying an ADF UIX application in Apache Tomcat. It assumes that a version of Tomcat has been installed on the server in the directory <tomcat_install>. To download and installing Tomcat, seejakarta.apache.org/tomcat.

When deploying a WAR file to Tomcat, the enterprise name you specify in the deployment profile becomes the virtual path of the URL to the web application, e.g., http://<hostname>:8080/ <virtualpath>/main.uix where <virtualpath> is the J2EE enterprise name.

The following trees show the directory structure for an expanded application deployment. The WAR file is placed in the root of <tomcat_install>/webapps. Tomcat automatically detects and decompresses the WAR file and installs the application. myUIXApp is the expanded web application directory.

The UIX installable resources (distributed in the uix2-install.zip file) are deployed in a separate web application (cabo). This configuration enables multiple UIX applications in the same Tomcat instance to share a common set of UIX installable resources. See the "Configuration for ADF UIX" chapter of the ADF UIX Developer's Guide for details on how to set up a shared UIX installable resources application.

See Configuring Tomcat for UIX Deployment for information about setting up and configuring a Tomcat instance to deploy UIX applications..

Server configuration

+---<tomcat_install>
|.....
|+----bin
|+----common
||+-----lib
|||-------uix2.jar
|||-------regexp.jar
|||-------share.jar
|||-------xmlparserv2.jar
|+----conf
||------server.xml
|.....
|+----webapps
||------myuixapp.war
|.....
||+-----cabo
|||+------images
|||+------jsLibs
|||+------jsps
|||+------styles
|||+------WEB-INF
||||--------web.xml
|.....

Expanded application configuration

|.....
|||+------<tomcat_install>/webapps
|.....
||||+-------myUIXApp
|||||---------[*.uix, *.uit, images, JavaScript libraries, style sheets]
|||||+--------WEB-INF
||||||----------web.xml
||||||+---------classes
|||||||-----------[any private classes]
||||||+---------lib
|||||||-----------[any private JAR files used by the application]
|.....