You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@lenya.apache.org by gr...@apache.org on 2004/11/12 06:19:37 UTC
svn commit: rev 57501 - in lenya/docu/src/documentation/content/xdocs: . installation
Author: gregor
Date: Thu Nov 11 21:19:35 2004
New Revision: 57501
Modified:
lenya/docu/src/documentation/content/xdocs/installation/index.xml
lenya/docu/src/documentation/content/xdocs/installation/source_version.xml
lenya/docu/src/documentation/content/xdocs/installation/subversion.xml
lenya/docu/src/documentation/content/xdocs/site.xml
Log:
updated the install instructions, subversion
Modified: lenya/docu/src/documentation/content/xdocs/installation/index.xml
==============================================================================
--- lenya/docu/src/documentation/content/xdocs/installation/index.xml (original)
+++ lenya/docu/src/documentation/content/xdocs/installation/index.xml Thu Nov 11 21:19:35 2004
@@ -30,14 +30,11 @@
<ul>
<li>
- <link href="prerequisites.html">Prerequisites</link>
- </li>
- <li>
Download Lenya
<ul>
- <li><link href="subversion.html">Subversion</link></li>
+ <li><link href="ext:releases">Releases</link></li>
<li><link href="ext:nightly.builds">Nightly Snapshots</link></li>
- <li><link href="ext:incubator.lenya">Incubating-lenya-1.2</link></li>
+ <li><link href="subversion.html">Subversion</link></li>
</ul>
</li>
<li>
Modified: lenya/docu/src/documentation/content/xdocs/installation/source_version.xml
==============================================================================
--- lenya/docu/src/documentation/content/xdocs/installation/source_version.xml (original)
+++ lenya/docu/src/documentation/content/xdocs/installation/source_version.xml Thu Nov 11 21:19:35 2004
@@ -19,182 +19,444 @@
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.2//EN" "document-v12.dtd">
-<document>
-
-<header>
+<document>
+ <header>
<title>Installation of the Source Version</title>
- <version>0.1</version>
- <type>Documentation</type>
+ <version>0.1</version>
+ <type>Documentation</type>
<authors>
- <person name="Lenya community" email="dev@lenya.apache.org"/>
- </authors>
-</header>
-<body>
-
-<section><title>Standalone Installation (using the built-in Jetty)</title>
-<ol>
- <li>
- <strong>Get the Java SDK</strong> (see <link href="prerequisites.html">Prerequisites</link>)
- <p/>
- </li>
- <li>
- <p>
- <strong>Get Apache Cocoon</strong> (see <link href="prerequisites.html">Prerequisites</link>)
- </p>
- </li>
- <li>
- <p>
- <strong>Get Apache Lenya</strong> (see <link href="download.html">Download Lenya</link>)
- </p>
- </li>
- <li>
- <p>
- Extract the downloaded Lenya archive to the <code>lenya</code> directory as described below. If you use
- Subversion, create your Lenya checkout inside the <code>src</code> directory as described below.
- It is recommended to use the following directory structure for an easier build experience.</p>
-
-<source>
-your_home (or c:\ on Windows, NOT My Documents)
- /src
- /lenya $LENYA_HOME
- /cocoon-2.1 $COCOON_HOME
- /build
- /webapp $COCOON_WEBAPP
-</source>
- <p/>
- </li>
- <li>
- <p>
- <strong>Copy the Cocoon build properties supplied by Lenya</strong>
- </p>
- <p>
- Copy the files
- </p>
- <ul>
- <li><code>local.build.properties</code></li>
- <li><code>local.blocks.properties</code></li>
- </ul>
- <p>
- from <code>$LENYA_HOME/src/cocoon</code> to <code>$COCOON_HOME</code>.
- </p>
- </li>
- <li>
- <p>
- <strong>Compile Cocoon</strong>
- </p>
- <p><strong>MS Windows</strong></p>
-<source>
-$COCOON_HOME > build.bat
-</source>
-
- <p><strong>Unix</strong></p>
-
-<source>
-$COCOON_HOME > ./build.sh -Dinclude.webapp.libs=yes webapp
-</source>
- </li>
- <li><p>
- <strong>Configure Lenya</strong></p>
- <p>If your Cocoon source tree is set up as described above, you can skip this step.
- If your Cocoon source tree is not at <code>../cocoon-2.1</code> relative to Lenya,
- you need to edit your build properties. To do this, copy <code>$LENYA_HOME/build.properties</code> to
- <code>$LENYA_HOME/local.build.properties</code>.
- </p>
- <p>
- Edit <code>local.build.properties</code>. For the described configuration the following
- settings will work (<strong>MS Windows:</strong> Don't use backslashes "<code>\</code>"
- for directory separation.)
- </p>
- <ul>
- <li><code>cocoon.src.dir=$COCOON_HOME</code></li>
- <li><code>tomcat.home.dir=$TOMCAT_HOME</code></li>
- </ul>
- <p/>
- </li>
- <li><p>
- <strong>Build Lenya</strong></p>
- <p>
- Execute <code>build.bat</code> or <code>build.sh</code> in your Lenya source directory, depending
- on your platform.</p>
- </li>
- <li>
- <p>
- <strong>Start Lenya</strong></p>
- <p>
- Execute <code>lenya.bat</code> or <code>lenya.sh servlet</code> in your Lenya source directory, depending
- on your platform.</p>
- </li>
- <li>
- <p>
- <strong>Test the installation</strong>
- </p>
- <p>
- <link href="http://localhost:8888">http://localhost:8888</link>
- </p>
- </li>
-</ol>
-</section>
-<section><title>Installation with Apache Tomcat</title>
- <p>Installing Lenya with Tomcat is mostly the same procedure. Follow Steps 1-6, then do the steps below.</p>
- <ol>
- <li><p>
- <strong>get Apache Tomcat</strong> (see <link href="prerequisites.html">Prerequisites</link>)
- </p>
- </li>
- <li>
- <p>
- <strong>Install Apache Tomcat</strong>
- </p>
- <p>
- See <link href="http://jakarta.apache.org/tomcat/tomcat-5.0-doc/setup.html">Tomcat 5.0 Setup</link>
- </p>
- <p>
- <strong>MS Windows:</strong><br/>
- Basically this is setting the <code>JAVA_HOME</code> environment variable and
- running the Tomcat installer. Decide to run Tomcat as a Windows NT/2000/XP-Service.</p>
- <warning>Make sure you do not install at a location with spaces in the path</warning>
- </li>
- <li><p>
- <strong>Configure Lenya</strong></p>
- <p>To install Lenya with Tomcat, you need to edit your build properties. To do this,
- copy <code>$LENYA_HOME/build.properties</code> to
- <code>$LENYA_HOME/local.build.properties</code>.
- </p>
- <p>
- Edit <code>local.build.properties</code>. For the described configuration the following
- settings will work (<strong>MS Windows:</strong> Don't use backslashes "<code>\</code>"
- for directory separation.) It is important that <code>tomcat.home.dir</code> is an
- absolute path. Replace <code>$TOMCAT_HOME</code> by your Tomcat installation directory.
- If your Cocoon source directory is not at <code>../cocoon-2.1</code> relative to Lenya,
- then change the <code>cocoon.webapp.dir</code> and <code>cocoon.src.dir</code> properties.
- </p>
- <ul>
- <li><code>cocoon.src.dir=$COCOON_HOME</code></li>
- <li><code>tomcat.home.dir=$TOMCAT_HOME</code></li>
- </ul>
- <p/>
- </li>
- <li><p>
- <strong>Build Lenya</strong></p>
- <p>
- Execute <code>ant install</code> in your Lenya source directory.
- </p>
- </li>
- <li><p>
- <strong>Restart Tomcat</strong></p>
- <p>
- Restart Tomcat to load the Lenya webapp.
- </p>
- </li>
- <li>
- <p>
- <strong>Test the installation</strong>
- </p>
- <p>
- <link href="http://localhost:8080/lenya">http://localhost:8080/lenya</link>
- </p>
- </li>
- </ol>
-</section>
-</body>
+ <person name="Lenya community" email="lenya-dev@cocoon.apache.org"/>
+ </authors>
+ </header>
+
+ <body>
+ <section id="prerequisites">
+ <title>Prerequisites</title>
+
+ <p>
+ The following list describes the setup that is tested and
+ recommended. Please note that you can use other servlet
+ containers as well, but Jetty and Tomcat are the tested ones.
+ </p>
+
+ <ul>
+ <li>
+ <p>
+ <strong>Java 2 Platform, Standard Edition</strong>
+ <br/>
+ version: 1.4.2 or newer, 1.5.x not tested.
+ <br/>
+ source: <link href="http://java.sun.com/j2se/1.4.2/download.html">http://java.sun.com/j2se/1.4.2/download.html</link>
+ </p>
+ </li>
+
+ <li>
+ <p>
+ <strong>Apache Cocoon</strong>
+ <br/>
+ version: 2.1.5.1
+ <br/>
+ source: <link href="http://cocoon.apache.org/mirror.cgi">http://cocoon.apache.org/mirror.cgi</link>
+ </p>
+
+ <p>
+ Note that Cocoon is needed when building the source
+ version of Lenya, but the resulting Lenya webapp is
+ completely self contained and therefore it does not need
+ the Cocoon webapp to be installed. See the <link
+ href="http://wiki.apache.org/cocoon-lenya/FAQ">FAQ</link>
+ for details of configuration changes required when running
+ multiple Cocoon based applications.
+ </p>
+ </li>
+
+ <li>
+ <p>
+ <strong>(optional) Apache Tomcat</strong> for JDK 1.4
+ <br/>
+ version: 5.0.28 or newer, 5.5.x not tested.
+ <br/>
+ source: <link href="http://jakarta.apache.org/site/binindex.cgi">http://jakarta.apache.org/site/binindex.cgi</link>
+ </p>
+
+ <p>
+ Note that Lenya ships with <link
+ href="http://jetty.mortbay.org/jetty/">Jetty</link> and
+ therefore does not need a servlet container to be installed.
+ </p>
+ </li>
+ </ul>
+ </section>
+
+
+ <section>
+ <title>Standalone Installation (using the built-in Jetty)</title>
+
+ <ol>
+ <li>
+ <p>
+ <strong>Get the Java SDK</strong> (see <link
+ href="#prerequisites">Prerequisites</link>)
+ </p>
+ </li>
+
+ <li>
+ <p>
+ <strong>Get Apache Cocoon</strong> (see <link
+ href="#prerequisites">Prerequisites</link>)
+ </p>
+ </li>
+
+ <li>
+ <p>
+ <strong>Get Apache Lenya</strong> (see <link
+ href="download.html">Download Lenya</link>)
+ </p>
+ </li>
+
+ <li>
+ <p>
+ Extract the downloaded Lenya archive to the
+ <code>lenya-1.2.x</code> directory as described below. If
+ you use Subversion, create your Lenya checkout inside the
+ <code>src</code> directory as described below. It is
+ recommended to use the following directory structure for an
+ easier build experience.
+ </p>
+
+ <source>
+ your_home/ (or c:\ on Windows, NOT My Documents)
+ `-- src/
+ |-- lenya-1.2.x/ $LENYA_HOME
+ `-- cocoon/ $COCOON_HOME
+ `-- build/
+ `-- webapp/ $COCOON_WEBAPP
+ </source>
+ </li>
+
+ <li>
+ <p>
+ <strong>Copy the Cocoon build properties supplied by Lenya</strong>
+ </p>
+
+ <p>
+ Copy the files
+ </p>
+
+ <ul>
+ <li><code>local.build.properties</code></li>
+ <li><code>local.blocks.properties</code></li>
+ </ul>
+
+ <p>
+ from <code>$LENYA_HOME/src/cocoon/</code> to
+ <code>$COCOON_HOME</code>.
+ </p>
+ </li>
+
+ <li>
+ <p>
+ <strong>Compile Cocoon</strong>
+ </p>
+
+ <p>
+ <strong>MS Windows</strong>
+ </p>
+
+ <source>
+ $COCOON_HOME > build.bat
+ </source>
+
+ <p>
+ <strong>Unix</strong>
+ </p>
+
+ <source>
+ $COCOON_HOME > ./build.sh -Dinclude.webapp.libs=yes webapp
+ </source>
+ </li>
+
+ <li>
+ <p>
+ <strong>Configure Lenya</strong>
+ </p>
+
+ <p>
+ If your Cocoon source tree is set up as described above, you
+ can skip this step. If your Cocoon source tree is not at
+ <code>../cocoon</code> relative to Lenya, you need
+ to edit your build properties. To do this, copy
+ <code>$LENYA_HOME/build.properties</code> to
+ <code>$LENYA_HOME/local.build.properties</code>.
+ </p>
+
+ <p>
+ Edit <code>local.build.properties</code>. For the described
+ configuration the following settings will work (<strong>MS
+ Windows:</strong> Don't use backslashes "<code>\</code>" for
+ directory separation.)
+ </p>
+
+ <ul>
+ <li><code>cocoon.src.dir=$COCOON_HOME</code></li>
+ <li><code>tomcat.home.dir=$TOMCAT_HOME</code></li>
+ </ul>
+ </li>
+
+ <li>
+ <p>
+ <strong>Build Lenya</strong>
+ </p>
+
+ <p>
+ Execute <code>build.bat</code> or <code>build.sh</code> in
+ your Lenya source directory, depending on your platform.
+ </p>
+
+ <p>
+ <strong>MS Windows</strong>
+ </p>
+
+ <source>
+ $LENYA_HOME > build.bat
+ </source>
+
+ <p>
+ <strong>Unix</strong>
+ </p>
+
+ <source>
+ $LENYA_HOME > ./build.sh
+ </source>
+ </li>
+
+ <li>
+ <p>
+ <strong>Start Lenya</strong>
+ </p>
+
+ <p>
+ Execute <code>lenya.bat</code> or <code>lenya.sh
+ servlet</code> in your Lenya source directory, depending on
+ your platform. Make sure that you have the environment
+ variable <code>JAVA_HOME</code> defined to point to the
+ location of the Java SDK you installed (see <link
+ href="#prerequisites">Prerequisites</link>).
+ </p>
+
+ <p>
+ <strong>MS Windows</strong>
+ </p>
+
+ <source>
+ $LENYA_HOME > lenya.bat
+ </source>
+
+ <p>
+ <strong>Unix</strong>
+ </p>
+
+ <source>
+ $LENYA_HOME > ./lenya.sh servlet
+ </source>
+ </li>
+
+ <li>
+ <p>
+ <strong>Test the installation</strong>
+ </p>
+
+ <p>
+ <link href="http://localhost:8888">http://localhost:8888/</link>
+ </p>
+ </li>
+ </ol>
+ </section>
+
+ <section>
+ <title>Installation with Apache Tomcat</title>
+
+ <p>
+ Installing Lenya with Tomcat is mostly the same
+ procedure. Follow Steps 1-6, then do the steps below.
+ </p>
+
+ <ol>
+ <li>
+ <p>
+ <strong>get Apache Tomcat</strong> (see <link
+ href="#prerequisites">Prerequisites</link>)
+ </p>
+ </li>
+
+ <li>
+ <p>
+ <strong>Install Apache Tomcat</strong>
+ </p>
+
+ <p>
+ See <link
+ href="http://jakarta.apache.org/tomcat/tomcat-5.0-doc/setup.html">Tomcat
+ 5.0 Setup</link>
+ </p>
+
+ <p>
+ <strong>MS Windows:</strong>
+
+ <br/>
+
+ Basically this is setting the <code>JAVA_HOME</code>
+ environment variable and running the Tomcat
+ installer. Decide to run Tomcat as a Windows
+ NT/2000/XP-Service.
+ </p>
+
+ <warning>
+ Make sure you do not install at a location with spaces in
+ the path.
+ </warning>
+ </li>
+
+ <li>
+ <p>
+ <strong>Configure Lenya</strong>
+ </p>
+
+ <p>
+ To install Lenya with Tomcat, you need to edit your build
+ properties. To do this, copy
+ <code>$LENYA_HOME/build.properties</code> to
+ <code>$LENYA_HOME/local.build.properties</code>.
+ </p>
+
+ <p>
+ Edit <code>local.build.properties</code>. For the described
+ configuration the following settings will work (<strong>MS
+ Windows:</strong> Don't use backslashes "<code>\</code>" for
+ directory separation.) It is important that
+ <code>tomcat.home.dir</code> is an absolute path. Replace
+ <code>$TOMCAT_HOME</code> by your Tomcat installation
+ directory. If your Cocoon source directory is not at
+ <code>../cocoon-2.1.5.1</code> relative to Lenya, then change
+ the <code>cocoon.webapp.dir</code> and
+ <code>cocoon.src.dir</code> properties.
+ </p>
+
+ <ul>
+ <li><code>cocoon.src.dir=$COCOON_HOME</code></li>
+ <li><code>tomcat.home.dir=$TOMCAT_HOME</code></li>
+ </ul>
+ </li>
+
+ <li>
+ <p>
+ <strong>Build Lenya</strong>
+ </p>
+
+ <p>
+ Execute <code>ant install</code> in your Lenya source directory.
+ </p>
+ </li>
+
+ <li>
+ <p>
+ <strong>Checked versions of endorsed libraries</strong>
+ </p>
+
+ <p>
+ Lenya and Tomcat will inter-operate correctly only if the proper
+ versions of the Xalan and Xerces libraries are used consistently
+ throughout the deployment. Unfortunately this can be difficult
+ to get to work correctly since both of these libraries are
+ shipped with Java 2 SDK, Tomcat, Cocoon and Lenya.
+ </p>
+
+ <p>
+ The following libraries must be placed in the endorsed library
+ directory for your deployment.
+ </p>
+
+ <ul>
+ <li><code>jakarta-bcel-20040329.jar</code></li>
+ <li><code>jakarta-regexp-1.3.jar</code></li>
+ <li><code>xalan-2.6.0.jar</code></li>
+ <li><code>xercesImpl-2.6.2.jar</code></li>
+ <li><code>xml-apis.jar</code></li>
+ </ul>
+
+ <p>
+ They are placed by the build process in the directory specified
+ by <code>tomcat.endorsed.dir</code> in
+ <code>build.properties</code>. You should validate that these
+ files are indeed in the proper location for your deployment.
+ You must then validate that no other instances of these
+ libraries exist in any of the following directories:
+ </p>
+
+ <ul>
+ <li>
+ The Java 2 SDK endorsed standards directories. This is
+ usually <code>${JAVA_HOME}/lib/endorsed/</code>.
+ </li>
+
+ <li>
+ Any other location in your Tomcat deployment. Specifically,
+ check <code>shared/lib/</code>, <code>common/lib/</code> and
+ <code>server/lib/</code>.
+ </li>
+
+ <li>
+ Any other location in your Lenya deployment. Specifically,
+ check <code>webapps/lenya/WEB-INF/lib/</code>.
+ </li>
+ </ul>
+
+ <p>
+ A common symptom of incorrect library version are blank pages
+ after starting Lenya. Try carefully checking the location and
+ version numbers of each of the libraries.
+ </p>
+
+ <p>
+ References:
+ </p>
+
+ <ul>
+ <li>
+ <link href="http://jakarta.apache.org/tomcat/tomcat-5.0-doc/class-loader-howto.html">
+ Tomcat Class Loader HOWTO (http://jakarta.apache.org/tomcat/tomcat-5.0-doc/class-loader-howto.html)
+ </link>
+ </li>
+
+ <li>
+ <link href="http://java.sun.com/j2se/1.4.2/docs/guide/standards/index.html">
+ Java 2 Endorsed Standards Override Mechanism
+ (http://java.sun.com/j2se/1.4.2/docs/guide/standards/index.html)
+ </link>
+ </li>
+ </ul>
+ </li>
+
+ <li>
+ <p>
+ <strong>Restart Tomcat</strong>
+ </p>
+
+ <p>
+ Restart Tomcat to load the Lenya webapp.
+ </p>
+ </li>
+
+ <li>
+ <p>
+ <strong>Test the installation</strong>
+ </p>
+
+ <p>
+ <link href="http://localhost:8080/lenya">http://localhost:8080/lenya/</link>
+ </p>
+ </li>
+ </ol>
+ </section>
+ </body>
</document>
Modified: lenya/docu/src/documentation/content/xdocs/installation/subversion.xml
==============================================================================
--- lenya/docu/src/documentation/content/xdocs/installation/subversion.xml (original)
+++ lenya/docu/src/documentation/content/xdocs/installation/subversion.xml Thu Nov 11 21:19:35 2004
@@ -37,7 +37,7 @@
Start the shell of your choice and enter:
</p>
<source>
-svn co http://svn.apache.org/repos/asf/lenya/trunk lenya-trunk
+svn co http://svn.apache.org/repos/asf/lenya/branches/BRANCH_1_2_X lenya-1.2.x
</source>
</section>
@@ -47,18 +47,17 @@
Start the shell of your choice and enter:
</p>
<source>
-svn co http://svn.apache.org/repos/asf/incubator/lenya lenya
+svn co https://svn.apache.org/repos/asf/lenya/branches/BRANCH_1_2_X lenya-1.2.x
ssh -l username svn.apache.org
svnpasswd username
exit
-svn sw --relocate http://svn.apache.org/repos/asf/incubator/lenya https://svn.apache.org/repos/asf/incubator/lenya
</source>
</section>
<section>
<title>View Subversion</title>
<p>
-<link href="http://svn.apache.org/repos/asf/lenya/trunk/">http://svn.apache.org/repos/asf/lenya/trunk/</link>
+<link href="http://svn.apache.org/viewcvs.cgi/lenya/#dirlist">http://svn.apache.org/viewcvs.cgi/lenya/#dirlist</link>
</p>
</section>
Modified: lenya/docu/src/documentation/content/xdocs/site.xml
==============================================================================
--- lenya/docu/src/documentation/content/xdocs/site.xml (original)
+++ lenya/docu/src/documentation/content/xdocs/site.xml Thu Nov 11 21:19:35 2004
@@ -27,7 +27,6 @@
<node-i href="related-projects.html" label="Related Projects"/>
</project-information>
<installation href="installation/" label="Installation" tab="installation">
- <prerequisites href="prerequisites.html" label="Prerequisites"/>
<download href="index.html" label="Download"/>
<cvs href="subversion.html" label="Subversion Access"/>
<install href="source_version.html" label="Installation Instructions"/>
@@ -225,7 +224,7 @@
</cocoon.2.1>
<lenya href="lenya/"/>
</cocoon>
- <cvs.asf href="http://cvs.apache.org/">
+ <cvs.asf href="http://svn.apache.org/">
<cvs.incubator href="dist/incubator/">
<incubator.lenya href="lenya/"/>
</cvs.incubator>
@@ -240,9 +239,10 @@
<issues.open.bugs.enhancement href="bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_severity=Enhancement&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=Lenya&short_desc=&short_desc_type=allwordssubstr&long_desc=&long_desc_type=allwordssubstr&bug_file_loc=&bug_file_loc_type=allwordssubstr&keywords=&keywords_type=anywords&field0-0-0=short_desc&type0-0-0=notsubstring&value0-0-0=%5BPatch%5D&field0-0-1=noop&type0-0-1=noop&value0-0-1=&cmdtype=doit&newqueryname=&order=Reuse+same+sort+as+last+time"/>
</issues.list>
</issues>
- <nightly.builds href="http://cvs.wyona.org/nightly-builds/"/>
+ <nightly.builds href="http://svn.apache.org/snapshots/lenya/"/>
<nzz href="http://www.nzz.ch"/>
<opensource.org href="http://www.opensource.org/"/>
+ <releases href="http://www.apache.org/dyn/closer.cgi/lenya/"/>
<w3c href="http://www.w3c.org/">
<w3c.xml href="XML/"/>
<w3c.xslt href="TR/xslt/"/>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@lenya.apache.org
For additional commands, e-mail: commits-help@lenya.apache.org