Hope this helps (rather than daunting or confusing) future cocoon
newblies like me:

SOLUTION:

I finally got cocoon 2.1.7 to build completely, though with a bunch of
warnings about "Multiple sources of package comments", unfound tags,
tags references not found, unusable "@return" tags and "@params
arguments" that aren't parameter names, but only while "Constructing
Javadoc information".  Almost everything else seems to work.

In the end the route i took was basically the one more often proposed
in this thread and lightly documented at
http://wiki.apache.org/cocoon/Installing

This is the path i followed, under SuSE Linux 9.3.  Retrying the
cocoon build was done after java and tomcat were upgraded because (as
i saw it) i need tomcat working for the apache derby db (to serve
Fortunes ;)), but this thread and the above url suggest cocoon should
have been buildable right after the su93 ant rpms were uninstalled.

01. Uninstall su93 ant rpms:
+ added rest of ant packages not yet installed, but cocoon still
didn't build (and tomcat5 admin still wouldn't display, whether
related or not)
+ uninstalled all ant rpms from su93 except manual 

02. Upgrade to su93 Java J2SE [1.]5.0 rpms (to get best suggested fit
with apache's tomcat 5.5.9 tarball):
+ worked out general /etc/alternatives and java name/path principles
and locations described in "man update-alternatives" and at
http:/jpackage.org. (Alternatively, on su93, see:
   /etc/java/README, and its deprecation detour to 
   /usr/share/doc/packages/jpackage-utils/jpackage-1.5-policy.xhtml 
via the deprecated setDefaultJava and setJava commands/scripts)
+ saved a copy of output from "tree -Dplaifs $JAVA_HOME" and other
java-related HOMEs (JRE, JDK, SDK, etc) for post-upgrade reference
+ manually downloaded (wget) and installed su93 rpms from
ftp://ftp.suse.com/pub/suse/i386/9.3/suse/i586/ for Sun 'java version
"1.5.0_03", Java(TM) 2 Runtime Environment, Standard Edition (build
1.5.0_03-b07)
Java HotSpot(TM) Client VM (build 1.5.0_03-b07, mixed mode, sharing)'
and installed via yast2 -i *.rpm in download directory -- since YOU
(yast2 online_update) wouldn't accept "upgrading" from Sun version
1.4.2 rpms;
+ will soon try uninstall "java/JRE [1.]4.2" rpms

03. Upgrade to jakarta tomcat 5.59 (via uninstall su93 tomcat 5.5.0
rpms and install apache tarballs):
+ backed up conf/ and "tree -Dplaifs $CATALINA_HOME" output for
post-install reference and attempt to get back to jpackage "policy"
file locations.  (Notably,  CATALINA_HOME=/usr/share/tomcat5 is set in
a somewhat hard-to-find script called /etc/sysconfig/j2ee) and
uninstalled all tomcat 5.5.0 rpms;
+ untarred tomcat 5.5.9 base and "admin" tarballs from apache under an
arbitrary /root/ subdir into $CATALINA_HOME, tested  and went straight
to trying to build cocoon

04. Retry cocoon build.sh:
+ backed up old "build.log" files (produced via "build.sh >build.log
2>&1 &"); removed old cocoon "home" (in my case,
/home/am/bin/cocoon/cocoon-2.1.7/); untarred apache cocoon 2.1.7
tarball into same subdir; retried cocoon's build.sh, to get:
  BUILD SUCCESSFUL
  Total time: 34 minutes 21 seconds 
  [this is an "older" IBM ThinkPad 600x notebook; hardware stats below]

05. Tried cocoon's "build.sh war" in cocoon "home" (04. above) -- now
basically following the instructions under "Installing on Tomcat
4.0.4b1 LE with JDK 1.4.0"
at http://cocoon.apache.org/2.1/installing/, adapted to my cocoon "home"):
   BUILD SUCCESSFUL
   Total time: 28 minutes 3 seconds
    [again, hardware stats below]
+ tried "build webapp Jetty" via "./cocoon.sh servlet" in cocoon
"home" and Cocoon welcome page was available at http://localhost:8888/
+ got (cd ~/bin/cocoon/cocoon-2.1.7/build/webapp ; ls -l cocoon.war):
   -rw-r--r--   1 am   users 57401507 2005-08-29 15:21 cocoon.war 
 
06. This part might be called "Installing on Tomcat 5.5.9 with JDK
1.5.0 (aka J2SE 5.0) and is adapted from the Cocoon Installing URL
above:

   0. Built the Cocoon webapp (cocoon.war) as described above.
   1. *MOVE* $COCOON_HOME/cocoon-2.1.7/build/cocoon/cocoon.war into 
       $CATALINA_HOME/webapps/ directory -- cocoon.war is too big to leaving 
       unused copies lying about and can always be rebuilt if needed.
   2. If working under a console without loading X.org (formerly X11), set 
       the following environment variable and export it: 
          # CATALINA_OPTS=-Djava.awt.headless=true
          # export CATALINA_OPTS
   3. Start Tomcat via 
          # $CATALINA_HOME/bin/startup.sh 
       (NOT using the usual SuSE/RedHat-ish rctomcat5 or /etc/init.d/tomcat5, 
       since they were removed when the tomcat 5.5.0 rpms were uninstalled, 
       above).  See 03, above, re CATALINA_HOME value. 
       + The tomcat server's initialization process can then be watched via 
          either: 
          # tail -f $CATALINA_HOME/logs/catalina.out
          or
          # tail -f $CATALINA_HOME/logs/catalina-YYYY-MM-DD.log
        (replacing YYYY-MM-DD with the current date)
   5. Open the Cocoon welcome page, http://localhost:8080/cocoon/, in a 
       browser (Mozilla Firefox 1.0.6 worked well.  This assumes tomcat is
       configured to use port 8080.  It can be configured to use other ports.
   6. Optional: use jpackage policy guides and update-alternatives [as 
       described in 02, above] and SuSEconfig to reintegrate tomcat into
       SuSE's /etc/sysconfig sub-system -- though i cheated and unpacked
       the old tomcat5 rpms from the install CDs into a temporary directory
       to follow copy some of their symlinks and scripts
   7. Optional: since the cocoon.war (above) left in $CATALINA_HOME/webapps 
       and (see above) and the build/ subdirectory left over from step 04 above
       together take up several hundred MB and are not (or don't seem) 
       necessary to run cocoon under tomcat, i deleted the cocoon.war manually
       and ran "build.sh clean" in the cocoon "home" (03 above).  Cocoon seems
       to still work fine under tomcat.  I have NOT tested cocoon's
"command-line"
       tools yet to see if they still work.  But, again, "build.sh"
can always be
       re-run...
       

Hardware Stats:
===============================================
[EMAIL PROTECTED] cat /proc/cpuinfo
processor       : 0
vendor_id       : GenuineIntel
cpu family      : 6
model           : 8
model name      : Pentium III (Coppermine)
stepping        : 1
cpu MHz         : 448.515
cache size      : 256 KB
<cut>
[EMAIL PROTECTED] cat /proc/meminfo
MemTotal:       256184 kB
<cut>
SwapTotal:      514040 kB
[EMAIL PROTECTED] hdparm -I /dev/hda1
/dev/hda1:
ATA device, with non-removable media
        Model Number:       TOSHIBA MK3021GAS
<cut>
[EMAIL PROTECTED] hdparm -t /dev/hda1
/dev/hda1:
 Timing buffered disk reads:   58 MB in  3.02 seconds =  19.20 MB/sec
<end>


On 8/28/05, AD Marshall <[EMAIL PROTECTED]> wrote:
> Please pardon me, folks, i can't access the Net everyday.  But i want to thank
> you all for your gracious help.  I'm in the process of upgrading to JDK 5.0,
> Tomcat 5.5.9 and then Cocoon 2.1.7...
> 
> cheers,
> andi
> 
> On 8/23/05, Joerg Heinicke <[EMAIL PROTECTED]> wrote:
> > On 22.08.2005 22:42, Martin Brüggebors wrote:
> >
> > > First: Use the ant that was shipped with cocoon (in cocoon-2.1.7/tools) by
> > > setting ANT_HOME=./cocoon--2.1.7/tools.
> > > I did not try that, but it should work.
> >
> > Cocoon actually sets ANT_HOME to its ant, but there is an option in the
> > ant scripts loading the global ant on newer linux systems. This can be
> > fixed by doing like suggested at
> > http://wiki.apache.org/cocoon/Installing. In theory Cocoon could also
> > fix its ant scripts by doing the fix as suggested in Cocoon's codebase.
> >
> > Joerg
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: [EMAIL PROTECTED]
> > For additional commands, e-mail: [EMAIL PROTECTED]
> >
> >
> 
> 
> --
> AD (Andi) Marshall
> Cell: +84 (0)903871313
> eM: [EMAIL PROTECTED]
> Zone: ICT (IndoChina Time, GMT/UTC+7)
> Post: HoChiMinh City (ex/or SaiGon), VietNam
> 


-- 
AD (Andi) Marshall
Cell: +84 (0)903871313
eM: [EMAIL PROTECTED]
Zone: ICT (IndoChina Time, GMT/UTC+7)
Post: HoChiMinh City (ex/or SaiGon), VietNam

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to