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://<your machine name>:<port number>/console.
+ Using a browser, you might want to check WLS6.1 configuration
+ link to your WLS6.1 console
+ http://<your machine name>:<port number>/console.
</li>
<li>
- Using a browser, link to your web site's cocoon page:
- http://<your machine name>:<port number>/cocoon/
- (Don't forget the final / in the link.)
+ Using a browser, link to your web site's cocoon page:
+ http://<your machine name>:<port number>/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: [EMAIL PROTECTED]
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
