Specifications

Chapter 5. Upgrading

This chapter provides instructions for upgrading Zenoss Core installations to version 4.2.5. You may upgrade Zenoss

Core 3.2.1, 4.2.0, 4.2.3, or 4.2.4 to version 4.2.5. Version 4.2.5 requires a 64-bit platform.

Sections are presented in order, and some are optional.

Note

Version 3.2.1 upgrades only: Zenoss Core 4.2.x includes a fully redesigned event processing and storage

system. Currently, upgrades do not migrate events from version 3.2.1. Instead, after the upgrade, a new, empty

events database is created using the new schema.

To migrate version 3.2.1 events to version 4.2.5 as part of your upgrade, contact Zenoss Professional Services.

5.1. Preparing to upgrade

The procedure in this section prepares your installation for upgrade to version 4.2.5.

Note

Perform this procedure in a development or testing environment before performing it in a production environ-

ment. In particular, only Zenoss-maintained ZenPacks are tested and supported in an upgrade. Test all other

ZenPacks for compatibility with this version of Zenoss Core before upgrading a production environment.

1. Log in to the Zenoss Core host as user zenoss.

2. Stop Zenoss Core.

zenoss stop

3. Create a backup with the zenbackup command. For more information about zenbackup, refer to the Zenoss Core

Administration guide.

Note

If you are upgrading version 3.2.1, do not include the events database in the backup. For example:

zenbackup --no-events

4. Create a backup of the Zenoss Core software. For example:

cd $ZENHOME

tar --exclude backups --exclude perf --exclude log -czf $HOME/myZenoss.tgz ./*

5. If you are upgrading version 4.2.3 or 4.2.4, you must install the ZenUp patch management tool before upgrading.

For more information, refer to the Zenoss Core ZenUp Installation and Administration guide. When you are finished

installing ZenUp, resume this procedure at the next step.

6. Switch user to root, or to a user with superuser privileges, and install the Zenoss dependencies repository.

RHEL/CentOS 5: rpm -Uvh http://deps.zenoss.com/yum/zenossdeps-4.2.x-1.el5.noarch.rpm

RHEL/CentOS 6: rpm -Uvh http://deps.zenoss.com/yum/zenossdeps-4.2.x-1.el6.noarch.rpm

7. Clean up yum caches.

yum clean all