Return-Path: Mailing-List: contact cocoon-users-help@xml.apache.org; run by ezmlm Delivered-To: mailing list cocoon-users@xml.apache.org Delivered-To: moderator for cocoon-users@xml.apache.org Received: (qmail 89708 invoked from network); 7 May 2000 06:13:17 -0000 Received: from darius.concentric.net (207.155.198.79) by locus.apache.org with SMTP; 7 May 2000 06:13:17 -0000 Received: from mcfeely.concentric.net (mcfeely.concentric.net [207.155.198.83]) by darius.concentric.net (8.9.1a/(98/12/15 5.12)) id CAA07855; Sun, 7 May 2000 02:13:15 -0400 (EDT) [1-800-745-2747 The Concentric Network] Errors-To: Received: from INSPIRON_NT.concentric.net (ts036d44.sjc-ca.concentric.net [206.173.239.56]) by mcfeely.concentric.net (8.9.1a) id CAA13693; Sun, 7 May 2000 02:13:12 -0400 (EDT) Message-Id: <4.3.0.20000506224406.00b4e6e0@pop3.leaplink.com> X-Sender: willyumb@mail.concentric.net X-Mailer: QUALCOMM Windows Eudora Version 4.3 Date: Sat, 06 May 2000 23:13:27 -0700 To: cocoon-users@xml.apache.org From: William Bryant Subject: Cocoon 1.7.3 Upgrade micro-mini-HOWTO In-Reply-To: <391439DB.1493798C@verinet.com> Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="=====================_18297670==_.ALT" X-Spam-Rating: locus.apache.org 1.6.2 0/1000/N --=====================_18297670==_.ALT Content-Type: text/plain; charset="us-ascii"; format=flowed Cocoon 1.7.3 Upgrade micro-mini-HOWTO ----------------- This is designed for upgrading from 1.7.2 to 1.7.3 using the zip file distribution on a Linux machine running JServ. There may be additional issues if you are using an earlier version of Cocoon. Things will also be different for Windows, non-JServ, and RPM installs. (You can check out Murray Todd Williams' RPMs at http://grapeape.codingapes.com/xml.xml). I'll assume you having a working installation and have already downloaded Cocoon-1.7.3.tar.gz from somewhere like http://xml.apache.org/cocoon/dist/. ------------------ Having been crisped a few times, I'm fairly cautious about upgrades. My previous version of Cocoon was installed in /usr/local/cocoon-1.7.2/. Since I wanted to retain my previous install, just in case, I copied Cocoon-1.7.3.tar.gz into /usr/local/ and re-hydrated it in the usual way: gunzip Cocoon-1_7_3_tar.gz tar -xvf Cocoon-1_7_3_tar Once that's done, a couple of changes are in order. Make a back up of your current cocoon.properties file. I used the imaginative name cocoon.properties.1.7.2. Replace it with the one in /your/path/to/cocoon-1.7.3/conf/. One change a lot of people made to their cocoon.properties is to set an absolute path for the XSP processor. Look for the line processor.xsp.repository = ./repository and replace it with the equivalent one from your old cocoon.properties, if necessary. The other change is to the aptly named JServ configuration file: jserv.conf. In my setup, the jar classpaths looked like this: wrapper.classpath=/usr/local/cocoon-1.7.2/bin/cocoon.jar wrapper.classpath=/usr/local/cocoon-1.7.2/lib/fop_0_12_1.jar wrapper.classpath=/usr/local/cocoon-1.7.2/lib/xylan_1_0_0.jar wrapper.classpath=/usr/local/cocoon-1.7.2/lib/xerces_1_0_3.jar The new ones are -- not surprisingly: wrapper.classpath=/usr/local/cocoon-1.7.3/bin/cocoon.jar wrapper.classpath=/usr/local/cocoon-1.7.3/lib/fop_0_12_1.jar wrapper.classpath=/usr/local/cocoon-1.7.3/lib/xylan_1_0_1.jar wrapper.classpath=/usr/local/cocoon-1.7.3/lib/xerces_1_0_3.jar In addition to the paths, make sure you have the correct versions of the jar files. In my case, the xylan_1_0_0.jar line had to be changed to xylan_1_0_1.jar. Depending on your install there may be other changes as well. --------------- Testing: Start (or restart) JServ and check the status by pulling up Cocoon.xml in your browser. It should say Cocoon 1.7.3 in the upper right. Once you are certain the new version is working well, you can remove the old 1.7.2 files. (Being the belt-and-suspenders type, I'll rename the directory and run Cocoon for a little while before I actually delete it.) --------------- Troubleshooting: If you get a message like: Publishing Engine could not be initialized. java.lang.RuntimeException: Error creating org.apache.cocoon.formatter.VRMLFormatter: class is not found You need to make sure you replaced the old cocoon.properties file with the new one. ---------------- Hopefully this document has a brief, but useful life before it is made obsolete by Cocoon 2.0. Feedback is appreciated. Send it to pink5432@freelinuxmail.com ---------------- Tested configuration is RedHat Linux 6.1, Apache 1.3, Apache JServ 1.1, IBM JDK 1.1.8 --=====================_18297670==_.ALT Content-Type: text/html; charset="us-ascii" Cocoon 1.7.3 Upgrade micro-mini-HOWTO

-----------------
This is designed for upgrading from 1.7.2 to 1.7.3 using the zip file distribution on a Linux machine running JServ.  There may be additional issues if you are using an earlier version of Cocoon.  Things will also be different for Windows, non-JServ, and RPM installs.  (You can check out Murray Todd Williams� RPMs at http://grapeape.codingapes.com/xml.xml).

I'll assume you having a working installation and have already downloaded Cocoon-1.7.3.tar.gz from somewhere like http://xml.apache.org/cocoon/dist/.

------------------
Having been crisped a few times, I'm fairly cautious about upgrades.  My previous version of Cocoon was installed in /usr/local/cocoon-1.7.2/.  Since I wanted to retain my previous install, just in case, I copied Cocoon-1.7.3.tar.gz into /usr/local/ and re-hydrated it in the usual way:

    gunzip Cocoon-1_7_3_tar.gz
    tar -xvf Cocoon-1_7_3_tar

Once that�s done, a couple of changes are in order.

Make a back up of your current cocoon.properties file.  I used the imaginative name cocoon.properties.1.7.2.  Replace it with the one in /your/path/to/cocoon-1.7.3/conf/. 

One change a lot of people made to their cocoon.properties is to set an absolute path for the XSP processor.  Look for the line

    processor.xsp.repository = ./repository

and replace it with the equivalent one from your old cocoon.properties, if necessary.

The other change is to the aptly named JServ configuration file: jserv.conf.  In my setup, the jar classpaths looked like this:

    wrapper.classpath=/usr/local/cocoon-1.7.2/bin/cocoon.jar
    wrapper.classpath=/usr/local/cocoon-1.7.2/lib/fop_0_12_1.jar
    wrapper.classpath=/usr/local/cocoon-1.7.2/lib/xylan_1_0_0.jar
    wrapper.classpath=/usr/local/cocoon-1.7.2/lib/xerces_1_0_3.jar

The new ones are -- not surprisingly:

    wrapper.classpath=/usr/local/cocoon-1.7.3/bin/cocoon.jar
    wrapper.classpath=/usr/local/cocoon-1.7.3/lib/fop_0_12_1.jar
    wrapper.classpath=/usr/local/cocoon-1.7.3/lib/xylan_1_0_1.jar
    wrapper.classpath=/usr/local/cocoon-1.7.3/lib/xerces_1_0_3.jar

In addition to the paths, make sure you have the correct versions of the jar files.  In my case, the xylan_1_0_0.jar line had to be changed to xylan_1_0_1.jar.  Depending on your install there may be other changes as well.

---------------
Testing:

Start (or restart) JServ and check the status by pulling up Cocoon.xml in your browser.  It should say Cocoon 1.7.3 in the upper right.

Once you are certain the new version is working well, you can remove the old 1.7.2 files.  (Being the belt-and-suspenders type, I'll rename the directory and run Cocoon for a little while before I actually delete it.)

---------------
Troubleshooting:

If you get a message like:

    Publishing Engine could not be initialized.

    java.lang.RuntimeException: Error creating 
    org.apache.cocoon.formatter.VRMLFormatter: class is not found

You need to make sure you replaced the old cocoon.properties file with the new one.

----------------

Hopefully this document has a brief, but useful life before it is made obsolete by Cocoon 2.0.  Feedback is appreciated.  Send it to pink5432@freelinuxmail.com

----------------

Tested configuration is RedHat Linux 6.1, Apache 1.3, Apache JServ 1.1, IBM JDK 1.1.8
--=====================_18297670==_.ALT--