stefano 00/08/17 15:33:15
Modified: xdocs livesites.xml
Added: xdocs installation-case-windows-2000.xml
installation-case-solaris-8.xml
Log:
added new installation cases and updated livesites
Revision Changes Path
1.7 +1 -0 xml-cocoon/xdocs/livesites.xml
Index: livesites.xml
===================================================================
RCS file: /home/cvs/xml-cocoon/xdocs/livesites.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- livesites.xml 2000/08/05 22:45:37 1.6
+++ livesites.xml 2000/08/17 22:33:15 1.7
@@ -28,6 +28,7 @@
<li><link
href="http://www.xmltimes.com/";>http://www.xmltimes.com</link></li>
<li><link
href="http://www.nakapeida.com/";>http://www.nakapeida.com</link></li>
<li><link
href="http://www.myerealtor.com/";>http://www.myerealtor.com</link></li>
+ <li><link
href="http://politics.smallworld.com/";>http://politics.smallworld.com</link></li>
<!--<li><link href=""></link></li>-->
</ul>
1.1 xml-cocoon/xdocs/installation-case-windows-2000.xml
Index: installation-case-windows-2000.xml
===================================================================
<?xml version="1.0"?>
<!DOCTYPE document SYSTEM "./dtd/document-v10.dtd">
<document>
<header>
<title>Cocoon Installation Case</title>
<authors>
<person name="Mark Evans" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<s1 title="Introduction - Cocoon Installation Case (Windows 2000)">
<p>
I have successfully been able to get <strong>Cocoon V1.7.4</strong> to
work with the following combination
of software :
</p>
<ul>
<li><strong>Jakarta-Tomcat V3.1</strong></li>
<li><strong>Apache Web Server V1.3.12</strong></li>
<li><strong>Sun Java SDK SE V1.3</strong></li>
<li><strong>Windows 2000 Professional</strong></li>
<li><strong>Microsoft Internet Explorer V5.50.4134.0600</strong></li>
</ul>
<p>
This information could be added to the <strong>Working Systems</strong>
table within the
Cocoon installation document at
<code>http://xml.apache.org/cocoon/install.html</code>.
</p>
<p>
What follows is some step by step info on how I got it all working. I am
submitting this
for two reasons: one, as a reference for me for installations on other
machines at a later
date and two, to provide some help to poor (hardware) engineers like
myself who expect install
instructions to include <strong>every</strong> step to actually get the
product working !!
</p>
<p>
Hope this is useful to someone.
</p>
</s1>
<s1 title="How to do it !">
<p>
I followed the standard Cocoon install instructions but without success.
(Most of it is
there but it could be a bit clearer.)
</p>
<p>
I have listed below the <strong>key</strong> steps that actually got the
combination shown
above to work.
</p>
<p>
I have included sections on installing Java SDK, Apache and
Jakarta-Tomcat to avoid
any possible ambiguity. So, there may be more detail than is actually
required - but
why not - as long as it all works in the end !
</p>
<p>
The relevant sections of the modified files mentioned have been partially
listed.
</p>
<p>
The steps listed below mention my own machine name and my own specific
paths. Substitute
your own naturally. I thought it was better to leave them in to avoid the
"path to your..."
directives which can sometimes be ambiguous when it comes to how paths
are specified within
the Windows environment i.e forward ("/") and backward slashes ("\") etc
..
</p>
<note>
Warning : This is long and verbose ! The steps and file listings should
be read in the order given i.e top
down to bottom.
</note>
<note>
Before I started this setup on my machine, I did not have any pre-existing
Java SDK, Apache Web Server, Jakarta-Tomcat, Cocoon, or even anything in
the
<code>CLASSPATH </code> env variable. It was a completely new install on
a fresh Windows
2000 Professional machine.
</note>
<p>
OK lets go....
</p>
</s1>
<s1 title="Java SDK SE V1.3">
<ul>
<li>Install Sun Java SDK SE V1.3 via the standard install procedure i.e
execute the <code>.exe</code> file.</li>
<li>I chose to install at path <code>C:\Program_Files\jdk1.3</code> -
Note the underscore in <code>Program_Files</code>.</li>
<li>No worries !</li>
</ul>
</s1>
<s1 title="Apache V1.3.12 HTTP Server">
<ul>
<li>Install Apache V1.3.12 via the standard install procedure i.e execute
the <code>.exe</code> file.</li>
<li>I chose to install at path <code>C:\Program_Files\Apache
Group</code></li>
<li>Modify the <code>C:\Program_Files\Apache
Group\Apache\conf\httpd.conf</code> file to
include your machine DNS name. See code segment below.</li>
<li><strong>Note:</strong> Your system may already have a number of
<code>http</code> servers running. This
is OK as long as there isn't a port clash. Ensure other httpd servers
are <strong>not</strong>
also using port <code>80</code>.</li>
<li>Run the <strong>Install Apache as a Service</strong> program from the
<strong>Apache Web Server</strong> menu of the
Windows 2000 Start Menu.</li>
<li>Ensure Apache is actually running by opening up the Windows 2000
<strong>Control panel</strong>,
double-left-clicking on <strong>Administrative Tools</strong> and
through the <strong>Services</strong> program,
highlight the <strong>Apache</strong> service and menu select
<code>Action|Start</code> i.e start Apache.</li>
<li>Try and access <code>http://shaggy.blimp.au</code>. You should get the
standard <strong>"If you can see this, it means that the installation
of the Apache
web server software on this system was successful"</strong> page.</li>
<li>No worries!</li>
</ul>
<p><code>C:\Program_Files\Apache Group\Apache\conf\httpd.conf</code></p>
<source><![CDATA[
....................
#
# ServerName allows you to set a host name which is sent back to clients
for
# your server if it's different than the one the program would get
(i.e., use
# "www" instead of the host's real name).
#
# Note: You cannot just invent host names and hope they work. The name
you
# define here must be a valid DNS name for your host. If you don't
understand
# this, ask your network administrator.
# If your host doesn't have a registered DNS name, enter its IP address
here.
# You will have to access it by its address (e.g., http://123.45.67.89/)
# anyway, and this will make redirections work in a sensible way.
#
ServerName shaggy.blimp.au
....................
#
# Port: The port to which the standalone server listens. For
# ports < 1023, you will need httpd to be run as root initially.
#
Port 80
....................
]]></source>
</s1>
<s1 title="Jakarta-Tomcat V3.1">
<ul>
<li>Install Jakarta-Tomcat via the standard install procedure.</li>
<li>I chose to install (i.e unpack the zip) at path
<code>C:\Program_Files\jakarta-tomcat</code> - Note
the underscore in <code>Program_Files</code>.</li>
<li>Go back to the Apache web site and grab the
<code>ApacheModuleJServ.dll</code> file within the
<code>http://jakarta.apache.org/builds/tomcat/release/v3.1/bin/win32/i386/</code>
directory.</li>
<li>Copy this file into the <code>C:\Program_Files\Apache
Group\Apache\modules</code> directory.</li>
<li>Modify the Apache <code>httpd.conf</code> file to add the line
"<code>include C:/Program_Files/jakarta-tomcat/conf/tomcat-apache.conf</code>"
to the end of <code>httpd.conf</code>. See code segment below. Note
the forward "<code>/</code>" slashes in the path name. Note that the
<code>tomcat-apache</code> file is automatically created when
Jakarta-Tomcat starts.</li>
<li>Modify <code>C:\Program_Files\jakarta-tomcat\bin\tomcat.bat</code> to
add env variables <code>TOMCAT_HOME</code>
and <code>JAVA_HOME</code>. See code segment below.</li>
<li>Open up the Windows 2000 <strong>Control Panel</strong>,
double-left-click <strong>Administrative Tools</strong>
and execute the <strong>Services</strong> program.</li>
<li>Kill Apache - highlight the <strong>Apache</strong> service and menu
select <code>Action|Stop</code> i.e stop Apache.</li>
<li>Now open up a Windows 2000 <strong>Command Prompt</strong> and cd to
directory - <code>C:\Program_Files\jakarta-tomcat\bin</code></li>
<li>Type <code>tomcat start</code>. Jakarta-Tomcat should start up in
another Command Prompt window.</li>
<li>Go back to the Windows 2000 <strong>Services</strong> program and
start the <strong>Apache</strong> service i.e <code>Action|Start</code>.</li>
<li>Start Internet Explorer.</li>
<li>Try and access the Jakarta-Tomcat <em>JSP</em> test page
<code>http://shaggy.blimp.au:8080/examples/jsp/</code>
- Note the <code>8080</code> port in the address.</li>
<li>Click on any of the JSP examples to test.</li>
<li>Try and access the Jakarta-Tomcat <em>Servlet</em> test page
<code>http://shaggy.blimp.au:8080/examples/servlets/</code>
- Note the <code>8080</code> port in the address.</li>
<li>Click on any of the servlet examples to test.</li>
<li>Note: You <strong>don't</strong> have to copy the Jakarta-Tomcat
<code>C:\Program_Files\jakarta-tomcat\webapps\examples</code> directory to the
Apache <code>C:\Program_Files\Apache Group\Apache\htdocs</code>
directory. Due to the <code>8080</code> port in the
web addresses shown above, the files in directory
<code>C:\Program_Files\jakarta-tomcat\webapps\examples</code>
are actually referenced automatically by Jakarta-Tomcat.</li>
<li>No worries !</li>
</ul>
<p><code>C:\Program_Files\Apache Group\Apache\conf\httpd.conf</code></p>
<source><![CDATA[
...........
#
# VirtualHost example:
# Almost any Apache directive may go into a VirtualHost container.
#
#<VirtualHost ip.address.of.host.some_domain.com>
# ServerAdmin [EMAIL PROTECTED]
# DocumentRoot /www/docs/host.some_domain.com
# ServerName host.some_domain.com
# ErrorLog logs/host.some_domain.com-error_log
# CustomLog logs/host.some_domain.com-access_log common
#</VirtualHost>
#<VirtualHost _default_:*>
#</VirtualHost>
include C:/Program_Files/jakarta-tomcat/conf/tomcat-apache.conf
]]></source>
<p><code>C:\Program_Files\jakarta-tomcat\bin\tomcat.bat</code></p>
<source><![CDATA[
@echo off
rem A batch file to start/stop tomcat server.
rem This batch file written and tested under Windows NT
rem Improvements to this file are welcome
rem Guess TOMCAT_HOME if it is not present
set TOMCAT_HOME=C:\Program_Files\jakarta-tomcat
set JAVA_HOME=C:\Program_Files\jdk1.3
.........
]]></source>
</s1>
<s1 title="Cocoon V1.7.4">
<ul>
<li>Install Cocoon via the standard install procedure.</li>
<li>I chose to install (i.e unpack the zip) at path
<code>C:\Program_Files\cocoon-1.7.4</code> - Note
the underscore in <code>Program_Files.</code><em>(Actually the
important files in the Cocoon
distribution all end up being copied into the working Jakarta-Tomcat
directories, so the unzipped
Cocoon can be either deleted or left where it is after the files have
been copied.)</em></li>
<li>Copy the <code>xerces_1_0_3.jar</code>, <code>xalan_1_0_1.jar</code>,
<code>fop_0_12_1.jar</code> and <code>servlet_2_2.jar</code>
files, found in the <code>C:\Program_Files\cocoon-1.7.4\lib</code> to
the
<code>C:\Program_Files\jakarta-tomcat\lib</code> directory.</li>
<li>Copy the <code>C:\Program_Files\cocoon-1.7.4\bin\cocoon.jar</code>
file to the
<code>C:\Program_Files\jakarta-tomcat\lib</code> directory.</li>
<li>Modify <code>C:\Program_Files\jakarta-tomcat\bin\tomcat.bat</code> to
add the five Cocoon <code>.jar</code>
files to the Jakarta-Tomcat <code>CLASSPATH</code> env variable. See
code segment below.</li>
<li>Note the "<code>remed</code>" out <code>set
CLASSPATH=%CLASSPATH%;%TOMCAT_HOME%\lib\servlet.jar</code> line.</li>
<li>Modify the <code>C:\Program_Files\jakarta-tomcat\conf\web.xml</code>
file to add the Cocoon
specific configuration directives. See code segment below.</li>
<li>And now for the <strong>really really</strong> important step, copy
the
<code>C:\Program_Files\cocoon-1.7.4\conf\cocoon.properties</code>
file to the
<code>C:\Program_Files\jakarta-tomcat\webapps\ROOT</code>
directory.</li>
<li>Now, if everything has been performed as specified above and if the
gods
are smiling on you today, then (and you'll hate me if it doesn't) it
should
all work now.</li>
<li>OK. To test it all, do the following :</li>
<li>If Jakarta-Tomcat is still running, then kill it by typing
<code>tomcat stop</code> in a
Windows 2000 <strong>Command Prompt</strong> window which has been
cded to <code>C:\Program_Files\jakarta-tomcat\bin</code>.</li>
<li>If Apache is still running, then kill it by menu selecting
<code>Action|Stop</code>
through the Windows 2000 <strong>Services</strong> program.</li>
<li>Now, start up Jakarta-Tomcat as detailed in the
<strong>Jakarta-Tomcat V3.1</strong> section shown above.</li>
<li>Now, start up Apache as detailed in the <strong>Apache V1.3.12 HTTP
Server</strong> section shown above.</li>
<li>Start Internet Explorer.</li>
<li>The big test - try and access
<code>http://shaggy.blimp.au:8080/Cocoon.xml</code> - You
should see the Cocoon V1.7.4 status page containing all of the
internal configuration
information and settings specific to Cocoon. Note the
<code>8080</code> port number.</li>
<li>Note the uppercase "<code>C</code>" in <code>Cocoon.xml</code>. Also,
you won't find this file on the
hard disk, it is an internal page and its name is set in the
<code>cocoon.properties</code>
file.</li>
<li>OK, if the internal Cocoon status page is working then you can try
and access the
Cocoon examples as follows :</li>
<li>Copy the <code>C:\Program_Files\cocoon-1.7.4\samples</code> directory
to the
<code>C:\Program_Files\jakarta-tomcat\webapps</code> directory.</li>
<li>Copy the <code>cocoon.properties</code> file to the new
<code>C:\Program_Files\jakarta-tomcat\webapps\samples</code>
directory - again this is a <strong>really</strong> important
step.</li>
<li>Kill Jakarta-Tomcat.</li>
<li>Kill Apache.</li>
<li>Restart Jakarta-Tomcat.</li>
<li>Restart Apache.</li>
<li>Try and access
<code>http://shaggy.blimp.au:8080/samples/index.xml</code>. Note the
<code>8080</code> port number.</li>
<li>You should see the Cocoon samples page.</li>
<li>Thats it.</li>
<li>Again, note that no files were copied into the
<code>C:\Program_Files\Apache Group\Apache\htdocs</code>
directory. The Cocoon samples are found via Jakarta-Tomcat and port
<code>8080</code>.</li>
<li>One last thing to try. Create a directory called
<code>C:\Program_Files\jakarta-tomcat\webapps\gogo</code>.</li>
<li>Copy the Cocoon <code>hello-page.xml</code> and
<code>hello-page-html.xsl</code> files found in the
<code>C:\Program_Files\cocoon-1.7.4\samples\hello</code> directory
into the new <code>gogo</code> directory.</li>
<li>And again the <strong>really</strong> important step, copy the
<code>cocoon.properties</code> file into the
new <code>gogo</code> directory.</li>
<li>Kill Jakarta-Tomcat.</li>
<li>Kill Apache.</li>
<li>Restart Jakarta-Tomcat.</li>
<li>Restart Apache.</li>
<li>Start Internet Explorer.</li>
<li>Try and access
<code>http://shaggy.blimp.au:8080/gogo/hello.xml</code>.</li>
<li>You should see the Hello Page.</li>
<li>The purpose of the last few steps was to show how a new auto context
can be
setup in the Jakarta-Tomcat <code>webapps</code> directory.
As I see it, put your own custom XML/XSL files in a directory that
lives within the Jakarta-Tomcat
<code>webapps</code> directory. Make sure
<code>cocoon.properites</code> is also in there.</li>
<li>You could also put your custom XML/XSL work into just the
Jakarta-Tomcat <code>webapps/ROOT</code> directory and
as long as <code>cocoon.properties</code> is also in there (which it
should be or else you won't be able
to see the internal <code>Cocoon.xml</code> status page) then it
should all work from that <code>ROOT</code> directory.</li>
<li>In order to avoid Jakarta-Tomcat having to serve up everything on
port <code>8080</code>, the
<code>C:\Program_Files\jakarta-tomcat\conf\tomcat-apache.conf</code>
file can be modified by adding
the lines "<code>AddType text/xml .xml</code>" and "<code>AddHandler
jserv-servlet .xml</code>". (Refer to the start of the listing for
<code>C:\Program_Files\jakarta-tomcat\conf\tomcat-apache-cocoon.conf</code>
below to see where the line should be.)</li>
<li>After starting/stopping Jakarta-Tomcat and Apache in the same manner
as described above you should now
be able to access XML files without specifying port
<code>8080</code>. e.g <code>http://shaggy.blimp.au/samples/index.xml</code>.
<strong>Note :</strong> If your browser cannot find the file then make
sure your <code>C:\Program_Files\jakarta-tomcat\conf\server.xml</code>
file has alias directives for the <code>samples</code> directory or
follow the procedure in the next few steps.</li>
<li><strong>Note :</strong> You must be careful when making modifications
to <code>C:\Program_Files\jakarta-tomcat\conf\tomcat-apache.conf</code>
because this file is automatically generated each time Jakarta-Tomcat
starts and will therefore overwrite any
modifications you have made. To complicate matters, the contents of
<code>C:\Program_Files\jakarta-tomcat\conf\server.xml</code>,
where you might specify some context "AutoSetup actions", determines
some of the content of
<code>C:\Program_Files\jakarta-tomcat\conf\tomcat-apache.conf</code>,
so simply making a once off copy of
<code>C:\Program_Files\jakarta-tomcat\conf\tomcat-apache.conf</code>
and adding the "<code>AddHandler jserv-servlet .xml</code>"
line and referencing the copied <code>.conf</code> file with the
<code>include</code> statement in
<code>C:\Program_Files\Apache Group\Apache\conf\httpd.conf</code> may
also lead to problems.</li>
<li>My solution was to eliminate all context AutoSetup actions in
<code>C:\Program_Files\jakarta-tomcat\conf\server.xml</code>, then copy
a freshly generated version of
<code>C:\Program_Files\jakarta-tomcat\conf\tomcat-apache.conf</code> to
<code>C:\Program_Files\jakarta-tomcat\conf\tomcat-apache-cocoon.conf</code>,
then
add the line "<code>AddHandler jserv-servlet .xml</code>" to
<code>C:\Program_Files\jakarta-tomcat\conf\tomcat-apache-cocoon.conf</code>,
then
modify the include statement in <code>C:\Program_Files\Apache
Group\Apache\conf\httpd.conf</code> to read
"<code>include
C:/Program_Files/jakarta-tomcat/conf/tomcat-apache-cocoon.conf</code>". This
method places the onus on the webmaster
to make sure the copied and modified version of
<code>C:\Program_Files\jakarta-tomcat\conf\tomcat-apache-cocoon.conf</code> is
always
up to date. See code segment below.</li>
<li>I have listed my simplified
<code>C:\Program_Files\jakarta-tomcat\conf\server.xml</code> file. Note the
references to my test <code>gogo</code>
directory in file
<code>C:\Program_Files\jakarta-tomcat\conf\tomcat-apache-cocoon.conf</code>
which are needed in order to get the
<code>hello-page.xml</code> example working without using port
<code>8080</code> in the address. See code segment below.</li>
<li>Well, thats how I got it to work.</li>
<li>Works for me and I hope for you too.</li>
<li>Sorry for all the completely specfied file and directory paths, but
it should at least be unambiguous. No worries !</li>
</ul>
<p><code>C:\Program_Files\jakarta-tomcat\bin\tomcat.bat</code></p>
<source><![CDATA[
.................
set cp=%CLASSPATH%
set CLASSPATH=.
set CLASSPATH=%TOMCAT_HOME%\classes
set CLASSPATH=%CLASSPATH%;%TOMCAT_HOME%\lib\xerces_1_0_3.jar
set CLASSPATH=%CLASSPATH%;%TOMCAT_HOME%\lib\xalan_1_0_1.jar
set CLASSPATH=%CLASSPATH%;%TOMCAT_HOME%\lib\fop_0_12_1.jar
set CLASSPATH=%CLASSPATH%;%TOMCAT_HOME%\lib\servlet_2_2.jar
set CLASSPATH=%CLASSPATH%;%TOMCAT_HOME%\lib\cocoon.jar
set CLASSPATH=%CLASSPATH%;%TOMCAT_HOME%\lib\webserver.jar
set CLASSPATH=%CLASSPATH%;%TOMCAT_HOME%\lib\jasper.jar
set CLASSPATH=%CLASSPATH%;%TOMCAT_HOME%\lib\xml.jar
rem set CLASSPATH=%CLASSPATH%;%TOMCAT_HOME%\lib\servlet.jar
set CLASSPATH=%CLASSPATH%;%JAVA_HOME%\lib\tools.jar
.................
]]></source>
<p><code>C:\Program_Files\jakarta-tomcat\conf\web.xml</code></p>
<source><![CDATA[
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN"
"http://java.sun.com/j2ee/dtds/web-app_2.2.dtd";>
<web-app>
<servlet>
<servlet-name>
default
</servlet-name>
<servlet-class>
org.apache.tomcat.servlets.DefaultServlet
</servlet-class>
<load-on-startup>
-2147483646
</load-on-startup>
</servlet>
<servlet>
<servlet-name>
invoker
</servlet-name>
<!--
org.apache.tomcat.servlets.NoInvokerServlet
-->
<servlet-class>
org.apache.tomcat.servlets.InvokerServlet
</servlet-class>
</servlet>
<servlet>
<servlet-name>
jsp
</servlet-name>
<servlet-class>
org.apache.jasper.runtime.JspServlet
</servlet-class>
<!-- uncomment the following to use Jikes for JSP compilation
<init-param>
<param-name>jspCompilerPlugin</param-name>
<param-value>org.apache.jasper.compiler.JikesJavaCompiler</param-value>
</init-param>
-->
<load-on-startup>
-2147483646
</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>
invoker
</servlet-name>
<url-pattern>
/servlet/*
</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>
jsp
</servlet-name>
<url-pattern>
*.jsp
</url-pattern>
</servlet-mapping>
<session-config>
<session-timeout>
30
</session-timeout>
</session-config>
<!-- Start Cocoon Section -->
<servlet>
<servlet-name>org.apache.cocoon.Cocoon</servlet-name>
<servlet-class>org.apache.cocoon.Cocoon</servlet-class>
<init-param>
<param-name>properties</param-name>
<param-value>
cocoon.properties
</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>org.apache.cocoon.Cocoon</servlet-name>
<url-pattern>*.xml</url-pattern>
</servlet-mapping>
<!-- End Cocoon Section -->
<mime-mapping>
<extension>
txt
</extension>
<mime-type>
text/plain
</mime-type>
</mime-mapping>
..........
]]></source>
<p><code>C:\Program_Files\jakarta-tomcat\conf\tomcat-apache-cocoon.conf</code></p>
<source><![CDATA[
LoadModule jserv_module modules/ApacheModuleJServ.dll
ApJServManual on
ApJServDefaultProtocol ajpv12
ApJServSecretKey DISABLED
ApJServMountCopy on
ApJServLogLevel notice
ApJServDefaultPort 8007
AddType text/xml .xml
AddHandler jserv-servlet .xml
AddType test/jsp .jsp
AddHandler jserv-servlet .jsp
Alias /examples C:\Program_Files\jakarta-tomcat\webapps\examples
<Directory "C:\Program_Files\jakarta-tomcat\webapps\examples">
Options Indexes FollowSymLinks
</Directory>
ApJServMount /examples/servlet /examples
<Location /examples/WEB-INF/ >
AllowOverride None
deny from all
</Location>
Alias /test C:\Program_Files\jakarta-tomcat\webapps\test
<Directory "C:\Program_Files\jakarta-tomcat\webapps\test">
Options Indexes FollowSymLinks
</Directory>
ApJServMount /test/servlet /test
<Location /test/WEB-INF/ >
AllowOverride None
deny from all
</Location>
Alias /admin C:\Program_Files\jakarta-tomcat\webapps\admin
<Directory "C:\Program_Files\jakarta-tomcat\webapps\admin">
Options Indexes FollowSymLinks
</Directory>
ApJServMount /admin/servlet /admin
<Location /admin/WEB-INF/ >
AllowOverride None
deny from all
</Location>
Alias /samples C:\Program_Files\jakarta-tomcat\webapps\samples
<Directory "C:\Program_Files\jakarta-tomcat\webapps\samples">
Options Indexes FollowSymLinks
</Directory>
ApJServMount /samples/servlet /samples
<Location /samples/WEB-INF/ >
AllowOverride None
deny from all
</Location>
Alias /gogo C:\Program_Files\jakarta-tomcat\webapps\gogo
<Directory "C:\Program_Files\jakarta-tomcat\webapps\gogo">
Options Indexes FollowSymLinks
</Directory>
ApJServMount /gogo/servlet /gogo
<Location /gogo/WEB-INF/ >
AllowOverride None
deny from all
</Location>
ApJServMount /servlet /ROOT
]]></source>
<p><code>C:\Program_Files\jakarta-tomcat\conf\server.xml</code></p>
<source><![CDATA[
<?xml version="1.0" encoding="ISO-8859-1"?>
<Server>
<!-- Debug low-level events in XmlMapper startup -->
<xmlmapper:debug level="0" />
<!-- This is quite flexible; we can either have a log file per
module in Tomcat (example: ContextManager) or we can have
one for Servlets and one for Jasper, or we can just have
one tomcat.log for both Servlet and Jasper.
If you omit "path" there, then stderr should be used.
verbosityLevel values can be:
FATAL
ERROR
WARNING
INFORMATION
DEBUG
-->
<Logger name="tc_log"
path="logs/tomcat.log"
customOutput="yes" />
<Logger name="servlet_log"
path="logs/servlet.log"
customOutput="yes" />
<Logger name="JASPER_LOG"
path="logs/jasper.log"
verbosityLevel = "INFORMATION" />
<!-- Add "home" attribute if you want tomcat to be based on a
different directory
"home" is used to create work and to read webapps, but not for
libs or CLASSPATH.
Note that TOMCAT_HOME is where tomcat is installed, while
ContextManager home is the
base directory for contexts, webapps/ and work/
-->
<ContextManager debug="0" workDir="work" >
<!-- ContextInterceptor
className="org.apache.tomcat.context.LogEvents" / -->
<ContextInterceptor
className="org.apache.tomcat.context.AutoSetup" />
<ContextInterceptor
className="org.apache.tomcat.context.DefaultCMSetter" />
<ContextInterceptor
className="org.apache.tomcat.context.WorkDirInterceptor" />
<ContextInterceptor
className="org.apache.tomcat.context.WebXmlReader" />
<ContextInterceptor
className="org.apache.tomcat.context.LoadOnStartupInterceptor" />
<!-- Request processing -->
<RequestInterceptor
className="org.apache.tomcat.request.SimpleMapper" debug="0" />
<RequestInterceptor
className="org.apache.tomcat.request.SessionInterceptor" />
<RequestInterceptor
className="org.apache.tomcat.request.SecurityCheck" />
<RequestInterceptor
className="org.apache.tomcat.request.FixHeaders" />
<Connector
className="org.apache.tomcat.service.SimpleTcpConnector">
<Parameter name="handler"
value="org.apache.tomcat.service.http.HttpConnectionHandler"/>
<Parameter name="port" value="8080"/>
</Connector>
<Connector
className="org.apache.tomcat.service.SimpleTcpConnector">
<Parameter name="handler"
value="org.apache.tomcat.service.connector.Ajp12ConnectionHandler"/>
<Parameter name="port" value="8007"/>
</Connector>
</ContextManager>
</Server>
]]></source>
<p><code>C:\Program_Files\Apache Group\Apache\conf\httpd.conf</code></p>
<source><![CDATA[
...........
#
# VirtualHost example:
# Almost any Apache directive may go into a VirtualHost container.
#
#<VirtualHost ip.address.of.host.some_domain.com>
# ServerAdmin [EMAIL PROTECTED]
# DocumentRoot /www/docs/host.some_domain.com
# ServerName host.some_domain.com
# ErrorLog logs/host.some_domain.com-error_log
# CustomLog logs/host.some_domain.com-access_log common
#</VirtualHost>
#<VirtualHost _default_:*>
#</VirtualHost>
include C:/Program_Files/jakarta-tomcat/conf/tomcat-apache-cocoon.conf
]]></source>
</s1>
<s1 title="Hints and Tips">
<p>Being bit of a XML/XSL/JAVA etc novice, here are some hints that I now
know but it would have
made life a lot easier if I knew them before I attempted
Cocoon/Jakarta-Tomcat/Apache etc..</p>
<ul>
<li>Don't be fooled...use the refresh button on the web browser when
fiddling about. The cache is
your enemy in the early days !</li>
<li>Always stop/start Jakarta-Tomcat and Apache if you are
adding/deleting files from the Jakarta-Tomcat <code>webapps</code>
directory.</li>
<li>Understanding how Cocoon finds the <code>cocoon.properties</code>
file is the key.</li>
<li>In order to make the starting and stopping of
Apache/Jakarta-Tomcat/Cocoon a bit easier on my Windows 2000 Professional
machine, I created two
Command Prompt shortcuts on my main desktop. One is called "Start
Tomcat", the other is called "Stop Tomcat". These two shorcuts
both call <code>C:\Program_Files\jakarta-tomcat\bin\tomcat.bat</code>
but with different arguments i.e for "Start Tomcat" I use
<code>%SystemRoot%\system32\cmd.exe /c
"c:\program_files\jakarta-tomcat\bin\tomcat start"</code> and for "Stop Tomcat"
I use
<code>%SystemRoot%\system32\cmd.exe /c
"c:\program_files\jakarta-tomcat\bin\tomcat stop"</code>. The complete file
listing for
<code>C:\Program_Files\jakarta-tomcat\bin\tomcat.bat</code> is shown
below. I find these two shortcuts quite useful since they start and
stop the Apache service and Jakarta-Tomcat in the correct order and
generally just makes life a little easier.</li>
</ul>
<p>Regards - [EMAIL PROTECTED]</p>
<p><code>C:\Program_Files\jakarta-tomcat\bin\tomcat.bat</code></p>
<source><![CDATA[
@echo off
rem A batch file to start/stop tomcat server.
rem This batch file written and tested under Windows NT
rem Improvements to this file are welcome
rem Guess TOMCAT_HOME if it is not present
set TOMCAT_HOME=c:\program_files\jakarta-tomcat
set JAVA_HOME=c:\program_files\jdk1.3
if not "%TOMCAT_HOME%" == "" goto gothome
SET TOMCAT_HOME=.
if exist %TOMCAT_HOME%\bin\tomcat.bat goto gothome
SET TOMCAT_HOME=..
if exist %TOMCAT_HOME%\bin\tomcat.bat goto gothome
SET TOMCAT_HOME=
echo Unable to determine the value of TOMCAT_HOME.
goto eof
:gothome
rem Set up the CLASSPATH that we need
set cp=%CLASSPATH%
rem set CLASSPATH=.
set CLASSPATH=%TOMCAT_HOME%\classes
set CLASSPATH=%CLASSPATH%;%TOMCAT_HOME%\lib\xerces_1_0_3.jar
set CLASSPATH=%CLASSPATH%;%TOMCAT_HOME%\lib\xalan_1_0_1.jar
set CLASSPATH=%CLASSPATH%;%TOMCAT_HOME%\lib\fop_0_12_1.jar
set CLASSPATH=%CLASSPATH%;%TOMCAT_HOME%\lib\servlet_2_2.jar
set CLASSPATH=%CLASSPATH%;%TOMCAT_HOME%\lib\cocoon.jar
set CLASSPATH=%CLASSPATH%;%TOMCAT_HOME%\lib\webserver.jar
set CLASSPATH=%CLASSPATH%;%TOMCAT_HOME%\lib\jasper.jar
set CLASSPATH=%CLASSPATH%;%TOMCAT_HOME%\lib\xml.jar
rem set CLASSPATH=%CLASSPATH%;%TOMCAT_HOME%\lib\servlet.jar
set CLASSPATH=%CLASSPATH%;%JAVA_HOME%\lib\tools.jar
if "%cp%" == "" goto next
rem else
set CLASSPATH=%CLASSPATH%;%cp%
:next
if "%1" == "start" goto startServer
if "%1" == "stop" goto stopServer
if "%1" == "run" goto runServer
if "%1" == "env" goto setupEnv
if "%1" == "ant" goto runAnt
if "%1" == "jspc" goto runJspc
echo Usage:
echo tomcat (start^|run^|env^|stop)
echo start - start tomcat in a separate window
echo run - start tomcat in the current window
echo env - setup the environment for tomcat
echo stop - stop tomcat
echo ant - run ant with tomcat context
echo jspc - run jsp pre compiler
goto cleanup
:startServer
echo __________________________
echo Stopping Apache Web Server
echo __________________________
net stop apache
rem echo Using classpath: %CLASSPATH%
echo _______________________________________
echo Starting JAKARTA-TOMCAT in a new window
echo _______________________________________
start "TOMCAT is RUNNING" /min java %TOMCAT_OPTS%
-Dtomcat.home="%TOMCAT_HOME%" org.apache.tomcat.startup.Tomcat %2 %3 %4 %5 %6
%7 %8 %9
echo __________________________
echo Starting Apache Web Server
echo __________________________
net start apache
goto cleanup
:runServer
rem Start the Tomcat Server
echo Using classpath: %CLASSPATH%
java %TOMCAT_OPTS% -Dtomcat.home="%TOMCAT_HOME%"
org.apache.tomcat.startup.Tomcat %2 %3 %4 %5 %6 %7 %8 %9
goto cleanup
:stopServer
rem Stop the Tomcat Server
rem echo Using classpath: %CLASSPATH%
echo ______________________
echo Sopping JAKARTA-TOMCAT
echo ______________________
java %TOMCAT_OPTS% -Dtomcat.home="%TOMCAT_HOME%"
org.apache.tomcat.startup.Tomcat -stop %2 %3 %4 %5 %6 %7 %8 %9
goto cleanup
:runAnt
rem Run ant
set CLASSPATH=%CLASSPATH%;%TOMCAT_HOME%\lib\ant.jar
echo Using classpath: %CLASSPATH%
java %ANT_OPTS% -Dant.home="%TOMCAT_HOME%" -Dtomcat.home="%TOMCAT_HOME%"
org.apache.tools.ant.Main %2 %3 %4 %5 %6 %7 %8 %9
goto cleanup
:runJspc
rem Run ant
echo Using classpath: %CLASSPATH%
java %JSPC_OPTS% -Dtomcat.home="%TOMCAT_HOME%" org.apache.jasper.JspC %2
%3 %4 %5 %6 %7 %8 %9
goto cleanup
:setupEnv
set cp=%CLASSPATH%
:cleanup
rem clean up
set CLASSPATH=%cp%
set port=
set host=
set test=
set jsdkJars=
set jspJars=
set beanJars=
set miscJars=
set appJars=
set appClassPath=
set cp=
rem pause
:eof
]]></source>
</s1>
</body>
</document>
1.1 xml-cocoon/xdocs/installation-case-solaris-8.xml
Index: installation-case-solaris-8.xml
===================================================================
<?xml version="1.0"?>
<!DOCTYPE document SYSTEM "./dtd/document-v10.dtd">
<document>
<header>
<title>Cocoon Installation Case</title>
<authors>
<person name="Mark Evans" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<s1 title="Introduction - Cocoon Installation Case (Solaris 8)">
<p>
I have successfully been able to get <strong>Cocoon V1.7.4</strong> to
work with the following combination
of software :
</p>
<ul>
<li><strong>Jakarta-Tomcat V3.1</strong></li>
<li><strong>Apache HTTP Server V1.3.12</strong></li>
<li><strong>Sun Java SDK SE V1.3 Beta Refresh</strong></li>
<li><strong>Solaris 8 (SPARC)</strong></li>
<li><strong>Netscape Navigator V4.7</strong></li>
</ul>
<p>
The additional tools listed below are required to perform this
installation :
</p>
<ul>
<li><strong>gcc V2.95.2</strong></li>
<li><strong>make V3.79</strong></li>
<li><strong>perl V5.005_03</strong></li>
<li><strong>Jakarta-Ant V1.0.8 - 2000/03/04</strong></li>
<li><strong>Jakarta-Tools</strong></li>
</ul>
<p>
This information could be added to the <strong>Working Systems</strong>
table within the
Cocoon installation document at
<code>http://xml.apache.org/cocoon/install.html</code>.
</p>
<p>
What follows is some step by step info on how I got it all working. I am
submitting this
for two reasons: one, as a reference for me for installations on other
machines at a later
date and two, to provide some help to poor (hardware) engineers like
myself who expect install
instructions to include <strong>every</strong> step to actually get the
product working !!
</p>
<p>
Hope this is useful to someone.
</p>
</s1>
<s1 title="How to do it !">
<p>
I followed the standard Cocoon install instructions but without success.
(Most of it is
there but it could be a bit clearer.)
</p>
<p>
I have listed below the <strong>key</strong> steps that actually got the
combination shown
above to work.
</p>
<p>
I have included sections on installing Java SDK, Apache and
Jakarta-Tomcat to avoid
any possible ambiguity. So, there may be more detail than is actually
required - but
why not - as long as it all works in the end !
</p>
<p>
The relevant sections of the modified files mentioned have been partially
listed.
</p>
<p>
The steps listed below mention my own machine name and my own specific
paths. Substitute
your own naturally. I thought it was better to leave them in to avoid the
"path to your..."
directives which can sometimes be ambiguous when it comes to how paths
are specified within
the Windows and Solaris environments i.e forward ("/") and backward
slashes ("\") etc ..
</p>
<note>
Warning : This is long and verbose ! The steps and file listings should
be read in the order given i.e top
down to bottom.
</note>
<note>
Before I started this setup on my machine, I did not have any pre-existing
Jakarta-Tomcat, Cocoon, or even anything in the <code>CLASSPATH </code>
env variable. It was a
completely new install on a fresh Solaris 8 SPARC machine.
</note>
<p>
OK lets go....
</p>
</s1>
<s1 title="Java SDK SE V1.3 Beta Refresh">
<ul>
<li>A typical Solaris 8 install will install Java 1.1 and Java 1.2 by
default in the
<code>/usr/java1.1</code> and <code>/usr/java1.2</code> directories.
I, however, still
chose to install the latest Java SDK which was <em>"V1.3 Beta
Refresh"</em> at the time of
writing.</li>
<li>Install Sun Java SDK SE V1.3 Beta Refresh via the standard install
procedure i.e unpack the archive or
<code>pkgadd</code> the downloaded distribution. Install any required
patches.</li>
<li>I chose to install at path
<code>/usr/local/j2sdk1_3_0beta_refresh</code>. Installing Java at this
location avoids disturbing the existing Java 1.1 and 1.2 environments
mentioned above.</li>
<li>No worries !</li>
</ul>
</s1>
<s1 title="Apache V1.3.12 HTTP Server">
<ul>
<li>A typical Solaris 8 install will install Apache V1.3.9 by default in
the
<code>/usr/apache</code> and <code>/etc/apache</code> directories.
You may also find other Apache installations to support Sun's
SunSolve CD
or Sun's StorEdge LibMON programs. I, however, still chose to
install the
latest Apache HTTP server which was <em>"V1.3.12"</em> at the time
of writing.</li>
<li>Download the SOURCE for Apache V1.3.12 from the Apache web site -
<code>http://www.apache.org/dist/apache_1.3.12.tar.gz</code> and
unpack it in an area
where it can be compiled from e.g <code>/work/test/apache</code>.</li>
<li><strong>Note:</strong> I initially downloaded a pre-compiled binary of
Apache for Solaris 8 but
it did not have shared module (DSO) support enabled when it was
compiled, which
meant <code>mod_jserv.so</code> (needed for the Apache -
Jakarta-Tomcat combination) could not
be built (see Jakarta-Tomcat section for more details).</li>
<li>So, I had to compile Apache. This meant I needed a C compiler and
Perl.</li>
<li>Perl (V5.005_003) came with Solaris 8 as standard -
<code>/bin/perl</code>.</li>
<li>I downloaded a pre-compiled version of GNU gcc V2.95.2 for Solaris 8
from the web -
<code>ftp://nce.sun.ca/pub/freeware/sparc/8/gcc-2.95.2-sol8-sparc-local.gz</code>.</li>
<li>OK, to compile Apache with DSO support I used the following
commands:</li>
<li><code>cd /work/test/apache</code></li>
<li><code>./configure --prefix=/usr/local/apache --enable-module=all
--enable-shared=max --disable-module=auth_db</code></li>
<li><code>make</code></li>
<li><code>make install</code></li>
<li>This will compile Apache and install it in
<code>/usr/local/apache</code>.</li>
<li>Now, in order to build <code>mod_jserv.so</code> there is still one
more Apache related step,
which is to modify file <code>/usr/local/apache/bin/apxs</code>.
Modify the two lines as shown in
the code segment below.</li>
<li>If this is not done then the linker (<code>ld</code>) command is not
found and
dynamic shared objects (<code>-G</code>) are not produced.
<strong>This is important!</strong></li>
<li>I won't tell you how long it took me to work this out!</li>
<li>Modify the <code>/usr/local/apache/conf/httpd.conf</code> file to
include your machine DNS name and
that port <code>80</code> is assigned to this HTTP server. See code
segment below.</li>
<li><strong>Note:</strong> As was mentioned before, your system may
already have a number of <code>http</code> servers running. This
is OK as long as there isn't a port clash. Ensure other httpd servers
are <strong>not</strong>
also using port <code>80</code>.</li>
<li>Ensure Apache is actually working by starting it with -
<code>/usr/local/apache/bin/httpd -d /usr/local/apache</code></li>
<li>Try and access <code>http://shaggy.blimp.au</code>. You should get the
standard <strong>"If you can see this, it means that the installation
of the Apache
web server software on this system was successful"</strong> page.</li>
<li>No worries!</li>
</ul>
<p><code>/usr/local/apache/bin/apxs</code></p>
<source><![CDATA[
....................
my $CFG_LD_SHLIB = q(ld); # substituted via Makefile.tmpl
my $CFG_LDFLAGS_SHLIB = q(-G); # substituted via Makefile.tmpl
....................
]]></source>
<p><code>/usr/local/apache/conf/httpd.conf</code></p>
<source><![CDATA[
....................
#
# ServerName allows you to set a host name which is sent back to clients
for
# your server if it's different than the one the program would get
(i.e., use
# "www" instead of the host's real name).
#
# Note: You cannot just invent host names and hope they work. The name
you
# define here must be a valid DNS name for your host. If you don't
understand
# this, ask your network administrator.
# If your host doesn't have a registered DNS name, enter its IP address
here.
# You will have to access it by its address (e.g., http://123.45.67.89/)
# anyway, and this will make redirections work in a sensible way.
#
ServerName shaggy.blimp.au
....................
#
# Port: The port to which the standalone server listens. For
# ports < 1023, you will need httpd to be run as root initially.
#
Port 80
....................
]]></source>
</s1>
<s1 title="Jakarta-Tomcat V3.1">
<ul>
<li>Download the BINARY and SOURCE distributions of Jakarta-Tomcat from
the Jakarta web site.</li>
<li><strong>Note: </strong> Although the BINARY download of
Jakarta-Tomcat has a SRC
directory it does not contain ALL of the source files i.e the
"<code>native</code>"
directory is missing.</li>
<li><strong>You MUST download the SOURCE distribution for Jakarta-Tomcat
as a very
minimum in order to build </strong><code>mod_jserv.so</code>.</li>
<li>I did not have to <strong>actually</strong> compile Jakarta-Tomcat
itself since the <code>.jar</code>
files contained within the BINARY Jakarta-Tomcat distribution work
OK. So, I unpacked the BINARY
Jakarta-Tomcat distribution into directory
<code>/usr/local/jakarta-tomcat</code>.</li>
<li>But, since I had the Jakarta-Tomcat source, I had a go at building it
anyway. This worked
OK but I had to download the BINARY distributions of Jakarta-Ant and
Jakarta-Tools. <em>(You
may now realise why I said to download both the BINARY and SOURCE
distributions of Jakarta-Tomcat since
with the BINARY distribution of Jakarta-Tomcat you don't have to worry
about getting Jakarta-Ant
and Jakarta-Tools since you don't need to compile Jakarta-Tomcat unless
you are doing something
special with it.)</em></li>
<li>The BINARY distributions for Jakarta-Ant and Jakarta-Tools can be
found on the BINARY download page
for Jakarta-Tomcat. (<strong>Note:</strong> You cannot use the latest
Jakarta-Ant V1.1 from its download page. Only use the
Jakarta-Ant/Jakarta-Tools that can be downloaded on the very SAME
download page as Jakarta-Tomcat.)</li>
<li>OK, lets build <code>mod_jserv.so</code></li>
<li>Unpack the SOURCE distribution of Jakarta-Tomcat in a directory where
you can compile from e.g
<code>/work/test/jakarta-tomcat</code>. Now, <code>cd</code> into the
<code>/work/test/jakarta-tomcat/src/native/apache/jserv</code>
directory.</li>
<li>Execute : <code>/usr/local/apache/bin/apxs -c *.c</code></li>
<li>Execute : <code>cp autochange.so
/usr/local/apache/libexec/mod_jserv.so</code>. <em>(Yea, I know it
looks strange but just do it !</em>)</li>
<li>Add the following line "<code>include
/usr/local/jakarta-tomcat/conf/tomcat-apache.conf</code>" to
the Apache configuration file
<code>/usr/local/apache/conf/httpd.conf</code>. See code segment below.</li>
<li>File <code>/usr/local/jakarta-tomcat/conf/tomcat-apache.conf</code>
contains the reference
to <code>mod_jserv.so</code>.</li>
<li>Obviously, you can see that I unpacked all of the BINARY
Jakarta-Tomcat distribution into
<code>/usr/local/jakarta-tomcat</code>. i.e I did not actually compile
Jakarta-Tomcat.</li>
<li>Now, if you want or need to actually compile Jakarta-Tomcat then this
is how I did it.</li>
<li>Assuming the SOURCE distribution of Jakarta-Tomcat has been
unpacked.</li>
<li>Unpack the BINARY distribution of Jakarta-Ant.</li>
<li>Unpack the BINARY distribution of Jakarta-Tools.</li>
<li>My directory structure for building was :
<code>/work/test/jakarta-tomcat</code>,
<code>/work/test/jakarta-tools</code>,
<code>/work/test/jakarta-ant</code></li>
<li>Add the line
"<code>JAVA_HOME=/usr/local/j2sdk1_3_0beta_refresh</code>" to your
Jakarta-Tomcat
<code>/work/test/jakarta-tomcat/build.sh</code> file. See code segment
below.</li>
<li>Execute : <code>/work/test/jakarta-tomcat/build.sh dist</code></li>
<li>This will build ALL the files needed for Jakarta-Tomcat</li>
<li>After executing Jakarta-Tomcat's <code>build.sh</code> program the
resultant binary distribution is
put in directory : <code>/work/dist</code></li>
<li>To use your newly compiled Jakarta-Tomcat distribution you can copy
this to your Jakarta-Tomcat executing
directory (in my case <code>/usr/local/jakarta-tomcat</code>). (I
didn't need to build Jakarta-Tomcat,
so I'd already filled <code>/usr/local/jakarta-tomcat</code> with the
unpacked BINARY distribution of Jakarta-Tomcat.)</li>
<li>Modify <code>/usr/local/jakarta-tomcat/bin/tomcat.sh</code> to add
env variables <code>TOMCAT_HOME</code>
and <code>JAVA_HOME</code>. See code segment below.</li>
<li>Kill Apache - Execute : <code>kill -TERM `cat
/usr/local/apache/logs/httpd.pid`</code></li>
<li>Start Jakarta-Tomcat - Execute :
<code>/usr/local/jakarta-tomcat/tomcat.sh start</code></li>
<li>Start Apache - Execute : <code>/usr/local/apache/bin/httpd -d
/usr/local/apache</code></li>
<li>Start Netscape.</li>
<li>Try and access the Jakarta-Tomcat <em>JSP</em> test page
<code>http://shaggy.blimp.au:8080/examples/jsp/</code>
- Note the <code>8080</code> port in the address.</li>
<li>Click on any of the JSP examples to test.</li>
<li>Try and access the Jakarta-Tomcat <em>Servlet</em> test page
<code>http://shaggy.blimp.au:8080/examples/servlets/</code>
- Note the <code>8080</code> port in the address.</li>
<li>Click on any of the servlet examples to test.</li>
<li><strong>Note: </strong>You <strong>don't</strong> have to copy the
Jakarta-Tomcat <code>/usr/local/jakarta-tomcat/webapps/examples</code>
directory to the
Apache <code>/usr/local/apache/htdocs</code> directory. Due to the
<code>8080</code> port in the
web addresses shown above, the files in directory
<code>/usr/local/jakarta-tomcat/webapps/examples</code>
are actually referenced automatically by Jakarta-Tomcat.</li>
<li>No worries !</li>
</ul>
<p><code>/usr/local/apache/conf/httpd.conf</code></p>
<source><![CDATA[
...........
#
# VirtualHost example:
# Almost any Apache directive may go into a VirtualHost container.
#
#<VirtualHost ip.address.of.host.some_domain.com>
# ServerAdmin [EMAIL PROTECTED]
# DocumentRoot /www/docs/host.some_domain.com
# ServerName host.some_domain.com
# ErrorLog logs/host.some_domain.com-error_log
# CustomLog logs/host.some_domain.com-access_log common
#</VirtualHost>
#<VirtualHost _default_:*>
#</VirtualHost>
include /usr/local/jakarta-tomcat/conf/tomcat-apache.conf
]]></source>
<p><code>/work/test/jakarta-tomcat/build.sh</code></p>
<source><![CDATA[
#! /bin/sh
# $Id: installation-case-solaris-8.xml,v 1.1 2000/08/17 22:33:15 stefano
Exp $
JAVA_HOME=/usr/local/j2sdk1_3_0beta_refresh
if [ -z "$JAVA_HOME" ]
then
JAVACMD=`which java`
if [ -z "$JAVACMD" ]
then
echo "Cannot find JAVA. Please set your PATH."
exit 1
fi
JAVA_BINDIR=`dirname $JAVACMD`
JAVA_HOME=$JAVA_BINDIR/..
fi
JAVACMD=$JAVA_HOME/bin/java
cp=../jakarta-ant/lib/ant.jar:../jakarta-tools/moo.jar:../jakarta-ant/lib/xml.jar:../build/tomcat/classes:$JAVA_HOME/lib/tools.jar:$JAVA_HOME/lib/dev.jar
$JAVACMD -classpath $cp:$CLASSPATH org.apache.tools.ant.Main "$@"
]]></source>
<p><code>/usr/local/jakarta-tomcat/bin/tomcat.sh</code></p>
<source><![CDATA[
#!/bin/sh
#
# $Id: installation-case-solaris-8.xml,v 1.1 2000/08/17 22:33:15 stefano
Exp $
# Shell script to start and stop the server
# There are other, simpler commands to startup the runner. The two
# commented commands good replacements. The first works well with
# Java Platform 1.1 based runtimes. The second works well with
# Java2 Platform based runtimes.
TOMCAT_HOME=/usr/local/jakarta-tomcat
JAVA_HOME=/usr/local/j2sdk1_3_0beta_refresh
.........
]]></source>
</s1>
<s1 title="Cocoon V1.7.4">
<ul>
<li>I chose to install (i.e unpack the zip) at path
<code>/usr/local/cocoon-1.7.4</code>
<em>(Actually the important files in the Cocoon distribution all end
up being copied
into the working Jakarta-Tomcat directories, so the unpacked Cocoon
can be either
deleted or left where it is after the files have been
copied.)</em></li>
<li>Copy the <code>xerces_1_0_3.jar</code>, <code>xalan_1_0_1.jar</code>,
<code>fop_0_12_1.jar</code> and <code>servlet_2_2.jar</code>
files, found in the <code>/usr/local/cocoon-1.7.4/lib</code> to the
<code>/usr/local/jakarta-tomcat/lib</code> directory.</li>
<li>Copy the <code>/usr/local/cocoon-1.7.4/bin/cocoon.jar</code> file to
the
<code>/usr/local/jakarta-tomcat/lib</code> directory.</li>
<li>Modify <code>/usr/local/jakarta-tomcat/bin/tomcat.sh</code> to add
the five Cocoon <code>.jar</code>
files to the Jakarta-Tomcat <code>CLASSPATH</code> env variable. See
code segment below.</li>
<li>Note the commented out
"<code>#CLASSPATH=$CLASSPATH:$TOMCAT_HOME/lib/servlet.jar</code>" line.</li>
<li>Modify the <code>/usr/local/jakarta-tomcat/conf/web.xml</code> file
to add the Cocoon
specific configuration directives. See code segment below.</li>
<li>And now for the <strong>really really</strong> important step, copy
the
<code>/usr/local/cocoon-1.7.4/conf/cocoon.properties</code> file to
the
<code>/usr/local/jakarta-tomcat/webapps/ROOT</code> directory.</li>
<li>Now, if everything has been performed as specified above and if the
gods
are smiling on you today, then (and you'll hate me if it doesn't) it
should
all work now.</li>
<li>OK. To test it all, do the following :</li>
<li>If Jakarta-Tomcat is still running, then kill it by typing :
<code>/usr/local/jakarta-tomcat/bin/tomcat.sh stop</code></li>
<li>If Apache is still running, then kill it by typing : <code>kill -TERM
`cat /usr/local/apache/logs/httpd.pid`</code></li>
<li>Now, start up Jakarta-Tomcat as detailed in the
<strong>Jakarta-Tomcat V3.1</strong> section shown above.</li>
<li>Now, start up Apache as detailed in the <strong>Apache V1.3.12 HTTP
Server</strong> section shown above.</li>
<li>Start Netscape.</li>
<li>The big test - try and access
<code>http://shaggy.blimp.au:8080/Cocoon.xml</code> - You
should see the Cocoon V1.7.4 status page containing all of the
internal configuration
information and settings specific to Cocoon. Note the
<code>8080</code> port number.</li>
<li>Note the uppercase "<code>C</code>" in <code>Cocoon.xml</code>. Also,
you won't find this file on the
hard disk, it is an internal page and its name is set in the
<code>cocoon.properties</code>
file.</li>
<li>OK, if the internal Cocoon status page is working then you can try
and access the
Cocoon examples as follows :</li>
<li>Copy the <code>/usr/local/cocoon-1.7.4/samples</code> directory to the
<code>/usr/local/jakarta-tomcat/webapps</code> directory.</li>
<li>Copy the <code>cocoon.properties</code> file to the new
<code>/usr/local/jakarta-tomcat/webapps/samples</code>
directory - again this is a <strong>really</strong> important
step.</li>
<li>Kill Jakarta-Tomcat.</li>
<li>Kill Apache.</li>
<li>Restart Jakarta-Tomcat.</li>
<li>Restart Apache.</li>
<li>Try and access
<code>http://shaggy.blimp.au:8080/samples/index.xml</code>. Note the
<code>8080</code> port number.</li>
<li>You should see the Cocoon samples page.</li>
<li>Thats it.</li>
<li>Again, note that no files were copied into the
<code>/usr/local/apache/htdocs</code>
directory. The Cocoon samples are found via Jakarta-Tomcat and port
<code>8080</code>.</li>
<li>One last thing to try. Create a directory called
<code>/usr/local/jakarta-tomcat/webapps/gogo</code>.</li>
<li>Copy the Cocoon <code>hello-page.xml</code> and
<code>hello-page-html.xsl</code> files found in the
<code>/usr/local/cocoon-1.7.4/samples/hello</code> directory into the
new <code>gogo</code> directory.</li>
<li>And again the <strong>really</strong> important step, copy the
<code>cocoon.properties</code> file into the
new <code>gogo</code> directory.</li>
<li>Kill Jakarta-Tomcat.</li>
<li>Kill Apache.</li>
<li>Restart Jakarta-Tomcat.</li>
<li>Restart Apache.</li>
<li>Start Netscape.</li>
<li>Try and access
<code>http://shaggy.blimp.au:8080/gogo/hello.xml</code>.</li>
<li>You should see the Hello Page.</li>
<li>The purpose of the last few steps was to show how a new auto context
can be
setup in the Jakarta-Tomcat <code>webapps</code> directory.
As I see it, put your own custom XML/XSL files in a directory that
lives within the Jakarta-Tomcat
<code>/usr/local/jakarta-tomcat/webapps</code> directory. Make sure
<code>cocoon.properites</code> is also in there.</li>
<li>You could also put your custom XML/XSL work into just the
Jakarta-Tomcat <code>/usr/local/jakarta-tomcat/webapps/ROOT</code> directory and
as long as <code>cocoon.properties</code> is also in there (which it
should be or else you won't be able
to see the internal <code>Cocoon.xml</code> status page) then it
should all work from that <code>ROOT</code> directory.</li>
<li>In order to avoid Jakarta-Tomcat having to serve up everything on
port <code>8080</code>, the
<code>/usr/local/jakarta-tomcat/conf/tomcat-apache.conf</code> file can
be modified by adding
the line "<code>AddHandler jserv-servlet .xml</code>". (Refer to the
start of the listing for
<code>/usr/local/jakarta-tomcat/conf/tomcat-apache-cocoon.conf</code>
below to see where the line should be.)</li>
<li>After starting/stopping Jakarta-Tomcat and Apache in the same manner
as described above you should now
be able to access XML files without specifying port
<code>8080</code>. e.g <code>http://shaggy.blimp.au/samples/index.xml</code>.
<strong>Note :</strong> If your browser cannot find the file then make
sure your <code>/usr/local/jakarta-tomcat/conf/server.xml</code>
file has alias directives for the <code>samples</code> directory or
follow the procedure in the next few steps.</li>
<li><strong>Note :</strong> You must be careful when making modifications
to <code>/usr/local/jakarta-tomcat/conf/tomcat-apache.conf</code>
because this file is automatically generated each time Jakarta-Tomcat
starts and will therefore overwrite any
modifications you have made. To complicate matters, the contents of
<code>/usr/local/jakarta-tomcat/conf/server.xml</code>,
where you might specify some context "AutoSetup actions", determines
some of the content of
<code>/usr/local/jakarta-tomcat/conf/tomcat-apache.conf</code>, so
simply making a once off copy of
<code>/usr/local/jakarta-tomcat/conf/tomcat-apache.conf</code> and
adding the "<code>AddHandler jserv-servlet .xml</code>"
line and referencing the copied <code>.conf</code> file with the
<code>include</code> statement in
<code>/usr/local/Apache Group/Apache/conf/httpd.conf</code> may also
lead to problems.</li>
<li>My solution was to eliminate all context AutoSetup actions in
<code>/usr/local/jakarta-tomcat/conf/server.xml</code>, then copy
a freshly generated version of
<code>/usr/local/jakarta-tomcat/conf/tomcat-apache.conf</code> to
<code>/usr/local/jakarta-tomcat/conf/tomcat-apache-cocoon.conf</code>, then
add the line "<code>AddHandler jserv-servlet .xml</code>" to
<code>/usr/local/jakarta-tomcat/conf/tomcat-apache-cocoon.conf</code>, then
modify the include statement in
<code>/usr/local/apache/conf/httpd.conf</code> to read
"<code>include
/usr/local/jakarta-tomcat/conf/tomcat-apache-cocoon.conf</code>". This method
places the onus on the webmaster
to make sure the copied and modified version of
<code>/usr/local/jakarta-tomcat/conf/tomcat-apache-cocoon.conf</code> is always
up to date. See code segment below.</li>
<li>I have listed my much simplified
<code>/usr/local/jakarta-tomcat/conf/server.xml</code> file. Note the
references to my test <code>gogo</code>
directory in file
<code>/usr/local/jakarta-tomcat/conf/tomcat-apache-cocoon.conf</code> which are
needed in order to get the <code>hello-page.xml</code> example working
without using port <code>8080</code> in the
address. See code segment below.</li>
<li>Well, thats how I got it to work.</li>
<li>Works for me and I hope for you too.</li>
<li>Sorry for all the completely specified file and directory paths, but
it should at least be unambiguous. No worries !</li>
</ul>
<p><code>/usr/local/jakarta-tomcat/bin/tomcat.sh</code></p>
<source><![CDATA[
.................
CLASSPATH=$TOMCAT_HOME/classes
CLASSPATH=$CLASSPATH:$TOMCAT_HOME/lib/xerces_1_0_3.jar
CLASSPATH=$CLASSPATH:$TOMCAT_HOME/lib/xalan_1_0_1.jar
CLASSPATH=$CLASSPATH:$TOMCAT_HOME/lib/fop_0_12_1.jar
CLASSPATH=$CLASSPATH:$TOMCAT_HOME/lib/servlet_2_2.jar
CLASSPATH=$CLASSPATH:$TOMCAT_HOME/lib/cocoon.jar
CLASSPATH=$CLASSPATH:$TOMCAT_HOME/lib/webserver.jar
CLASSPATH=$CLASSPATH:$TOMCAT_HOME/lib/jasper.jar
CLASSPATH=$CLASSPATH:$TOMCAT_HOME/lib/xml.jar
#CLASSPATH=$CLASSPATH:$TOMCAT_HOME/lib/servlet.jar
CLASSPATH=$CLASSPATH:$JAVA_HOME/lib/tools.jar
.................
]]></source>
<p><code>/usr/local/jakarta-tomcat/conf/web.xml</code></p>
<source><![CDATA[
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN"
"http://java.sun.com/j2ee/dtds/web-app_2.2.dtd";>
<web-app>
<servlet>
<servlet-name>
default
</servlet-name>
<servlet-class>
org.apache.tomcat.servlets.DefaultServlet
</servlet-class>
<load-on-startup>
-2147483646
</load-on-startup>
</servlet>
<servlet>
<servlet-name>
invoker
</servlet-name>
<!--
org.apache.tomcat.servlets.NoInvokerServlet
-->
<servlet-class>
org.apache.tomcat.servlets.InvokerServlet
</servlet-class>
</servlet>
<servlet>
<servlet-name>
jsp
</servlet-name>
<servlet-class>
org.apache.jasper.runtime.JspServlet
</servlet-class>
<!-- uncomment the following to use Jikes for JSP compilation
<init-param>
<param-name>jspCompilerPlugin</param-name>
<param-value>org.apache.jasper.compiler.JikesJavaCompiler</param-value>
</init-param>
-->
<load-on-startup>
-2147483646
</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>
invoker
</servlet-name>
<url-pattern>
/servlet/*
</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>
jsp
</servlet-name>
<url-pattern>
*.jsp
</url-pattern>
</servlet-mapping>
<session-config>
<session-timeout>
30
</session-timeout>
</session-config>
<!-- Start Cocoon Section -->
<servlet>
<servlet-name>org.apache.cocoon.Cocoon</servlet-name>
<servlet-class>org.apache.cocoon.Cocoon</servlet-class>
<init-param>
<param-name>properties</param-name>
<param-value>
cocoon.properties
</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>org.apache.cocoon.Cocoon</servlet-name>
<url-pattern>*.xml</url-pattern>
</servlet-mapping>
<!-- End Cocoon Section -->
<mime-mapping>
<extension>
txt
</extension>
<mime-type>
text/plain
</mime-type>
</mime-mapping>
..........
]]></source>
<p><code>/usr/local/jakarta-tomcat/conf/tomcat-apache-cocoon.conf</code></p>
<source><![CDATA[
LoadModule jserv_module libexec/mod_jserv.so
ApJServManual on
ApJServDefaultProtocol ajpv12
ApJServSecretKey DISABLED
ApJServMountCopy on
ApJServLogLevel notice
ApJServDefaultPort 8007
AddHandler jserv-servlet .xml
AddType test/jsp .jsp
AddHandler jserv-servlet .jsp
Alias /examples /usr/local/jakarta-tomcat/webapps/examples
<Directory "/usr/local/jakarta-tomcat/webapps/examples">
Options Indexes FollowSymLinks
</Directory>
ApJServMount /examples/servlet /examples
<Location /examples/WEB-INF/ >
AllowOverride None
deny from all
</Location>
Alias /test /usr/local/jakarta-tomcat/webapps/test
<Directory "/usr/local/jakarta-tomcat/webapps/test">
Options Indexes FollowSymLinks
</Directory>
ApJServMount /test/servlet /test
<Location /test/WEB-INF/ >
AllowOverride None
deny from all
</Location>
Alias /admin /usr/local/jakarta-tomcat/webapps/admin
<Directory "/usr/local/jakarta-tomcat/webapps/admin">
Options Indexes FollowSymLinks
</Directory>
ApJServMount /admin/servlet /admin
<Location /admin/WEB-INF/ >
AllowOverride None
deny from all
</Location>
Alias /samples /usr/local/jakarta-tomcat/webapps/samples
<Directory "/usr/local/jakarta-tomcat/webapps/samples">
Options Indexes FollowSymLinks
</Directory>
ApJServMount /samples/servlet /samples
<Location /samples/WEB-INF/ >
AllowOverride None
deny from all
</Location>
Alias /gogo /usr/local/jakarta-tomcat/webapps/gogo
<Directory "/usr/local/jakarta-tomcat/webapps/gogo">
Options Indexes FollowSymLinks
</Directory>
ApJServMount /gogo/servlet /gogo
<Location /gogo/WEB-INF/ >
AllowOverride None
deny from all
</Location>
ApJServMount /servlet /ROOT
]]></source>
<p><code>/usr/local/jakarta-tomcat/conf/server.xml</code></p>
<source><![CDATA[
<?xml version="1.0" encoding="ISO-8859-1"?>
<Server>
<!-- Debug low-level events in XmlMapper startup -->
<xmlmapper:debug level="0" />
<!-- This is quite flexible; we can either have a log file per
module in Tomcat (example: ContextManager) or we can have
one for Servlets and one for Jasper, or we can just have
one tomcat.log for both Servlet and Jasper.
If you omit "path" there, then stderr should be used.
verbosityLevel values can be:
FATAL
ERROR
WARNING
INFORMATION
DEBUG
-->
<Logger name="tc_log"
path="logs/tomcat.log"
customOutput="yes" />
<Logger name="servlet_log"
path="logs/servlet.log"
customOutput="yes" />
<Logger name="JASPER_LOG"
path="logs/jasper.log"
verbosityLevel = "INFORMATION" />
<!-- Add "home" attribute if you want tomcat to be based on a
different directory
"home" is used to create work and to read webapps, but not for
libs or CLASSPATH.
Note that TOMCAT_HOME is where tomcat is installed, while
ContextManager home is the
base directory for contexts, webapps/ and work/
-->
<ContextManager debug="0" workDir="work" >
<!-- ContextInterceptor
className="org.apache.tomcat.context.LogEvents" / -->
<ContextInterceptor
className="org.apache.tomcat.context.AutoSetup" />
<ContextInterceptor
className="org.apache.tomcat.context.DefaultCMSetter" />
<ContextInterceptor
className="org.apache.tomcat.context.WorkDirInterceptor" />
<ContextInterceptor
className="org.apache.tomcat.context.WebXmlReader" />
<ContextInterceptor
className="org.apache.tomcat.context.LoadOnStartupInterceptor" />
<!-- Request processing -->
<RequestInterceptor
className="org.apache.tomcat.request.SimpleMapper" debug="0" />
<RequestInterceptor
className="org.apache.tomcat.request.SessionInterceptor" />
<RequestInterceptor
className="org.apache.tomcat.request.SecurityCheck" />
<RequestInterceptor
className="org.apache.tomcat.request.FixHeaders" />
<Connector
className="org.apache.tomcat.service.SimpleTcpConnector">
<Parameter name="handler"
value="org.apache.tomcat.service.http.HttpConnectionHandler"/>
<Parameter name="port" value="8080"/>
</Connector>
<Connector
className="org.apache.tomcat.service.SimpleTcpConnector">
<Parameter name="handler"
value="org.apache.tomcat.service.connector.Ajp12ConnectionHandler"/>
<Parameter name="port" value="8007"/>
</Connector>
</ContextManager>
</Server>
]]></source>
<p><code>/usr/local/apache/conf/httpd.conf</code></p>
<source><![CDATA[
...........
#
# VirtualHost example:
# Almost any Apache directive may go into a VirtualHost container.
#
#<VirtualHost ip.address.of.host.some_domain.com>
# ServerAdmin [EMAIL PROTECTED]
# DocumentRoot /www/docs/host.some_domain.com
# ServerName host.some_domain.com
# ErrorLog logs/host.some_domain.com-error_log
# CustomLog logs/host.some_domain.com-access_log common
#</VirtualHost>
#<VirtualHost _default_:*>
#</VirtualHost>
include /usr/local/jakarta-tomcat/conf/tomcat-apache-cocoon.conf
]]></source>
</s1>
<s1 title="Hints and Tips">
<p>Being bit of a XML/XSL/JAVA etc novice, here are some hints that I now
know but it would have
made life a lot easier if I knew them before I attempted
Cocoon/Jakarta-Tomcat/Apache etc..</p>
<ul>
<li>Don't be fooled...use the refresh button on the web browser when
fiddling about. The cache is
your enemy in the early days !</li>
<li>Always stop/start Jakarta-Tomcat and Apache if you are
adding/deleting files from the Jakarta-Tomcat <code>webapps</code>
directory.</li>
<li>Understanding how Cocoon finds the <code>cocoon.properties</code>
file is the key.</li>
<li>In order to make the starting and stopping of
Apache/Jakarta-Tomcat/Cocoon a bit easier on my machine, I modified
<code>/usr/local/jakarta-tomcat/bin/tomcat.sh</code>. The complete
file listing for
<code>/usr/local/jakarta-tomcat/bin/tomcat.sh</code> is shown below.
The script starts and stops the Apache server and
Jakarta-Tomcat in the correct order and generally just makes life a
little easier.</li>
</ul>
<p>Regards - [EMAIL PROTECTED]</p>
<p><code>/usr/local/jakarta-tomcat/bin/tomcat.sh</code></p>
<source><![CDATA[
#!/bin/sh
#
# $Id: installation-case-solaris-8.xml,v 1.1 2000/08/17 22:33:15
stefano Exp $
# Shell script to start and stop the server
# There are other, simpler commands to startup the runner. The two
# commented commands good replacements. The first works well with
# Java Platform 1.1 based runtimes. The second works well with
# Java2 Platform based runtimes.
TOMCAT_HOME=/usr/local/jakarta-tomcat
JAVA_HOME=/usr/local/j2sdk1_3_0beta_refresh
JAVACMD=/usr/local/j2sdk1_3_0beta_refresh/bin/java
oldCP=$CLASSPATH
CLASSPATH=$TOMCAT_HOME/classes
CLASSPATH=$CLASSPATH:$TOMCAT_HOME/lib/xerces_1_0_3.jar
CLASSPATH=$CLASSPATH:$TOMCAT_HOME/lib/xalan_1_0_1.jar
CLASSPATH=$CLASSPATH:$TOMCAT_HOME/lib/fop_0_12_1.jar
CLASSPATH=$CLASSPATH:$TOMCAT_HOME/lib/servlet_2_2.jar
CLASSPATH=$CLASSPATH:$TOMCAT_HOME/lib/cocoon.jar
CLASSPATH=$CLASSPATH:$TOMCAT_HOME/lib/webserver.jar
CLASSPATH=$CLASSPATH:$TOMCAT_HOME/lib/jasper.jar
CLASSPATH=$CLASSPATH:$TOMCAT_HOME/lib/xml.jar
#CLASSPATH=$CLASSPATH:$TOMCAT_HOME/lib/servlet.jar
CLASSPATH=$CLASSPATH:$JAVA_HOME/lib/tools.jar
export CLASSPATH
# We start the server up in the background for a couple of reasons:
# 1) It frees up your command window
# 2) You should use `stop` option instead of ^C to bring down the
server
if [ "$1" = "start" ] ; then
shift
# echo Using classpath: ${CLASSPATH}
echo __________________________
echo Stopping Apache Web Server
echo __________________________
kill -TERM `cat /usr/local/apache/logs/httpd.pid` >/dev/null
echo ______________________________________
echo Starting Jakarta-Tomcat in a new shell
echo ______________________________________
$JAVACMD $TOMCAT_OPTS -Dtomcat.home=${TOMCAT_HOME}
org.apache.tomcat.startup.Tomcat "$@" &
# $JAVACMD org.apache.tomcat.shell.Startup "$@" &
echo __________________________
echo Starting Apache Web Server
echo __________________________
/usr/local/apache/bin/httpd -d /usr/local/apache
elif [ "$1" = "stop" ] ; then
shift
# echo Using classpath: ${CLASSPATH}
echo _______________________
echo Stopping Jakarta-Tomcat
echo _______________________
$JAVACMD $TOMCAT_OPTS -Dtomcat.home=${TOMCAT_HOME}
org.apache.tomcat.startup.Tomcat -stop "$@"
# $JAVACMD org.apache.tomcat.shell.Shutdown "$@"
elif [ "$1" = "run" ] ; then
shift
echo Using classpath: ${CLASSPATH}
$JAVACMD $TOMCAT_OPTS -Dtomcat.home=${TOMCAT_HOME}
org.apache.tomcat.startup.Tomcat "$@"
# $JAVACMD org.apache.tomcat.shell.Startup "$@"
# no &
elif [ "$1" = "ant" ] ; then
shift
$JAVACMD $ANT_OPTS -Dant.home=${TOMCAT_HOME}
-Dtomcat.home=${TOMCAT_HOME} org.apache.tools.ant.Main $@
elif [ "$1" = "jspc" ] ; then
shift
$JAVACMD $JSPC_OPTS -Dtomcat.home=${TOMCAT_HOME}
org.apache.jasper.JspC "$@"
elif [ "$1" = "env" ] ; then
## Call it with source tomcat.sh to set the env for tomcat
shift
echo Setting classpath to: ${CLASSPATH}
oldCP=$CLASSPATH
else
echo "Usage:"
echo "tomcat (start|env|run|stop|ant)"
echo " start - start tomcat in the background"
echo " run - start tomcat in the foreground"
echo " stop - stop tomcat"
echo " env - set CLASSPATH and TOMCAT_HOME env. variables"
echo " ant - run ant script in tomcat context ( classes,
directories, etc)"
echo " jspc - run jsp pre compiler"
exit 0
fi
if [ "$oldCP" != "" ]; then
CLASSPATH=${oldCP}
export CLASSPATH
else
unset CLASSPATH
fi
]]></source>
</s1>
</body>
</document>
