WG: Re: [Wyonacms-dev] Installing Instructions winnt

Well, here is a reedited version of the win installing.
There is still one of Memo's comments in there. I do have this Standalone
directory in my tomcat work directory. Maybe someone can check this. All
other comments are integrated.
Margrit


> Okay, I'll do it, but give some time. Next week, I am really busy doing
other
> things, so the week after. Okay?


Sure, take your time. I am not a Windows user;-)

Thanks

Michael


>
> Margrit
>
>
>>Memo, thanks for proof reading.
>>
>>Shouldn't we try to combine the Win and UNIX INSTALL-SRC
>>within one Document (XML!)?
>>
>>Margrit, are you going to reedit/incorporate Memo's comments?
>>
>>Thanks
>>
>>Michael
>>
>>Mehmet Birgi wrote:
>>
>>>I have attached a commented version of the how-to (comments in <comment>
>>>tags) to this post. I do not have the time and ressources to test it
>>>actually (new PC, not everything installed yet), but with those
>>>comments, it should work. If anybody is still having trouble, I will
>>>gladly install and test everything, but I prefer not doing it right now
>>>if it is not necessary :-)
>>>
>>>Anyway, I am always here if support is needed, just drop me a mail (in
>>>case I don't have the time to catch up with the list).
>>>
>>>Cheers,
>>>
>>>Memo
>>>
>>>Mehmet Birgi wrote:
>>>
>>>>Michael Wechner wrote:
>>>>
>>>>>Dear Margrit
>>>>>
>>>>>Thanks a lot for your contribution.
>>>>>Maybe a Windows user (Memo?:-) could proof-read it.
>>>>>
>>>>sure will do, but I have only windows xp installed at the moment, is
>>>>that ok if i try it out on that?
>>>>
>>>>cheers,
>>>>
>>>>memo
>>>>
>>>>
>>>>>All the best
>>>>>
>>>>>Michael
>>>>>
>>>>>Margrit John wrote:
>>>>>
>>>>>>Michael asked me to post this here.
>>>>>>You'll find attached a guide on how to install wyonacms on winnt.
>>>>>>
>>>>>>Margrit
>>>>>>
>>>>>>
>>>>>>----------------------------------------------------------------------
>>>>>>--
>>>>>>
>>>>>>
>>>>>>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\/localh
>>>>>>ost\/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
>>>>>>
>>>>>_______________________________________________
>>>>>WyonaCMS-dev mailing list
>>>>>[email protected]
>>>>>http://mail.wyona.org/cgi-bin/mailman/listinfo/wyonacms-dev
>>>>>
>>>>_______________________________________________
>>>>WyonaCMS-dev mailing list
>>>>[email protected]
>>>>http://mail.wyona.org/cgi-bin/mailman/listinfo/wyonacms-dev
>>>>
>>>------------------------------------------------------------------------
>>>
>>>==============================================================
>>>
>>>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
>>>--------
>>>- Prerequisites
>>>- Directory structure
>>>- Installation-Notes
>>>
>>>
>>>Prerequisites
>>>-------------
>>>
>>>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:\
>>>
>>><comment>
>>>I believe that java could be installed anywhere, and most people already
>>>have java installed, so specifiying "c:/" seems confusing to me. I think
>>>that you should just point out that "JDK should be installed, for details
>>>see http://java.sun.com/" </comment>
>>>
>>>
>>>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
>>>
>>><comment>
>>>I don't think that setting the environment variables in a DOS-Box is
>>>pertinent in *real* windowses like NT, 2000, and XP. Instead go to
>>>"Control Panel / System / Advanced / Environment Variables" (this is XP,
>>>other wins might be slightly different) and set them there. Important:
>>>close all DOS-Boxes *and* all Explorer windows, then reopen them to make
>>>the new environment variables active.
>>></comment>
>>>
>>>(Make shure you write the path according to your directory structure and
>>>names)
>>>
>>><comment>
>>>"sure", not "shure" :-)
>>></comment>
>>>
>>>Start Tomcat:
>>>
>>>C:\cms\build\jakarta-tomcat-4.0\bin\startup.bat
>>>
>>><comment>
>>>Getting Tomcat to start can sometimes be a little tiring, especially
>>>because when you use startup.bat, Catalina will open in a new DOS-Box,
>>>and if it does not start, this DOS-Box will be closed immediately, making
>>>it impossible to read any error messages. Tip: use "catalina.bat run"
>>>instead of "startup.bat" until you get Tomcat running correctly, this
>>>won't open a new DOS-Box.
>>></comment>
>>>
>>>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"
>>>
>>><comment>
>>>Do you really want to use the nightly builds? Daring, I must say :-)
>>></comment>
>>>
>>>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 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)
>>>
>>><comment>
>>>Are you sure about the double slashes ("\/")? As far as I know, using
>>>forward-slashes is enough, ant will translate them to backslahes if
>>>needed. So you could write "C:/foo/bar" for paths on windows systems.
>>>This works for sure.
>>>Also, I don't remember the "Standalone" part of the cache directory. I
>>>don't have Tomcat installed right now, if you need clarification on that,
>>>pls let me know, and I will test. </comment>
>>>
>>>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)
>>>
>>><comment>
>>>I don't understand this information. Why is this needed?
>>></comment>
>>>
>>>    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
>>>
>>_______________________________________________
>>WyonaCMS-dev mailing list
>>[email protected]
>>http://mail.wyona.org/cgi-bin/mailman/listinfo/wyonacms-dev
>>
>




_______________________________________________
WyonaCMS-users mailing list
[email protected]
http://mail.wyona.org/cgi-bin/mailman/listinfo/wyonacms-users

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

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
--------
- Prerequisites
- Directory structure
- Installation-Notes


Prerequisites
-------------

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.


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"


Set your environment variables
Go to:
Control Panel / System / Advanced / Environment Variables

ANT_HOME  path to "jakarta-ant"
CATALINA_HOME path to "jakarta-tomcat"
JAVA_HOME path to "jdk"
PATH %PATH%;%ANT_HOME%\bin

(Make sure you write the path according to your directory structure and names)


Start Tomcat:

Start a dos window:
( dos commands are marked with a > )
> path to "jakarta-tomcat"\bin\startup.bat
Tip: use "catalina.bat run" instead of "startup.bat" until you get Tomcat running correctly, this won't open a new dos-box.



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

Stop Tomcat:

> path to "jakarta-tomcat"\bin\shutdown.bat




2) Get and install Ant

Download jakarta-ant from http://jakarta.apache.org/builds/jakarta-ant/
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 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 sure, you write the appropriate path)

<comment>
Also, I don't remember the "Standalone" part of the cache directory. I don't have Tomcat installed 
right now, if you need clarification on that, pls let me know, and I will test.
</comment>

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 (if you want to run two or more tomcat at the same time, you can change the following 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