stefano 00/07/19 17:11:02
Modified: xdocs installation-case.xml livesites.xml
Log:
updated installation case and new livesites
Revision Changes Path
1.2 +356 -8 xml-cocoon/xdocs/installation-case.xml
Index: installation-case.xml
===================================================================
RCS file: /home/cvs/xml-cocoon/xdocs/installation-case.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- installation-case.xml 2000/05/30 21:16:36 1.1
+++ installation-case.xml 2000/07/20 00:11:01 1.2
@@ -71,7 +71,8 @@
</p>
<note>
- Warning : This is long and verbose !
+ 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>
@@ -326,7 +327,7 @@
<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>
@@ -350,12 +351,42 @@
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 the XML files on
port <code>8080</code>, the
+ <code>C:\Program_Files\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>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>.
+ Note : 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. See
text below and code segment.</li>
+
+ <li>Note: 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
+ <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 simplied
<code>C:\Program_Files\jakarta-tomcat\conf\server.xml</code> file. Note the
references to my test <code>gogo</code>
+ directory in this file 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>Well, thats how I got it to work.</li>
<li>Works for me and I hope for you too.</li>
- <li>No worries !</li>
+ <li>Sorry for all the completely specfied file and directory paths, but
it should at least be unambiguous. No worries !</li>
</ul>
@@ -496,13 +527,177 @@
]]></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
+
+ 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>
+
+ #
+ # Jakarta-Tomcat conf file
+ #
+ include C:/Program_Files/jakarta-tomcat/conf/tomcat-apache-cocoon.conf
+ ]]></source>
+
</s1>
<s1 title="Hints and Tips">
- <ul>
- <li>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..</li>
+ <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>
@@ -510,8 +705,161 @@
<li>Understanding how Cocoon finds the <code>cocoon.properties</code>
file is the key.</li>
- <li>No worries !</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.</li>
</ul>
+
+ <p>Regards - [EMAIL PROTECTED]</p>
+
+
+ <p><code>C:\Program_Files\jakarta-tomcat\bin\tomcat.bat</code></p>
+
+ <source>
+
+ @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>
1.5 +14 -8 xml-cocoon/xdocs/livesites.xml
Index: livesites.xml
===================================================================
RCS file: /home/cvs/xml-cocoon/xdocs/livesites.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- livesites.xml 2000/06/22 22:35:48 1.4
+++ livesites.xml 2000/07/20 00:11:01 1.5
@@ -6,25 +6,31 @@
<title>Live Sites powered by Cocoon</title>
<authors>
<person name="Donald Ball" email="[EMAIL PROTECTED]"/>
+ <person name="Stefano Mazzocchi" email="[EMAIL PROTECTED]"/>
</authors>
</header>
<body>
<s1 title="Live Sites powered by Cocoon">
<p>
- Here is a list of web sites that are proudly powered by Cocoon.
+ Here is a list of web sites that are proudly powered by Cocoon (in
chronological order):
</p>
<ul>
- <li><link href="http://www.zen.co.za/";>http://www.zen.co.za/</link></li>
- <li><link
href="http://www.randshow.co.za/";>http://www.randshow.co.za/</link></li>
- <li><link
href="http://www.mtnartinst.com/";>http://www.mtnartinst.com/</link></li>
- <li><link
href="http://www.north-wood.co.uk/";>http://www.north-wood.co.uk/</link></li>
- <li><link
href="http://www.eurofootball.com/";>http://www.eurofootball.com/
(partially)</link></li>
+ <li><link href="http://www.zen.co.za/";>http://www.zen.co.za</link></li>
+ <li><link
href="http://www.randshow.co.za/";>http://www.randshow.co.za</link></li>
+ <li><link
href="http://www.mtnartinst.com/";>http://www.mtnartinst.com</link></li>
+ <li><link
href="http://www.north-wood.co.uk/";>http://www.north-wood.co.uk</link></li>
+ <li><link
href="http://www.eurofootball.com/";>http://www.eurofootball.com</link></li>
+ <li><link href="http://www.caida.org/";>http://www.caida.org</link></li>
+ <li><link
href="http://grapeape.codingapes.com/";>http://grapeape.codingapes.com</link></li>
+ <li><link
href="http://http://www.xmls.com/";>http://www.xmls.com</link></li>
+ <li><link
href="http://http://www.xmltimes.com/";>http://www.xmltimes.com</link></li>
+<!--<li><link href="http:///";></link></li>-->
</ul>
-
+
<p>
- If you don't find your site upthere, make sure you tell us. We want this
list
+ If you don't find your site here, make sure you tell us. We want this
list
to grow bigger every day :-)
</p>
</s1>
