[Geronimo Wiki] Update of "Tomcat" by JohnSisson

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Geronimo Wiki" for change notification.

The following page has been changed by JohnSisson:
http://wiki.apache.org/geronimo/Tomcat

The comment on the change is:
Change way we recommend configurations are started and other small changes

------------------------------------------------------------------------------
+ '''Contents'''
+ [[TableOfContents]]
+ 
  = About =
  
  The Tomcat integration is made up of a set of GBeans that represent the different Tomcat components (i.e. Container, Connectors,  Engine, Host, Valves, etc).  The top level and managing component, the {{{org.apache.geronimo.tomcat.TomcatContainer}}} class is the Tomcat GBean (aka service) of Apache Geronimo.  The integration includes its own Tomcat deployer which allows custom configuration of Tomcat.
@@ -306, +309 @@

  in ''modules/assembly/src/plan/j2ee-deployer-plan.xml'' and ''modules/assembly/src/plan/j2ee-runtime-deployer-plan.xml''
  
  Once it's done, rebuild the assembly module, and start up Geronimo as follows (see ["Running"]):
- 
+  {{{
-  {{{java -Djava.endorsed.dirs=lib/endorsed -jar bin/server.jar org/apache/geronimo/Tomcat
+ java -Djava.endorsed.dirs=lib/endorsed -jar bin/server.jar 
  }}}
  
  '''NOTE''': The java.endorsed.dirs variable must be set on the java command line, or Tomcat will not start.
  
- '''NOTE''': CATALINA_HOME environment variable is required to run Tomcat. It's set to ''var/catalina/'' via the GBean attribute ''catalinaHome'' in j2ee-server-tomcat-plan.xml
+ Now start the Tomcat configuration (see ["Deployment"]) by starting another shell (command window) and issuing the following command:
+  {{{
+ java -jar bin/deployer.jar --user system --password manager start org/apache/geronimo/Tomcat
+ }}}
  
- '''NOTE''': Default HTTP connector GBean listens to 8090 port. The port can be changed in the ''j2ee-server-tomcat-plan.xml'' file.
+ '''NOTE''': The next time you start Geronimo, it will start the configurations that were previously started, so there is no need to issue the previous command again.
  
- A simple start-up of Geronimo with Apache Tomcat and the !DebugConsole webapp:
+ '''NOTE''': The `CATALINA_HOME` environment variable is not used by Tomcat when running inside Geronimo. The Catalina home directory is set to ''var/catalina/'' via the GBean attribute `catalinaHome` in the ''j2ee-server-tomcat-plan.xml'' file. 
+ 
+ '''NOTE''': Default HTTP connector GBean listens on port 8090 and the default AJP/1.3 connector GBean listens on port 8009 These port numbers can be changed in the ''j2ee-server-tomcat-plan.xml'' file.  If you are not running a web server in front of Geronimo that uses AJP, the TomcatAJPConnector GBean may be commented out.
+ 
+ To aid Geronimo problem diagnosis, start the Debug Console configuration by issuing the following command:
+  {{{
+ java -jar bin/deployer.jar --user system --password manager start org/apache/geronimo/DebugConsole
+ }}}
+ 
+ A simple start-up of Geronimo with Apache Tomcat and the !DebugConsole webapp: (TBD: this example needs to be updated to match the commands above)
  
   {{{
  $ java -Djava.endorsed.dirs=lib/endorsed -jar bin/server.jar org/apache/geronimo/DebugConsole