Mailing-List: contact docs-help@cocoon.apache.org; run by ezmlm
Precedence: bulk
Reply-To: docs@cocoon.apache.org
Content-Type: text/plain; charset="iso-8859-1"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable
From: docs@cocoon.apache.org
To: docs@cocoon.apache.org
Subject: 
 =?iso-8859-1?q?=5BCocoon_Wiki=5D_Updated=3A__WindowsTomcatCocoonInstallat?=
 =?iso-8859-1?q?ion?=
Date: Sat, 05 Mar 2005 16:41:13 -0000
Message-ID: <20050305164113.45305.38743@minotaur.apache.org>

   Date: 2005-03-05T08:41:13
   Editor: BertrandDelacretaz
   Wiki: Cocoon Wiki
   Page: WindowsTomcatCocoonInstallation
   URL: http://wiki.apache.org/cocoon/WindowsTomcatCocoonInstallation

   point to NoServletContainerRequired

Change Log:

---------------------------------------------------------------------------=
---
@@ -1,3 +1,5 @@
+'''Warning''': many pages on this wiki imply that a servlet container must=
 be installed before running Cocoon, this is '''wrong''' - see NoServletCon=
tainerRequired. A basic installation of Cocoon for test or development purp=
oses can be ''very simple''.
+
 Tomcat 5.0.18/Cocoon 2.1.3 on Windows 2000 with j2sdk1.4.2_01
 =

 ''(courtesy of Jim Bloggs)''
@@ -31,42 +33,42 @@
 =

       {{{c:\jakarta-tomcat-5.0.18}}}
 =

-      {{{Consider this: You can tell Winzip will create a subdirectory by =
looking at the value in the path column =

+      {{{Consider this: You can tell Winzip will create a subdirectory by =
looking at the value in the path column =

 on the right hand side.}}}
 =

 3. ''Do this:'' '''Set''' the ''JAVA_HOME'' and ''CATALINA_HOME'' environm=
ent variables.
 =

       Right-click {{{My Computer > Properties > Advanced > Environment var=
iables... > System Variable pane, New... etc.}}}
 =

-      {{{
-        JAVA_HOME
-          c:\j2sdk1.4.2_01
-        CATALINA_HOME
-          c:\jakarta-tomcat-5.0.18
+      {{{
+        JAVA_HOME
+          c:\j2sdk1.4.2_01
+        CATALINA_HOME
+          c:\jakarta-tomcat-5.0.18
 }}} =

 =

-      {{{Consider this: Environment variables can also be set in a DOS box=
 using DOS commands, but in that case, =

+      {{{Consider this: Environment variables can also be set in a DOS box=
 using DOS commands, but in that case, =

 they are only meaningful within and for the lifetime of that DOS box.}}}
 =

 4. ''Do this:'' '''Test''' the server by running the batch file provided.
 =

       {{{c:\jakarta-tomcat\bin\startup.bat}}}
 =

-      {{{Consider this: This is only one way of running the server. A bett=
er way is to install it as a Windows =

+      {{{Consider this: This is only one way of running the server. A bett=
er way is to install it as a Windows =

 service.}}}
 =

 5. ''Do this:'' '''View''' the default installation screen. The screen sho=
uld be available when you see the message[[BR]] ''INFO:Server startup in <n=
nnnn>ms'', by visiting:
 =

       {{{http://localhost:8080/}}}
 =

-      {{{Consider this: Tomcat listens on port 8080 by default. Apache lis=
tens on port 80 by default. Browsers =

+      {{{Consider this: Tomcat listens on port 8080 by default. Apache lis=
tens on port 80 by default. Browsers =

 normally hit on port 80 unless told otherwise.}}}
 =

 6. ''Do this:'' '''Stop''' the server by running the batch file provided.
 =

       {{{c:\jakarta-tomcat\bin\shutdown.bat}}}
 =

-      {{{Consider this: Because the batch file appears to hang, you will n=
eed to run this batch file from another
+      {{{Consider this: Because the batch file appears to hang, you will n=
eed to run this batch file from another
 DOS window.}}}
 =

 7. ''Do this:'' '''Install''' Tomcat as a Windows service by running the b=
atch file provided.
@@ -97,22 +99,22 @@
 =

       {{{build}}}
 =

-      {{{Consider this: During this time there will be many disturbing war=
ning messages. You can see other build =

-options by doing =

+      {{{Consider this: During this time there will be many disturbing war=
ning messages. You can see other build =

+options by doing =

 build -projecthelp}}}
 =

 12. ''Do this:'' '''Test''' Cocoon in the Jetty Servlet container.
 =

       {{{cocoon servlet}}}
 =

-      {{{Consider this: Jetty is provided with Cocoon so that it can be te=
sted independently of a separately =

+      {{{Consider this: Jetty is provided with Cocoon so that it can be te=
sted independently of a separately =

 installed servlet container such as Tomcat.}}}
 =

 13. ''Do this:'' '''View''' the Cocoon default installation screen here:
 =

       {{{http://localhost:8888/}}}
 =

-      {{{Consider this: Jetty listens on port 8888, but in a moment, we wi=
ll configure Cocoon to run with Tomcat =

+      {{{Consider this: Jetty listens on port 8888, but in a moment, we wi=
ll configure Cocoon to run with Tomcat =

 on port 8080.}}}
 =

 14. ''Do this:'' '''Stop''' the Jetty server.
@@ -125,7 +127,7 @@
 =

       {{{copy c:\cocoon-2.1.3\lib\endorsed\xalan.2.5.2.jar c:\jakarta-tomc=
at-5.0.18\common\endorsed\}}}
 =

-      {{{Consider this: The docs suggested copying over xercesXXX.jar and =
xml-apis.jar, but I omitted to because =

+      {{{Consider this: The docs suggested copying over xercesXXX.jar and =
xml-apis.jar, but I omitted to because =

 the versions that came with Tomcat were dated after those shipping with Co=
coon.}}}
 ;:''This is changed with the latest release of Cocoon 2.1.4, so please che=
ck for yourself'' -HvdL
 =

@@ -133,8 +135,8 @@
 =

       {{{xcopy c:\cocoon-2.1.3\build\webapp c:\jakarta-tomcat-5.0.18\webap=
ps\cocoon /D /S /V /I /F}}}
 =

-      {{{Consider this: Alternatively, using Windows explorer, drag and dr=
op the webapp folder into the webapps
-folder whilst holding down the <ctrl> key. Then select the ''webapp'' fold=
er, hit F2, =

+      {{{Consider this: Alternatively, using Windows explorer, drag and dr=
op the webapp folder into the webapps
+folder whilst holding down the <ctrl> key. Then select the ''webapp'' fold=
er, hit F2, =

 and rename it ''cocoon''.}}}
 =

 17. ''Do this:'' '''Restart''' Tomcat from the services window:
@@ -147,18 +149,18 @@
 =

       {{{http://localhost:8080/cocoon/}}}
 =

-      {{{Consider this: The first time you run Cocoon, it will take some t=
ime to compile. You can create a more lean =

-and mean Cocoon by creating and editing the files =

-local.build.properties =

-and =

+      {{{Consider this: The first time you run Cocoon, it will take some t=
ime to compile. You can create a more lean =

+and mean Cocoon by creating and editing the files =

+local.build.properties =

+and =

 local.blocks.properties.}}}
 =

 19. ''Do this:'' '''Delete''' the source if you desire to save space and k=
eep things tidy.
 =

       {{{rd /S c:\cocoon-2.1.3}}}
 =

-      {{{Consider this: If you choose to keep the source and rebuild Cocoo=
n later, you will have to clear out =

-the build directory by doing =

+      {{{Consider this: If you choose to keep the source and rebuild Cocoo=
n later, you will have to clear out =

+the build directory by doing =

 build clean}}}
 =

=20