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 webmaster@host.some_domain.com
  +     #    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 - mark.evans@dsto.defence.gov.au</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="balld@webslingerZ.com"/>
  +   <person name="Stefano Mazzocchi" email="stefano@apache.org"/>
     </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>