Upgrading Zenoss from 2.0x to 2.1x

This Guide is a walkthrough on what one does to upgrade from 2.0x to 2.1x

Upgrading from Zenoss 2.x to 2.1.x
==================================
(Note: b steps are optional)



1.  All steps should be performed as the zenoss user unless otherwise noted.


2.  Make sure you create a backup of all you data, just in case things go wrong.
    This can be done by simply calling zenbackup, which will create a backup of 
    all your Zenoss data (events, RRD files, and Zope DB). Once created the
    backup will located in $ZENHOME/backups. If you want to be supersafe about
    the upgrade you copy the backup file into a different directory outside of
    $ZENHOME.

    >>> zenbackup


2b. As an optional step you can invoke zendmd and check the version of the current
    DB by calling dmd.version.

    >>> echo "dmd.version" >> /tmp/dmd.cmd.tmp
    >>> zendmd < /tmp/dmd.cmd.tmp


3.  Stop Zenoss and confirm that everything has indeed stopped by invoking 
    zenoss status. If daemons continue running kill them manually.

    >>> zenoss stop
    >>> zenoss status


4.  As the root user install your Zenoss Core RPM now. 

    >>> sudo rpm -Uvh zenoss-core.rpm


5.  After the Core install has completed run /etc/init.d/zenoss start. This should
    run zenmigrate the step that is responsible for the migration of the Zeo DB.
    There migh be errors during this process, don't be too worried quite yet these
    are most likely related to out-of-date indexes.

    >>> sudo /etc/init.d/zenoss start


5b. If step 5 has completed you can now check the version of your Zeo DB
    (like in 2b). The version should now be the same as the Core version you are
    trying to move to.


6.  If for some reason zenmigrate didn't run or failed to run successfully, you
    can try to invoke zenmigrate manually. If after a manual invoke the migration
    still doesn't work you should contact Zenoss (via the forum or support).

    >>> zenmigrate

7.  If you have the Core Zenpacks RPM you can install that next. Please make sure
    to start Zenoss before the install of the Zenpacks. 

    >>> rpm -Uvh zenoss-core-zenpacks.rpm


7b. If you should have the Zenoss Enterprise Components you can install these last.

    >>> rpm -Uvh zenoss-ent-zenpacks.rpm


Note:
You might run into some weird behaviour with the Web UI after the upgrade. Please
make sure that your browser cache is emptied to ensure you don't somehow cache
old CSS or JavaScript.
Also, if you made customizations you will have to turn the off and recreate them
in the new install.