Zenoss Upgrade Instructions

Describes how to upgrade Zenoss from 2.1 to 2.2.

This document describes the steps necessary to upgrade a Zenoss installation
to a newer version.  There are three sections below with cover the steps
necessary for each different method of installing Zenoss.  Follow the
directions that correspon to how you installed your existing version of
Zenoss:
 * EL4 or EL5 RPM
 * Zenoss Virtual Appliance
 * Source tarball
 * Subversion checkout

NOTE: You should always backup your zenoss data prior to upgrading.  The
easiest way to do this is to use zenbackup and save the backup file somewhere
other than within $ZENHOME:
zenoss$ zenbackup  --save-mysql-access --file /tmp/zenoss-backup.tgz


** EL4 or EL5 RPMs

Download the new RPM from SourceForge and become root.  Then shutdown
your existing zenoss install:
root# service zenoss stop

Install the RPM. (Note - if you have the zenoss-core-zenpacks rpm already
installed you may need to use the --nodeps option with this rpm command.)
root# rpm -Uvh zenoss-<version>.rpm

Start Zenoss:
root# service zenoss start

OPTIONAL: Retrieve zenoss-core-zenpacks-<version>.rpm from SourceForge
and install it:
root# rpm -Uhv zenoss-core-zenpacks-<version>.rpm


** Zenoss Virtual Appliance Image

Login as the root user.

Make a backup of your data using zenbackup.
Then run one of the following commands.
 
If you would like to upgrade to the beta version of Zenoss,
run this command:

root# conary migrate --interactive  
group-zenoss=zenoss-project.zenoss.loc=zenoss-project.zenoss.loc@
zenoss:core-beta

If you would like to upgrade to the 2.2.x version of Zenoss, 
run this command:

root# conary migrate --interactive  
group-zenoss=zenoss-project.zenoss.loc=zenoss-project.zenoss.loc@
zenoss:core-2.2

If you would like to upgrade to the 2.1.x version of Zenoss, 
run this command:

root# conary migrate --interactive  
group-zenoss=zenoss-project.zenoss.loc=zenoss-project.zenoss.loc@
zenoss:core


** Source tarball

Download and extract new tar ball, run install.sh:
zenoss$ tar zxf zenoss-<version>.tar.gz
zenoss$ cd zenoss-<version>
zenoss$ ./install.sh


** Subversion source checkout

If you have a subversion checkout of the Zenoss installer code then update it:
root# cd <your inst directory>
root# svn update
otherwise retrieve a copy of the install code:
root# http://dev.zenoss.org/svn/trunk/inst zenossinst
root# cd zenossinst

Run the install script:
root# ./install.sh

After install is complete migrate your data as the zenoss user:
root# su - zenoss
zenoss$ zenmigrate