blob: 78b6557630eb21184c38d1e8aeb3deda805ee9a5 [file] [log] [blame]
+----------------------------------------------------------------+
| This text document is generated from the XML source |
| using the follwoing stylesheet: |
| lenya/pubs/docs-new/xslt/document2txt.xsl |
| |
| Feel free to improve the layout by changing the stylesheet. |
+----------------------------------------------------------------+
PREREQUISITES
=============
by Andreas Hartmann
The following list describes the setup that is tested and recommended.
Several items, e.g. the servlet container, may be replaced by other products.
* Java 2 Platform, Standard Edition (recommended: J2SE 1.4.2)http://java.sun.com/j2se/1.4.2/download.html [http://java.sun.com/j2se/1.4.2/download.html]
* Apache Tomcat for JDK 1.4 (recommended: 4.1.29)Tomcat release builds [http://www.apache.org/dist/jakarta/tomcat-4/v4.1.29/bin/]
Pick one of the jakarta-tomcat-4.1.24-LE-jdk14 files!
* Apache Ant (recommended: 1.6b2)Ant main distribution directory [http://www.apache.org/dist/ant/]
* Apache Cocoon (required: Cocoon 2.1.2)Cocoon download page [http://cocoon.apache.org/mirror.cgi]
* Endorsed Libraries (recommended: Xalan 2.5.0 Xerces 2.5.0)
INSTALLATION OF THE SOURCE VERSION
==================================
by Jan Prill, Andreas Hartmann, Gregor J. Rothfuss
CONTENTS
1. Example directory structure
2. Installation
1. Example directory structure
------------------------------
If you're new to all this, it is recommended to use the following directory
structure:
your_home (or c:\ on Windows, NOT My Dcouments)
/src
/cocoon-lenya $LENYA_HOME
/cocoon-2.1 $COCOON_HOME
/build
/webapp $COCOON_WEBAPP
/build
/tomcat-4.1.24 $TOMCAT_HOME
/ant-1.5.3
2. Installation
---------------
1. Get the Java SDK (see Prerequisites [prerequisites.html])
2. Get Apache Tomcat (see Prerequisites [prerequisites.html])
3. Install Tomcat
See Running The Tomcat 4.0 Servlet/JSP Container [http://jakarta.apache.org/tomcat/tomcat-4.1-doc/RUNNING.txt]
MS Windows:
Basically this is setting the JAVA_HOME environment variable and
double-clicking on tomcat-4.1.24.exe. Decide to run Tomcat as a Windows NT/2000/XP-Service.
.................................................
WARNING:
Make sure you do not install at a location with spaces in the path
.................................................
4. Check if Tomcat is running
http://localhost:8080 [http://localhost:8080].
5. Stop the Tomcat service
MS Windows:
If you don't know how, try Start > Help > Services.
6. Get Apache Ant (see Prerequisites [prerequisites.html])
7. Install Ant
See section Installing Ant [http://ant.apache.org/manual/install.html] of the Ant Manual
MS Windows
Set a few environment variables, e.g.:
* JAVA_HOME = C:\Programme\j2sdk1.4.1_01
* ANT_HOME = C:\Programme\Apache Group\apache-ant-1.5.2
* CATALINA_HOME = C:\build\tomcat-4.1.24
* CLASSPATH = .\;C:\Programme\Apache Group\apache-ant-1.5.2\lib
* PATH = <snip>;C:\Programme\j2sdk1.4.1_01\bin;C:\Programme\Apache Group\apache-ant-1.5.2\bin
8. Get Apache Cocoon (see Prerequisites [prerequisites.html])
9. Copy the Cocoon build properties supplied by Lenya
Copy the files
* local.build.properties
* local.blocks.properties
from $LENYA_HOME/src/cocoon to $COCOON_HOME.
10. Compile Cocoon
MS Windows
$COCOON_HOME > build.bat
Unix
$COCOON_HOME > ./build.sh -Dinclude.webapp.libs=yes webapp
See also Installing Apache Cocoon [http://cocoon.apache.org/2.0/installing/index.html]
11.
If you have downloaded the source version: Extract Lenya
Extract the downloaded Lenya archive to a directory of your choice.
12. Configure Lenya
Copy $LENYA_HOME/build.properties.sample to
$LENYA_HOME/build.properties.
Edit build.properties. For the described configuration the following
settings will work (MS Windows: Don't use backslashes "\"
for directory separation.). It is important that tomcat.home.dir is an
absolute path. The asterisk (*) has to be replaced by the appropriate version number.
Replace $TOMCAT_HOME by your tomcat installation directory.
* cocoon.webapp.dir=$COCOON_HOME/build/webapp
* pubs.root.dirs=src/webapp/lenya/pubs
* tomcat.home.dir=$TOMCAT_HOME
13. Build Lenya
$LENYA_HOME > ant install
14. Restart the Tomcat service
MS Windows:Start > All Programs > Apache Tomcat > Stop TomcatStart > All Programs > Apache Tomcat > Start Tomcat
or
$TOMCAT_HOME\bin > shutdown.bat
$TOMCAT_HOME\bin > startup.bat
Unix:
$TOMCAT_HOME/bin > ./shutdown.sh
$TOMCAT_HOME/bin > ./startup.sh
15. Test the installation
http://localhost:8080/lenya [http://localhost:8080/lenya]