cocoon-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From d...@cocoon.apache.org
Subject [Cocoon Wiki] Updated: BeginnerInstallTomcatUnix
Date Sat, 05 Mar 2005 16:36:40 GMT
   Date: 2005-03-05T08:36:40
   Editor: BertrandDelacretaz
   Wiki: Cocoon Wiki
   Page: BeginnerInstallTomcatUnix
   URL: http://wiki.apache.org/cocoon/BeginnerInstallTomcatUnix

   point to NoServletContainerRequired

Change Log:

------------------------------------------------------------------------------
@@ -6,6 +6,8 @@
 This document applies to :
  *  tomcat-4.1.18 and newer under linux and unix
 
+'''Warning''': many pages on this wiki imply that a servlet container must be installed before
running Cocoon, this is '''wrong''' - see NoServletContainerRequired. A basic installation
of Cocoon for test or development purposes can be ''very simple''.
+
 === What you will get from this page ===
 You will learn, how to retrieve and setup tomcat, the
 official reference !ServletContainer. This approach has 
@@ -40,8 +42,8 @@
 tomcat distributions, which are clearly labeled with jdk14. If you are running
 a lower version of java, you '''must''' download one of the other distributions.
 You can check which java version you are running by issuing the following command:
-{{{
- java -version 
+{{{
+ java -version 
 }}}
 
 ==  Step II: Unpack it ==
@@ -57,20 +59,20 @@
 choose /opt/tomcat as root of your installation. I personally
 choose /opt/tomcat, place the tar file into this directory, then
 i untar it at place. I end up with a subfolder named {{{jakarta-tomcat-4.1.18}}}.
-The following set of commands will do the job:{{{
-
-mkdir /opt/tomcat
-cd /opt/tomcat
-# You need to retrieve the distrib now to /opt/tomcat
-tar xzf tomcat-4.1.18.tar.gz
-
+The following set of commands will do the job:{{{
+
+mkdir /opt/tomcat
+cd /opt/tomcat
+# You need to retrieve the distrib now to /opt/tomcat
+tar xzf tomcat-4.1.18.tar.gz
+
 }}}
 
 '''caveat''': some unix tars do NOT support the uncompression flag 'z'
 in these case you either need to gunzip first. The command sequence 
-would be:{{{
-gunzip tomcat-4.1.18.tar.gz
-tar xf tomcat-4.1.18.tar
+would be:{{{
+gunzip tomcat-4.1.18.tar.gz
+tar xf tomcat-4.1.18.tar
 }}}
 
 ==  Step III: Prepare for startup ==
@@ -103,33 +105,33 @@
 
  * edit the file named server.xml
 
-  *Search for the shutdown port definition{{{
-<Server port="8005" shutdown="SHUTDOWN" debug="0">
+  *Search for the shutdown port definition{{{
+<Server port="8005" shutdown="SHUTDOWN" debug="0">
 }}}You may change the port to any convenient number above 1024 and below 32768.
 
-  *Search for the http port definition {{{
-<!-- Define a non-SSL Coyote HTTP/1.1 Connector on port 9011 -->
-<Connector className="org.apache.coyote.tomcat4.CoyoteConnector"
-  port="8080" minProcessors="5" maxProcessors="75"
+  *Search for the http port definition {{{
+<!-- Define a non-SSL Coyote HTTP/1.1 Connector on port 9011 -->
+<Connector className="org.apache.coyote.tomcat4.CoyoteConnector"
+  port="8080" minProcessors="5" maxProcessors="75"
 }}}You may change the port to any convenient number above 1024 and below 32768.
 
-  *Search for the Webserver connector {{{
-<!-- Define a Coyote/JK2 AJP 1.3 Connector on port 8009 -->
-<Connector className="org.apache.coyote.tomcat4.CoyoteConnector"
-  port="8009" minProcessors="5" maxProcessors="75"
-  enableLookups="true" redirectPort="8443"
-  acceptCount="10" debug="0" connectionTimeout="0"
-  useURIValidationHack="false"
-  protocolHandlerClassName="org.apache.jk.server.JkCoyoteHandler"/>
-
-<!-- Define an AJP 1.3 Connector on port 8009 -->
-<!--
-<Connector className="org.apache.ajp.tomcat4.Ajp13Connector"
-  port="8009" minProcessors="5" maxProcessors="75"
-  acceptCount="10" debug="0"/>
--->
-}}} Depending on your system, either the Coyote/JK2 AJP Connector, the AJP 1.3 Connector
is active. The inactive connector is commented out with XML comments of following syntax:
{{{
-<!-- anything except 2 consecutive '-' signs -->
+  *Search for the Webserver connector {{{
+<!-- Define a Coyote/JK2 AJP 1.3 Connector on port 8009 -->
+<Connector className="org.apache.coyote.tomcat4.CoyoteConnector"
+  port="8009" minProcessors="5" maxProcessors="75"
+  enableLookups="true" redirectPort="8443"
+  acceptCount="10" debug="0" connectionTimeout="0"
+  useURIValidationHack="false"
+  protocolHandlerClassName="org.apache.jk.server.JkCoyoteHandler"/>
+
+<!-- Define an AJP 1.3 Connector on port 8009 -->
+<!--
+<Connector className="org.apache.ajp.tomcat4.Ajp13Connector"
+  port="8009" minProcessors="5" maxProcessors="75"
+  acceptCount="10" debug="0"/>
+-->
+}}} Depending on your system, either the Coyote/JK2 AJP Connector, the AJP 1.3 Connector
is active. The inactive connector is commented out with XML comments of following syntax:
{{{
+<!-- anything except 2 consecutive '-' signs -->
 }}}You may inactivate both connectors for the moment, but need to reactivate one as soon
as you want to connect your Webserver with tomcat.
 
 ===  Start your container for the first time ===
@@ -141,9 +143,9 @@
 ||startup.sh  || best for script based startup
 ||shutdown.sh || best for script based shutdown
 
-For the beginning you may use catalina.sh :{{{
-cd /opt/tomcat/jakarta-tomcat-4.1.16/bin
-./catalina.sh
+For the beginning you may use catalina.sh :{{{
+cd /opt/tomcat/jakarta-tomcat-4.1.16/bin
+./catalina.sh
 }}}
 You have started tomcat now in foreground. The shell
 is blocked and tomcat runs. You can stop tomcat by
@@ -162,8 +164,8 @@
 modified the $tomcat_root/bin/server.xml as described 
 above, you may now access tomcat by typing in your browser:
 
-{{{
-http://localhost:8080
+{{{
+http://localhost:8080
 }}}
 
 You might have to replace ''localhost'' by the name of
@@ -202,13 +204,13 @@
 
  *  If you encounter any problem with tomcat it is best to first look into {{{catalina.out}}}.
  *  If you can't find a clue to your problem there, look next at {{{localhost_log.<date>.txt}}}.
You should get a clue by now.
- *  If you still can't access your server with your browser, recheck the first lines of {{{catalina.out}}}
and look for following pattern:{{{
-[INFO] Http11Protocol - -Initializing Coyote HTTP/1.1 on port 8080
-Starting service Tomcat-Standalone
-Apache Tomcat/4.1.18
+ *  If you still can't access your server with your browser, recheck the first lines of {{{catalina.out}}}
and look for following pattern:{{{
+[INFO] Http11Protocol - -Initializing Coyote HTTP/1.1 on port 8080
+Starting service Tomcat-Standalone
+Apache Tomcat/4.1.18
 }}}and verify that your portsettings are corect.
- * And don't forget to enter the correct URL to your browser:{{{
-http://loalhost:8080
+ * And don't forget to enter the correct URL to your browser:{{{
+http://loalhost:8080
 }}}
 
 ----

Mime
View raw message