cocoon-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From vgritse...@apache.org
Subject cvs commit: xml-cocoon2/src/documentation/xdocs/installing index.xml
Date Sun, 17 Mar 2002 22:25:12 GMT
vgritsenko    02/03/17 14:25:12

  Modified:    src/documentation/xdocs/installing index.xml
  Log:
  update installation instructions. Tomcat 3.3 is a drop-in install!
  
  Revision  Changes    Path
  1.14      +207 -56   xml-cocoon2/src/documentation/xdocs/installing/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/installing/index.xml,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  --- index.xml	11 Mar 2002 15:17:15 -0000	1.13
  +++ index.xml	17 Mar 2002 22:25:12 -0000	1.14
  @@ -325,8 +325,8 @@
           the script invocation:</p>
   
   <source>
  -[unix]  ./build.sh [target] -Dpropertyname=propertyvalue
  -[win32] .\build.bat [target] -Dpropertyname=propertyvalue</source>           
  +[unix]  ./build.sh -Dpropertyname=propertyvalue [target]
  +[win32] .\build.bat -Dpropertyname=propertyvalue [target]</source>
   
         </s3>
   
  @@ -560,7 +560,39 @@
       the war file in a specific directory and the engine will take
       care of installing it when restarted.</p>
   
  -    <s2 title="Installing on Tomcat 3.X">
  +    <note>The first time you start Cocoon, it will take a few
  +      seconds, since Cocoon needs to compile parts of itself.</note>
  +
  +    <s2 title="Installing on Tomcat 3.3.X">
  +      <p>This is a very easy installation.</p>
  +
  +      <ol>
  +        <li>
  +          Build the Cocoon webapp as described above.
  +        </li>
  +
  +        <li>
  +          Copy <code>cocoon/build/cocoon/cocoon.war</code>
  +          into <code>tomcat/webapps</code> directory.
  +        </li>
  +
  +        <li>
  +          Start Tomcat: Go to the <code>tomcat/bin</code> directory,
  +          and run the startup script.
  +        </li>
  +
  +        <li>
  +          Open the Cocoon welcome page:
  +          <link href="http://localhost:8080/cocoon/">http://localhost:8080/cocoon/</link>
  +        </li>
  +
  +        <li>
  +            Congratulations! You should see the Cocoon welcome page.
  +        </li>
  +      </ol>
  +    </s2>
  +
  +    <s2 title="Installing on Tomcat 3.2.X">
         <note>Cocoon requires Tomcat version 3.2 or greater. It wouldn't work
           with Tomcat 3.1.X</note>
   
  @@ -613,44 +645,161 @@
             Access the URI
             <link href="http://localhost:8080/cocoon/">http://localhost:8080/cocoon/</link>
             with your favorite browser and start to enjoy the world of Cocoon.
  -          Note that the first time you access Cocoon, it will take a few
  -          seconds to start, since Cocoon needs to compile parts of itself.
  +        </li>
  +      </ol>
  +    </s2>
  +
  +    <s2 title="Installing on Tomcat 4.0 - 4.0.1, 4.0.4b1">
  +      <p>Tomcat 4 is a really straight-forward installation.</p>
  +      <ol>
  +        <li>
  +          Build the Cocoon webapp as described above.
  +        </li>
  +
  +        <li>
  +          Copy <code>cocoon/build/cocoon/cocoon.war</code> into
  +          <code>tomcat/webapps</code> directory.
  +        </li>
  +
  +        <li>
  +          Start Tomcat: Go to the <code>tomcat/bin</code> directory,
  +          and run the startup script.
  +        </li>
  +
  +        <li>
  +          Open the Cocoon welcome page:
  +          <link href="http://localhost:8080/cocoon/">http://localhost:8080/cocoon/</link>
  +        </li>
  +
  +        <li>
  +            Congratulations! You should see the Cocoon welcome page.
  +        </li>
  +      </ol>
  +    </s2>
  +
  +    <s2 title="Installing on Tomcat 4.0.3">
  +      <p>If you have to use Tomcat 4.0.3, you have to replace its
  +        XML parser with the one shipped with Cocoon.</p>
  +
  +      <ol>
  +        <li>Remove <code>tomcat/common/lib/xerces.jar</code> file.
  +        </li>
  +
  +        <li>Copy following libraries from the <code>cocoon/lib/core</code>
  +          directory to the tomcat/common/lib directory:
  +          <ul>
  +            <li>xalan-XXX.jar</li>
  +            <li>xercesImpl-XXX.jar</li>
  +            <li>xml-apis.jar</li>
  +          </ul>
  +        </li>
  +
  +        <li>Copy <code>cocoon/lib/core/batik-libs-XXX.jar</code>
  +          to the tomcat/common/lib directory.</li>
  +
  +        <li>Edit <code>extra-classpath</code> parameter in the
  +          <code>cocoon/src/webapp/WEB-INF/web.xml</code> file:
  +        </li>
  +      </ol>
  +      <p>For UNIX:</p>
  +      <source><![CDATA[
  +<init-param>
  +  <param-name>extra-classpath</param-name>
  +  <param-value>/tomcat/common/lib/xalan-XXX.jar:
  +/tomcat/common/lib/xercesImpl-XXX.jar:
  +/tomcat/common/lib/xml-apis.jar:
  +/tomcat/common/lib/batik-libs-XXX.jar</param-value>
  +</init-param>
  +]]></source>
  +      <p>For Windows:</p>
  +      <source><![CDATA[
  +<init-param>
  +  <param-name>extra-classpath</param-name>
  +  <param-value>C:\tomcat\common\lib\xalan-XXX.jar;
  +C:\tomcat\common\lib\xercesImpl-XXX.jar;
  +C:\tomcat\common\lib\xml-apis.jar;
  +C:\tomcat\common\lib\batik-libs-XXX.jar</param-value>
  +</init-param>
  +]]></source>
  +
  +      <note>param-value should be in one line!
  +        Also, replace <code>/tomcat/</code> (UNIX), <code>C:\tomcat\</code>
  +        (Windows) with the path to your Tomcat installation home.</note>
  +
  +      <ol>
  +        <li>
  +          Clean Cocoon build directory: <code>build clean</code>
           </li>
   
  +        <li>
  +          Build Cocoon webapp: <code>build -Dinclude.webapp.libs=yes webapp</code>
  +        </li>
  +
  +        <li>
  +          Remove xalan-XXX.jar, xercesImpl-XXX.jar, batik-libs-XXX.jar,
  +          and xml-apis.jar from the cocoon.war archive.
  +        </li>
  +
  +        <li>
  +          Copy <code>cocoon/build/cocoon/cocoon.war</code> into
  +          <code>tomcat/webapps</code> directory.
  +        </li>
  +
  +        <li>
  +          Start Tomcat: Go to the <code>tomcat/bin</code> directory,
  +          and run the startup script.
  +        </li>
  +
  +        <li>
  +          Open the Cocoon welcome page:
  +          <link href="http://localhost:8080/cocoon/">http://localhost:8080/cocoon/</link>
  +        </li>
  +
  +        <li>
  +            Congratulations! You should see the Cocoon welcome page.
  +        </li>
         </ol>
       </s2>
   
  -    <s2 title="Installing on Tomcat 4.0 - 4.0.1">
  -		<p>Tomcat 4 is a really straight-forward installation.</p>
  -		<ol>
  +    <s2 title="Installing on Tomcat 4.0.4b1 LE with JDK 1.4.0">
  +      <p>This combination is also easy to install.</p>
  +      <ol>
           <li>
  -          <strong>Build the Cocoon webapp</strong>
  -          Build the webapp as described above.
  +          Build the Cocoon webapp as described above.
           </li>
   
           <li>
  -          <strong>Copy cocoon/build/cocoon/cocoon.war into tomcat/webapps</strong>
  +          Copy <code>xml-cocoon2/build/cocoon/cocoon.war</code> into
  +          <code>tomcat/webapps</code> directory.
           </li>
   
           <li>
  -          <strong>Start Tomcat</strong>
  -          Go to the tomcat/bin directory, and run the startup script.
  +          Set environment variable <code>CATALINA_OPTS=-Djava.awt.headless=true</code>
           </li>
   
           <li>
  -          <strong>Start using Cocoon</strong>
  -          Access the URI
  +          Start Tomcat: Go to the <code>tomcat/bin</code> directory,
  +          and run the startup script.
  +        </li>
  +
  +        <li>
  +          Open the Cocoon welcome page:
             <link href="http://localhost:8080/cocoon/">http://localhost:8080/cocoon/</link>
  -          with your favorite browser and start to enjoy the world of Cocoon.
  -          Note that the first time you access Cocoon, it will take a few
  -          seconds to start, since Cocoon needs to compile parts of itself.
  +        </li>
  +        <li>
  +            Congratulations! You should see the Cocoon welcome page.
           </li>
         </ol>
  +      <note>
  +        Make sure that JAVA_HOME enviroment variable points to the JDK1.4.0.
  +        If you had JDK1.3.1 or earlier before, <code>build clean</code> before
  +        all these steps.
  +      </note>
       </s2>
   
  -    <s2 title="Installing on BEA Weblogic 6.0">
  +    <s2 title="Installing on BEA Weblogic 6.0sp2">
         <p>This installs Cocoon using the cocoon.war file.
  -         This was successfully installed under Windows 2000 with WebLogic 6.0sp2.
  +         This was successfully installed under Windows 2000 and JDK 1.3.1.
            Unix users will need to adjust appropriately. If you haven't done so already,
            build a domain and a server. In this discussion, the name of the domain
            is 'mydomain', the name of the server is 'myserver', and WebLogic installation
  @@ -658,19 +807,17 @@
         </p>
   
         <ol>
  -        <li>Compile and build Cocoon. Launch <code>build compile</code>,
  -          <code>build -Dinclude.webapp.libs=yes webapp</code>.
  -        </li>
  -        <li>You should have a webapp directory in
  -          <code>xml-cocoon2\build\cocoon\webapp</code>.
  +        <li>
  +          Build the Cocoon webapp as described above.
           </li>
           <li>
  -          Copy Cocoon webapp directory into the <code>c:\bea\wlserver6.0sp2\config\mydomain\applications\</code>
  +          Copy <code>cocoon\build\cocoon\webapp</code> directory into the
  +          <code>c:\bea\wlserver6.0sp2\config\mydomain\applications\</code>
             directory of your WebLogic server.
           </li>
           <li>
             Copy the <code>xerces-XXX.jar</code> and <code>xml-apis.jar</code>
JAR files from the
  -          <code>xml-cocoon2\lib\core\</code> to the directory of your choice,
say <code>c:\bea\</code>.
  +          <code>cocoon\lib\core\</code> to the directory of your choice, say
<code>c:\bea\</code>.
           </li>
           <li>
             Add to the config.xml of the WebLogic server following snippet:
  @@ -703,35 +850,36 @@
             Using a browser, you might want to check WebLogic configuration using console:
             <link href="http://localhost:7001/console/">http://localhost:7001/console/</link>.
           </li>
  +
           <li>
  -          Access cocoon page:
  +          Open the Cocoon welcome page:
             <link href="http://localhost:7001/cocoon/">http://localhost:7001/cocoon/</link>
  -          (Don't forget the final / in the link.)
  +          (Don't forget the final '/' in the link.)
           </li>
           <li>
  -          Congratulations! (hopefully) you should see the Cocoon welcome page.
  +          Congratulations! You should see the Cocoon welcome page.
           </li>
         </ol>
  +      <note>Because of some issues with this version of WebLogic, you will
  +        see lots of exceptions in the WebLogic's console window.
  +      </note>
       </s2>
  -<!-- FIXME: WebLogic 6.1sp2 hangs trying to create sitemap
  -    <s2 title="Installing on BEA WebLogic 6.1sp1, 6.1sp2">
   
  +<!--
  +    <s2 title="Installing on BEA WebLogic 6.1sp2">
         <p>This section describes installing Cocoon in a "directory configuration".
           This was successfully installed under Windows 2000.
           Unix users will need to adjust appropriately. If you haven't done so already,
           build a domain and a server. In this discussion, the name of the domain
           is 'mydomain' and the name of the server is 'myserver'.
           These are the BEA default names; you may want to download
  -        <link href="http://www.weblogic.com">WLS6.1</link>.
  +        <link href="http://commerce.bea.com/downloads/">WLS6.1</link>.
         </p>
         <ol>
  -        <li>Compile and build Cocoon. Launch <code>build compile</code>,
  -          <code>build -Dinclude.webapp.libs webapp webapp-local</code>.
  -        </li>
  -        <li>You should have a webapplication directory in
  -          <code>{cocoon-dir}/build/cocoon/webapp</code>.
  +        <li>
  +          Build the Cocoon webapp as described above.
           </li>
  -        <li>Modify <code>{cocoon-dir}/build/cocoon/webapp/cocoon.xconf</code>.
  +        <li>Modify <code>cocoon/build/cocoon/webapp/cocoon.xconf</code>.
             Replace xslt-processor definition using TRAX XSLT transformer factory by
             xslt-processor definition using Xalan transformer factory explicitly.
             Your xslt-processor definition should look like the code snippet below.
  @@ -754,14 +902,14 @@
             to restart your WLS6.1 server in order to activate Cococoon servlet in WLS 6.1.
           </li>
           <li>
  -            Using a browser, you might want to check WLS6.1 configuration
  -            link to your WLS6.1 console
  -            http://&lt;your machine name&gt;:&lt;port number&gt;/console.
  +          Using a browser, you might want to check WLS6.1 configuration
  +          link to your WLS6.1 console
  +          http://&lt;your machine name&gt;:&lt;port number&gt;/console.
           </li>
           <li>
  -            Using a browser, link to your web site's cocoon page:
  -	    http://&lt;your machine name&gt;:&lt;port number&gt;/cocoon/
  -            (Don't forget the final / in the link.)
  +          Using a browser, link to your web site's cocoon page:
  +          http://&lt;your machine name&gt;:&lt;port number&gt;/cocoon/
  +          (Don't forget the final / in the link.)
           </li>
           <li>
             Congratulations! (hopefully) you should see the Cocoon welcome page.
  @@ -795,8 +943,8 @@
         </note>
       </s2>
   -->
  -    <s2 title="Installing on ServletExec 3.1 (In Process with IIS)">
   
  +    <s2 title="Installing on ServletExec 3.1 (In Process with IIS)">
         <p>This installs Cocoon in a "war" configuration.  This was successfully
            installed under Windows NT 4.0 and IIS 4.  I don't believe that SE is
            available for unix.</p>
  @@ -899,25 +1047,28 @@
   [path]/JBoss-2.2.2_Tomcat-3.2.2/jboss
   [path]/JBoss-2.2.2_Tomcat-3.2.2/tomcat
        </source>
  -     <p>Subsequently, </p>
  -         <ul><li><code>jboss</code> denotes the <code>JBoss-2.2.2_Tomcat-3.2.2/jboss</code>
directory</li>
  -	 <li><code>Tomcat</code> is short for <code>JBoss-2.2.2_Tomcat-3.2.2/tomcat</code></li><li>and
<code>cocoon</code> is the base directory of your Cocoon distribution or CVS checkout.</li></ul>
  +     <p>Subsequently,
  +       <ul>
  +         <li><code>jboss</code> denotes the <code>JBoss-2.2.2_Tomcat-3.2.2/jboss</code>
directory</li>
  +         <li><code>Tomcat</code> is short for <code>JBoss-2.2.2_Tomcat-3.2.2/tomcat</code></li><li>and
<code>cocoon</code> is the base directory of your Cocoon distribution or CVS checkout.</li>
  +       </ul>
  +     </p>
        <p>In order to get Cocoon running you have to install Xerces as default XML
parser for JBoss.</p>
        <ul>
          <li>Stop the server if it is running.</li>
          <li>Remove the following files from the <code>jboss/lib</code>
directory
            <ul>
  -	   <li>crimson.jar</li>
  -	   <li>jaxp.jar</li>
  -	   <li>xml.jar</li>
  -	 </ul>
  +           <li>crimson.jar</li>
  +           <li>jaxp.jar</li>
  +           <li>xml.jar</li>
  +         </ul>
          </li>
          <li>Remove the following files from the <code>tomcat/lib</code>
              directory
            <ul>
  -	   <li>jaxp.jar</li>
  -	   <li>parser.jar</li>
  -	 </ul>
  +           <li>jaxp.jar</li>
  +           <li>parser.jar</li>
  +         </ul>
          </li>
          <li>Copy <code>xerces-XXX.jar</code> from <code>cocoon/lib/core/</code>
to <code>jboss/lib</code></li>
          <li>Change <code>jboss/bin/run.sh</code></li>
  
  
  

----------------------------------------------------------------------
In case of troubles, e-mail:     webmaster@xml.apache.org
To unsubscribe, e-mail:          cocoon-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: cocoon-cvs-help@xml.apache.org


Mime
View raw message