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
NoServletContainerRequired. A basic installation of Cocoon for test or
development purposes 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'' environment
variables.
Right-click {{{My Computer > Properties > Advanced > Environment
variables... > 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 better
way is to install it as a Windows
+ {{{Consider this: This is only one way of running the server. A better
way is to install it as a Windows
service.}}}
5. ''Do this:'' '''View''' the default installation screen. The screen should
be available when you see the message[[BR]] ''INFO:Server startup in
<nnnnn>ms'', by visiting:
{{{http://localhost:8080/}}}
- {{{Consider this: Tomcat listens on port 8080 by default. Apache listens
on port 80 by default. Browsers
+ {{{Consider this: Tomcat listens on port 8080 by default. Apache listens
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 need
to run this batch file from another
+ {{{Consider this: Because the batch file appears to hang, you will need
to run this batch file from another
DOS window.}}}
7. ''Do this:'' '''Install''' Tomcat as a Windows service by running the batch
file provided.
@@ -97,22 +99,22 @@
{{{build}}}
- {{{Consider this: During this time there will be many disturbing warning
messages. You can see other build
-options by doing
+ {{{Consider this: During this time there will be many disturbing warning
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 tested
independently of a separately
+ {{{Consider this: Jetty is provided with Cocoon so that it can be tested
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 will
configure Cocoon to run with Tomcat
+ {{{Consider this: Jetty listens on port 8888, but in a moment, we will
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-tomcat-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
Cocoon.}}}
;:''This is changed with the latest release of Cocoon 2.1.4, so please check
for yourself'' -HvdL
@@ -133,8 +135,8 @@
{{{xcopy c:\cocoon-2.1.3\build\webapp
c:\jakarta-tomcat-5.0.18\webapps\cocoon /D /S /V /I /F}}}
- {{{Consider this: Alternatively, using Windows explorer, drag and drop
the webapp folder into the webapps
-folder whilst holding down the <ctrl> key. Then select the ''webapp'' folder,
hit F2,
+ {{{Consider this: Alternatively, using Windows explorer, drag and drop
the webapp folder into the webapps
+folder whilst holding down the <ctrl> key. Then select the ''webapp'' folder,
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 time
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 time
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 keep
things tidy.
{{{rd /S c:\cocoon-2.1.3}}}
- {{{Consider this: If you choose to keep the source and rebuild Cocoon
later, you will have to clear out
-the build directory by doing
+ {{{Consider this: If you choose to keep the source and rebuild Cocoon
later, you will have to clear out
+the build directory by doing
build clean}}}
