blob: 433fea379a415ddd50fd3d01a8880f8d9eb8f750 [file] [log] [blame]
= Directory Structure
:jbake-date: 2016-03-16
:jbake-type: page
:jbake-status: published
:jbake-tomeepdf:
ifndef::backend-pdf[]
[#filetree.col-md-4]
[
{
label: 'apps',
description: 'A common but optional folder containing the applications (war, ear, jar). Note: this folder needs to be activated in tomee.xml for instance and is not there by default.',
children: [
{label:'module1.jar',description:'An ejbmodule'},
{label:'myapp',description:'An exploded war or ear'},
{label:'anotherapp.war',description:'A war'},
{label:'anotherapp',description:'By default TomEE will explode the war next to the .war file, this is customizable.'},
{label:'anotherapp2.ear',description:'An ear'},
{label:'anotherapp2',description:'By default TomEE will explode the ear next to the .ear file, this is customizable.'}
]
},
{
label: 'bin',
description: 'The executable and boot related files',
children: [
{label:'bootstrap.jar',description:'The jar allowing Tomcat to start'},
{label:'catalina.bat',description:'The windows main Tomcat script'},
{label:'catalina.bat.original',description:'The original catalina.bat from Tomcat. TomEE customizes it.'},
{label:'catalina.sh',description:'The UNIx main Tomcat script'},
{label:'catalina.sh.original',description:'The original catalina.sh from Tomcat. TomEE customizes it.'},
{label:'catalina-tasks.xml',description:'Some Ant tasks Tomcat provides to work with JMX'},
{label:'commons-daemon.jar',description:'When setting up TomEE as a service you need this jar.'},
{label:'commons-daemon-native.tar.gz',description:'The native needed by commons-daemon'},
{label:'configtest.bat',description:'A windows script to validate the server.xml'},
{label:'configtest.sh',description:'A UNIx script to validate the server.xml'},
{label:'daemon.sh',description:'A script which can be used as init.d script'},
{label:'digest.bat',description:'A windows script to compute a digest'},
{label:'digest.sh',description:'A UNIx script to compute a digest'},
{label:'service.bat',description:'The windows service script'},
{label:'service.install.as.admin.bat',description:'Install TomEE as a service on windows'},
{label:'service.readme.txt',description:'The explanations on how to setup TomEE as a windows service'},
{label:'service.remove.as.admin.bat',description:'Uninstall TomEE service on windows'},
{label:'setclasspath.bat',description:'The script called by catalina.bat to initialize Tomcat classpath'},
{label:'setclasspath.sh',description:'The script called by catalina.bat to initialize TomEE classpath'},
{label:'setenv.sh',description:'A UNIx user script (optional) where you can specify some JVM options like CATALINA_OPTS environment variable'},
{label:'setenv.bat',description:'A windows user script (optional) where you can specify some JVM options like CATALINA_OPTS environment variable'},
{label:'shutdown.bat',description:'Stop the server on windows, it is commonly used with -force and a timeout as options'},
{label:'shutdown.sh',description:'Stop the server on UNIx, it is commonly used with -force and a timeout as options'},
{label:'startup.bat',description:'Start (and forget) TomEE on windows'},
{label:'startup.sh',description:'Start (and forget) TomEE on UNIx'},
{label:'tomcat-juli.jar',description:'The Tomcat Java Util Logging extensions which allow for instance to configure the logging per application'},
{label:'tomcat-native.tar.gz',description:'The Tomcat native used by some connectors'},
{label:'TomEE....exe',description:'TomEE windows executables when setup as a service for amd64 architectures'},
{label:'tomee.bat',description:'TomEE utility script for windows, allows to compute ciphers for instance'},
{label:'tomee.sh',description:'TomEE utility script for UNIx, allows to compute ciphers for instance'},
{label:'tool-wrapper.bat',description:'Windows script calling Tomcat Tool utility. It executes a command line with Tomcat classloader.'},
{label:'tool-wrapper.sh',description:'UNIx script calling Tomcat Tool utility. It executes a command line with Tomcat classloader.'},
{label:'version.bat',description:'Print Tomcat version (for windows)'},
{label:'version.sh',description:'Print Tomcat version (for UNIx)'}
]
},
{
label: 'conf',
description: 'Folder containing the configuration of TomEE',
children: [
{label:'Catalina',description:'A folder where Tomcat can copy web application configuration (typically context.xml can be overriden from there)'},
{label:'catalina.policy',description:'The server security policy rules'},
{label:'catalina.properties',description:'The server boot configuration (classloader etc...)'},
{label:'conf.d',description:'A TomEE folder where services can pick configuration'},
{label:'context.xml',description:'The default context.xml configuration'},
{label:'logging.properties',description:'The logging configuration for the server and applications (overridable)'},
{label:'server.xml',description:'The server configuration (Host, Context, Valves, ...)'},
{label:'server.xml.original',description:'The original server.xml, TomEE updates it to add its lifecycle manager.'},
{label:'system.properties',description:'TomEE global configuration'},
{label:'tomcat-users.xml',description:'The default location where tomcat stores users.'},
{label:'tomcat-users.xml.original',description:'The Tomcat tomcat-users.xml (TomEE add comments)'},
{label:'tomcat-users.xsd',description:'The XSD for tomcat-users.xml'},
{label:'tomee.xml',description:'The TomEE configuration file, syntax is hybrid between XML and Properties and it is fully replaceable with system.properties but users generally prefer this file.'},
{label:'web.xml',description:'The default web.xml'}
]
},
{
label: 'lib',
description: 'Folder containing TomEE binaries',
children: [
{label:'*.jar',description:'Tomcat + TomEE libraries'}
]
},
{
label: 'logs',
description: 'Default location of log files',
children: [
{label:'catalina.$day.log',description:'By default container logs go there'},
{label:'xxx.2016-03-16.log',description:'By default application xxx logs go there (when using servlet API)'},
{label:'localhost.$day.log',description:'By default host related logs go there'},
{label:'localhost_access_log.$day.txt',description:'By default access logs (request the container processed) go there'}
]
},
{
label: 'temp',
description: 'Java temporary directory is redirected by default to this folder',
children: [
{label:'OpenEJB-dejlzdbhjzbfrzeofrh',description:'A temporary file TomEE can create (suffix depends the startup) to check the instance'}
]
},
{
label: 'webapps',
description: 'Folder containing the web applications',
children: [
{label:'myapp',description:'An exploded war'},
{label:'anotherapp.war',description:'A war'},
{label:'anotherapp',description:'By default TomEE will explode the war next to the .war file, this is customizable.'}
]
},
{
label: 'work',
description: 'Folder where Tomcat and TomEE can work',
children: [
{
label:'Catalina',description:'By default Tomcat Engine is called Catalina. This folder matches engine name.',
children: [
{
label:'localhost',description:'A folder by host by engine to seggregate data of each ones',
children: [
{
label:'myapp',description:'An application deployed on the previous level host',
children: [
{ label:'org.apache.jsp.index_jsp.java',description:'The generated JSP source (index.jsp there)' },
{ label:'org.apache.jsp.index_jsp.class',description:'The compiled JSP binary' }
]
}
]
}
]
}
]
}
]
[#filetreedetail.col-md-8.bs-callout.bs-callout-primary]
Click on a tree node or open a folder to see the detail there.
endif::[]