Installing Instructions winnt

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

==============================================================  

Content
-------- 

-Prerequisite
-Directory structure
-Installation  
-Notes


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

You need a tool to extract files
for example powerarchiver or winzip. You can get it from:
http://www.powerarchiver.com/download/
http://www.winzip.com
  

You need to have installed jdk.
Point your favorite browser to http://java.sun.com 
Get the jdk and install it in c:\



Directory structure
-------------------

make a directory "cms" and within this directory two others "build" and "src"
Put in your "cms\build" directory "Tomcat" and "Ant" (Description follows)
Put the wyona-cms in your "cms\src" directory (Description follows)  



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

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

Download jakarta-tomcat-4.0 or a newer version from http://jakarta.apache.org/builds/
Extract it to the directory "cms\build"

Start a dos window ant type: 

( dos commands are marked with a > )

> set ANT_HOME=c:\cms\build\jakarta-ant-1.4.1
> set CATALINA_HOME=C:\cms\build\jakarta-tomcat-4.0
> set JAVA_HOME=c:\jdk1.3.1_03
> set PATH=%PATH%;%ANT_HOME%\bin
(Make shure you write the path according to your directory structure and names)

Start Tomcat:
> C:\cms\build\jakarta-tomcat-4.0\bin\startup.bat

Point your favorite browser to http://localhost:8080
(You should get the tomcat start page)

Stop Tomcat:
> C:\cms\build\jakarta-tomcat4.0\bin\shutdown.bat



2) Get and install Ant

Download jakarta-ant from http://jakarta.apache.org/builds/jakarta-ant/nightly/
Extract it to the directory "cms\build"
 

3) Get Wyona

choose a) or b)

a) Download the newest wyona snapshot from http://www.wyona.org/download
Extract it to the directory "cms\src\"


rename this directory wyonacms:
> move wyona-cms-2.1-dev-src-20020605123945 wyonacms (write the actual name of your 
 downloaded file)

b) Get wyonacms from the CVS Server

1.Download WinCVS (v1.2) (homepage is http://www.wincvs.org/); 
2.Install it; 
3.Start it; 
4.Click on admin->commandline
5.In "Enter a cvs line command" enter 
cvs -d :pserver:[email protected]:/repository checkout wyonacms
(No password needed)
6.If everything goes well, messages will start to appear in the log window; 
7.Wait until you see "*****CVS exited normally with code 0*****" in the log window; 
8.The wyonacms source is now on your harddrive. 

Make shure the the downloaded "wyonacms" is in the directory "cms\src\"



4) Build Wyona

> cd C:\cms\src\wyonacms
> ant



5) Install Wyona for Development

make a copy of build.properties.sample and name it: build.properties
In this file you have to set "install.dir" and "cache.dir"
as follows:
install.dir=C:\/cms\/build\/jakarta-tomcat-4.0\/webapps\/wyona-cms
cache.dir=C:\/cms\/build\/jakarta-tomcat-4.0\/work\/Standalone\/localhost\/wyona-cms
(Make shure, you write the matching name of your tomcat version)

> ant install

Check if install.dir and cache.dir worked.
Go to the jakarta-tomcat-4.0 directory. In the webapps directory there must be  a "wyona-cms" directory
and another wyona-cms in the work\Standalone\localhost directory

To allow class reloading insert the following line:
<Context path="/wyona-cms" docBase="wyona-cms" debug="0" reloadable="true" crossContext="true"/>
into the file:
C:\cms\build\jakarta-tomcat-4.0\conf\server.xml



6) Start Wyona

> cd C:\cms\src\wyonacms
> ant reset (This removes the files from the cache directory)
> C:\cms\build\jakarta-tomcat-4.0\bin\startup.bat

Point your browser to:
http://localhost:8080/wyona-cms/

You should see the wyonacms start page.


  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)  Reconfigure Ports

     1) Tomcat port: TOMCAT\conf\server.xml (default: 8080)
     2) Catalina port: TOMCAT\conf\server.xml (default: 8008)
     3) Tomcat shutdown port: TOMCAT\conf\server.xml (default: 8005)
     4) HypersonicSQL DB port(http://www.hsqldb.org): TOMCAT\webapps\wyona-cms\WEB-INF\cocoon.xconf (default: 9002)

  
  3) Usefull informations for wyonacms

     The Cocoon site is good place to find information on all kinds of things:
     http://xml.apache.org/cocoon/

     http://www.wyona.org provides information on the wyonacms project