Re: beginner

Hi Matt, hi List,

finally my new eMac arrived, so I could work on the open task 
promised some days ago. Allthough to install Tomcat on Mac OS X you 
will act like a little UNIX-geek (aka using a terminal and typing 
strange commands), I tried to keep the instructions as simple as 
possible, so somebody without any experience w/ UNIX  should be able 
to understand them too.

My Config:
MAC OS X 10.1.4
eMac PPC G4 / 700 / 640 MB RAM
JAVA 1.3.1

Usefull references
http://developer.apple.com/internet/java/tomcat1.html
http://xml.apache.org/cocoon/
http://jakarta.apache.org/tomcat/index.html

Scope
Description of an easy way how to set up Tomcat on Mac OS X in order 
to use the Wyona CMS

1. Installing Tomcat

1.1. Download Tomcat
- go to the Tomcat homepage
   http://jakarta.apache.org/tomcat/index.html
- Select a binary release build to download
    I choose the 4.0.4 release (filename: jakarta-tomcat-4.0.4.tar.gz
   http://jakarta.apache.org/builds/jakarta-tomcat-4.0/release/v4.0.4/bin/ )
- I downloaded the file to a sub-directory of my homedir named
   "dwnld" (actually you can download the file wherever you want to)
- If the download is finished Stuffit expands the archive automatically

1.2. Put Tomcat in the right place
- Start the Terminal
- Change user to sudo (type: "sudo" press enter and enter the password)
- Read carfully the text: you're now root and should know
   what you're doing
- Change to your download folder
    (in my case, I had to type: "cd dwnld")
- Move all the Tomcat-Files to a more appropriate place
    (type: "mv jakarta-tomcat-4.0.4/ /usr/local/")
- Change owner of the Tomcat-Files
    (type: "chown -R your_username:staff /usr/local/jakarta-tomcat-4.0.4/")
    --> replace your_username with your username on your system
- Close the Terminal
    (type: "exit" and close the terminal window)

1.3 Create start- and shutdown-files
- within your homedir create an subdirectory called "bin"
- Open the texteditor of your choice (ex. BBEdit)
- Create a file named "start_tomcat" with this contents:
      #!/bin/sh
      export CATALINA_HOME=/usr/local/jakarta-tomcat-4.0.4
      export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Home
      $CATALINA_HOME/bin/startup.sh
- Create a file named "stop_tomcat" whit this contents:
      #!/bin/sh
      export CATALINA_HOME=/usr/local/jakarta-tomcat-4.0.4
      export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Home
      $CATALINA_HOME/bin/shutdown.sh
- Save both files to in the directory "bin" in your homedir
- check if the path to CATALINA_HOME (the location where you
   put copied tomcat to some minutes ago) and JAVA_HOME (the
   location where your Java VM lies) are set correct
- open the terminal again and change to the directory "bin"
    (type: "cd bin/")
- make these files executable
    (type: "chmod ug+x start_tomcat stop_tomcat")

1.4 Test tomcat
- go to the terminal and
   (type: ~/bin/start_tomcat)
- open the webbrowser of your choice and go to the URL
    http://localhost:8080/
    --> Be sure, that you don't omit the "http://" !!!
- You should see the startup-page of tomcat in your webbrowser

2. Installing Wyona

2.1 Download Wyona
- go the the wyona-Homepage and download the latest
    LINUX snapshot
- I downloaded the file to a sub-directory of my homedir named
   "dwnld"
- If the download is finished Stuffit expands the archive automatically

2.2 Put Wyona in the right place
- Open the terminal
- Change to the directory you downloaded Wyona to
   (type: "dwnld")
- move the war-file to the webapp-directory of  tomcat
   (type: "wyona-cms.war /usr/local/jakarta-tomcat-4.0.4/webapps/")

2.3 Restart Tomcat
- Go to the terminal
- stop Tomcat
   (type : ~/bin/stop_tomcat)
   --> you'll need this command if you intend to shutdown Tomcat at
        other occasions
- restart Tomcat
   (type : ~/bin/start_tomcat)
    --> you'll need this command anytime you will start Tomcat
- open the webbrowser of your choice and go to the URL
    http://localhost:8080/wyona-cms
    --> Be sure, that you don't omit the "http://" !!!

So, you're now set with Tomcat and Wyona up and running. Therefore 
you can start to play around with Tomcat, Cocoon and Wyona. If you 
get bored after a couple of days, there are a lot of things to do: 
Play around with Tomcat's server.xml, serving the pages through 
Apache et cetera.

Anyway, I hope, that these first step will help you to get your feet 
wet. If something is wrong or not understandable, please feel free to 
contact me.

Markus




>  >
>>I can't tell you what are the exact steps to be taken to get Wyona on
>>your OS X up and running. I hope, that in a couple of days I am able
>>to answer your question profundly, 'cause I'm waiting for my new Mac
>>to arrive (just have an old iMac w/ 9.x). So be patient, or dive
>>alone into a new world full of adventure ;-)
>>
>>However, on my LINUX-Box, I first installed a JDK and afterwards
>>Tomcat (Java Application Server). As the last step I put the
>>wyona.war-File (from the Snapshot-Download) in the webapps-directory
>>of Tomcat and started Tomcat. And.... it ran: yeeepi! I guess you
>>have to take the same steps on OS X. All the required steps (at least
>>for *NIX) are documented in the READMEs and on the web.
>>Allthough I found the following page that might be of help for you to
>>get Tomcat up and running.
>>
>>http://developer.apple.com/internet/java/index.html
>>
>>During the last weeks I was playing around more with Cocoon
>>(automatically deployed if you use an Wyona-Snapshot) than Wyona. I
>>made a couple of small and simple pages to get my feet wet with XSLT
>>and the sitemap of Cocoon. To achieve this I used BBEdit (also exists
>>on OS X), because I rather like to work with my Mac than with an
>>killer-app like "vi". So, I ftp'd with BBEdit to my LINUX-Box and
>>created the files.
>>
>>As far as I know, BBEdit is the best tool, to edit text on the mac.
>>And working with XML/XSLT is editing text, at least in the way I'm
>>using it. If you are doing bigger jobs, there are more specialised
>>products on the market. However these I know of, run on Windows (eq.
>>XML Spy). Another useful resource  for Mac and XML might be...
>>http://xmacl.com/
>>
>>Cheers,
>>
>>Markus
>>
>  Thanks for all the replys everyone, I will be waiting patiently
>for markus to check things out first, . I just re-installed system
>software today.because I wanted to start with a clean slate!
>
>Looking forward to being part of this,
>
>Thanks again,
>Matt
>
>
>
>
>
>
>
>
>_______________________________________________
>WyonaCMS-users mailing list
>[email protected]
>http://mail.wyona.org/cgi-bin/mailman/listinfo/wyonacms-users


-- 
**************************************

Unglaublich, aber wahr: Dilbert lebt!

**************************************