Manual Pages for UNIX Operating System command usage for man tomcat

System Administration Commands                         tomcat(1M)



NAME
     tomcat - Apache Tomcat Version 6 overview

DESCRIPTION
     Apache Tomcat Version 6 (Tomcat) is  implementation  of  the
     Java Servlet and JavaServer Pages technologies.

     Tomcat can be enabled by authorized user within the  service
     management facility (SMF), using the following fault manage-
     ment resource identifier (FMRI):

       svc:/network/http:tomcat6

     Tomcat enabled via SMF is executed for better security  with
     "webserv"  user  credentials  and  with added "net_privaddr"
     privilege so it can be configured to  listen  on  privileged
     TCP  ports  (e.g.  80).  With  default  configuration Tomcat
     listens on TCP port 8080.

     Unauthorized user can start Tomcat with his or  her  creden-
     tials   using   ordinary  startup  scripts  and  by  setting
     CATALINA_BASE environment variable to path with his  or  her
     conf/,  webapp/  and logs/ subdirectories (see Tomcat direc-
     tory structure bellow).


FILES
     The following files specify the installation  locations  for
     Tomcat 6:

     /etc/tomcat6/

         Symbolic link to directory containing  Tomcat  6  confi-
         guration files (/var/tomcat6/conf).


     /usr/tomcat6/bin/

         Contains Tomcat startup scripts.


     /usr/tomcat6/lib/

         Contains Tomcat private libraries.


     /usr/tomvat6/docs/

         Contains Tomcat documentation in HTML format. The direc-
         tory  has  classical  WEBAPP structure and it's symboli-
         cally linked as /var/tomcat6/webapps/docs (the  link  is
         part      of     web/java-servlet/tomcat/tomcat-examples



SunOS 5.11          Last change: October 2009                   1






System Administration Commands                         tomcat(1M)



         packages).


     /var/tomcat6/conf/

         Contains Tomcat configuration files.  A  newly-installed
         Tomcat  contains  a default server.xml file. This is the
         main configuration file.


     /var/tomcat6/logs/

         Contains Tomcat log and output files.


     /var/tomcat6/logs/pid

         File where Tomcat which is started via SMF saves its PID
         number.


     /var/tomcat6/temp/

         Directory  used  by  the   JVM   for   temporary   files
         (java.io.tmpdir).


     /var/tomcat6/webapps/

         Tomcat Web Application Directory where are WAR files put
         for deployment.


     /var/tomcat6/webapps/ROOT/

         Directory with default (ROOT) web application  which  is
         served  when  URL  is  requested  without  further  path
         specifier (http://hostname/). After Tomcat packages ins-
         tallation  this  directory  is  intentionally left empty
         with just index.jsp and index.htm files. The  HTML  file
         redirects  requester  to  Tomcat  home  page which is in
         ROOT.example/ directory (this file is part of  web/java-
         servlet/tomcat/tomcat-examples package). The JSP file is
         default  home  page  which  is  shown   when   web/java-
         servlet/tomcat/tomcat-examples  (and  thus HTML file) is
         not installed. This shall  allow  better  deployment  of
         custom ROOT web application while maintain upgrade abil-
         ity via packaging system (without loosing data).


     /var/tomcat6/webapps/ROOT.example/




SunOS 5.11          Last change: October 2009                   2






System Administration Commands                         tomcat(1M)



         Tomcat  home  web   application   (part   of   web/java-
         servlet/tomcat/tomcat-examples package).


     /var/tomcat6/webapps/examples/

         This directory contains  web  application  with  various
         ServLets  and  JSP  examples.  The  directory is part of
         web/java-servlet/tomcat/tomcat-examples  package   which
         can  be removed if it's required (to permanently disable
         this web application).


     /var/tomcat6/work/

         Directory  where  Tomcat  places  for  web  applications
         intermediate  files  (such as compiled JSP files) during
         its work.


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     _______________________________________________________________________
    |          Attribute          |             Attribute Value            |
    |_____________________________|________________________________________|
    | Availability                | web/java-servlet/tomcat                |
    |_____________________________|________________________________________|
    |                             | web/java-servlet/tomcat/tomcat-examples|
    |_____________________________|________________________________________|
    | Interface Stability         | Uncommitted                            |
    |_____________________________|________________________________________|


SEE ALSO
     http://tomcat.apache.org

NOTES
     Source for Tomcat is available on http://opensolaris.org.













SunOS 5.11          Last change: October 2009                   3