tomcat (1m)

Name

Synopsis

Please see following description for synopsis

Description

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 lis-
     tens 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).

     Similarly it's possible to run multiple SMF Tomcat instances
     by setting CATALINA_BASE for both start and stop methods for
     newly created Tomcat FMRI.


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

     /etc/tomcat6/

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


     /usr/tomcat6/bin/

         Contains Tomcat startup scripts.


     /usr/tomcat6/lib/

         Contains Tomcat private libraries.


     /usr/tomvat6/docs/




SunOS 5.11            Last change: June 2013                    1






System Administration Commands                         tomcat(1M)



         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  pack-
         ages).


     /var/tomcat6/conf/

         Contains Tomcat configuration files.  A  newly-installed
         Tomcat  contains  a default server.xml file. This is the
         main configuration file.  For setting Tomcat environment
         variables  it's  possible  to create here setenv.sh file
         which is sourced during start by catalina.sh.


     /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 speci-
         fier (http://hostname/). After Tomcat packages installa-
         tion this directory is  intentionally  left  empty  with
         just  index.jsp and index.htm files. The HTML file redi-
         rects  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



SunOS 5.11            Last change: June 2013                    2






System Administration Commands                         tomcat(1M)



         custom ROOT web application while maintain upgrade abil-
         ity via packaging system (without loosing data).


     /var/tomcat6/webapps/ROOT.example/

         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
     attributes:

     +---------------+-------------------------+
     |ATTRIBUTE TYPE |    ATTRIBUTE VALUE      |
     +---------------+-------------------------+
     |Availability   | web/java-servlet/tomcat |
     +---------------+-------------------------+
     |Stability      | Uncommitted             |
     +---------------+-------------------------+
SEE ALSO
     http://tomcat.apache.org/tomcat-6.0-doc



NOTES
     This   software   was   built   from   source  available  at
     https://java.net/projects/solaris-userland.   The   original
     community       source       was       downloaded       from
     http://www.apache.org/dist/tomcat/tom-
     cat-6/v6.0.41/src/apache-tomcat-6.0.41-src.tar.gz

     Further  information about this software can be found on the
     open source community website at  http://tomcat.apache.org/.



SunOS 5.11            Last change: June 2013                    3