INSTALL-SRC.txt

  W Y O N A    C O N T E N T - M A N A G E M E N T - S Y S T E M
  ==============================================================


  Contents
  --------

  -Prerequisite
  -Installation
  -Notes


  Prerequisite
  ------------

  You need to have an installed Apache Ant 1.4. 
  
  Point your favorite browser to http://jakarta.apache.org/ant and get a 
  version 1.4 or greater distribution and installation instructions there.

  (To view targets: ant -projecthelp)


  Installation
  ------------

  1) Get, install, start, try and stop Tomcat

     [unix]  cd /home/wyona/build
             wget http://jakarta.apache.org/builds/jakarta-tomcat-4.0/nightly/jakarta-tomcat-4.0-20020110.tar.gz
             tar -xzf jakarta-tomcat-4.0-20020110.tar.gz
             export JAVA_HOME=/usr/local/jdk1.3.1
             export CATALINA_HOME=/home/wyona/build/jakarta-tomcat-4.0
             /home/wyona/build/jakarta-tomcat-4.0/bin/startup.sh
             lynx http://localhost:8080
             /home/wyona/build/jakarta-tomcat-4.0/bin/shutdown.sh


  2) Get and install Ant

     [unix]  cd /home/wyona/build
             wget http://jakarta.apache.org/builds/jakarta-ant/release/v1.4.1/bin/jakarta-ant-1.4.1-bin.tar.gz
             tar -xzf jakarta-ant-1.4.1-bin.tar.gz


  3) Get Wyona

     [unix]  cd /home/wyona/src
             wget http://www.wyona.org/builds/wyona-cms-2.0/nightly/src/wyona-cms-2.0-src-200201102354.tar.gz
             tar -xzf wyona-cms-2.0-src-200201102354.tar.gz
             cd wyona-cms-2.0-src
             ls


  4) Get, build and copy Cocoon 
     (OPTIONAL: Just in case you want the most recent Cocoon. If not, then go to 5)

     [unix]  cd /home/wyona/src
             wget http://cvs.apache.org/snapshots/xml-cocoon2/xml-cocoon2_20020110171938.tar.gz
             tar -xzf xml-cocoon2_20020110171938.tar.gz
             cd xml-cocoon2
             export JAVA_HOME=/usr/local/jdk1.3.1
             ./build.sh -Dinclude.webapp.libs=yes webapp
             cp build/cocoon/cocoon.war ../wyona-cms-2.0-src/.


  5) Build Wyona

     [unix]  cd /home/wyona/src/wyona-cms-2.0-src
             export JAVA_HOME=/usr/local/jdk1.3.1
             export ANT_HOME=/home/wyona/build/jakarta-ant-1.4.1
             export PATH=/home/wyona/build/jakarta-ant-1.4.1/bin:$PATH
             ant
             ls build/wyona-cms/webapp


  6) Install Wyona for Development

     [unix]  cp build.properties.sample build.properties
             vi build.properties (Set install.dir and cache.dir)
             ant install
             ls install.dir (Check if things actually got copied into "install.dir", where "install.dir" is not the string "install.dir", but the value you have set within build.properties)
             vi /home/wyona/build/jakarta-tomcat-4.0/conf/server.xml
             To allow class reloading, insert the following line:
             <Context path="/wyona-cms" docBase="wyona-cms" debug="0" reloadable="true" crossContext="true"/>


  7) Start Wyona

     [unix]  (/home/wyona/build/jakarta-tomcat-4.0/bin/shutdown.sh)
             ("rm -r /home/wyona/build/jakarta-tomcat-4.0/work/*" OR "ant reset". This is the "cache.dir" directory which can be set within build.properties)
             /home/wyona/build/jakarta-tomcat-4.0/bin/startup.sh
             lynx http://localhost:8080/wyona-cms/


  8) Start Hacking Wyona

     [unix]  cd /home/wyona/src/wyona-cms-2.0-src
             ls src/java
             ls src/webapp
             vi src/webapp/WEB-INF/logkit.xconf   (DEBUG, ERROR)
             vi src/webapp/cocoon.xconf   (asynchron, synchron)
             ant install
             tail -f build/webapp/WEB-INF/logs/* | grep Sitemap -B10
             lynx http://localhost:8080/wyona-cms/


  9) Stop Wyona

     [unix]  /home/wyona/build/jakarta-tomcat-4.0/bin/shutdown.sh
             "rm -r /home/wyona/build/jakarta-tomcat-4.0/work/*" OR "ant reset"
             ps aux | grep java | wc ("killall java")


  Notes 
  -----

  1) Overwrite

     Wyona is overwriting some Cocoon files:
     -sitemap.xmap
      The original Cocoon Sitemap is mounted from the Wyona Sitemap
     -cocoon.xconf
      In order to simplify development we use "synchron"
     -logkit.xconf
      We replaced DEBUG by ERROR


  2) Used Default Ports

     8080: Tomcat: server.xml
     8008: Tomcat(Catalina)-Apache: server.xml
     8005: Shutdown: server.xml
     9002: HypersonicSQL DB (http://www.hsqldb.org): cocoon.xconf