Upgrading from Zenoss 1.x to 2.x

How to upgrade your 1.x Zenoss instance to 2.x and migrate your data

#===========================================================
# Data Migration from 1.x to 2.0
#===========================================================

The following steps can be used to migrate your zenoss 1.x install to 2.0.
This migration requires a dump of the ZEO database to XML followed by a reload.
There is a change to the way objects are stored in the database that requires
this dump / load.  

PLEASE NOTE YOU MUST BACKUP YOUR ENTIRE ENTIRE $ZENHOME!!!!

THIS UPGRADE HAS NO ROLLBACK EXCEPT RESTORE OF THE ENTIRE $ZENHOME DIRECTORY.


# ============================
# shutdown, backup
# as the zenoss user
# ============================
[zenoss@zenoss ~]$ zenoss stop
[zenoss@zenoss ~]$ ( cd $ZENHOME ; tar -czvf /tmp/home.bak.tar.gz  . )


# ============================
# dump 1.x database
# ============================
[zenoss@zenoss ~]$ cd $ZENHOME

# the zen2dump.py program will make the file zendump.zip
# from which the database will be reloaded
[zenoss@zenoss ~]$ wget http://dev.zenoss.org/downloads/zen2dump.py
[zenoss@zenoss ~]$ zeoctl start
[zenoss@zenoss ~]$ bin/python zen2dump.py

# clear the old database to prep for reload
[zenoss@zenoss ~]$ zeoctl stop
[zenoss@zenoss ~]$ rm -f $ZENHOME/var/Data.fs* $ZENHOME/var/*.zec


# ============================
# upgrade the source code
# download the rpm or the source
# ============================
[zenoss@zenoss ~]$ exit
[root@zenoss ~]# wget http://...../zenoss-2.0-0.el5.i386.rpm
[root@zenoss ~]# rpm -Uvh zenoss-2.0-0.el5.i368.rpm
# or
[zenoss@zenoss zenossinst]$ ./install.sh


# ============================
# reload data
# ============================
[root@zenoss ~]# su - zenoss
[zenoss@zenoss ~]$ cd $ZENHOME
[zenoss@zenoss ~]$ zeoctl start
[zenoss@zenoss ~]$ bin/zen2load.py

# Put the desired admin password here
[zenoss@zenoss ~]$ bin/zpasswd.py -u admin -p zenoss inituser

# Make the log files all owned by zenoss
[root@zenoss ~]# chown -R zenoss:zenoss $ZENHOME/log


# ============================
# start up zenoss (if installed as rpm)
# ============================
[zenoss@zenoss ~]$ exit
[root@zenoss ~]# service zenoss start


# ============================
# start up zenoss (if installed via install.sh)
# ============================
[zenoss@zenoss ~]$ zenmigrate
[zenoss@zenoss ~]$ zenoss start


# cleanup heartbeats
After the migration there should be two left over heartbeats
1. zenxevent - replaced by zenhub
2. zenperfxmlrpc - no longer started by default