This section provides instructions for upgrading the Zenoss Virtual Appliance.
Important
If you have customized your appliance by installing other conary packages not included with Zenoss, you may want to preserve them by "pinning" them. Run the following command to list other installed conary packages:
root# conary updateall --items | grep -v group-zenoss
For each software package you want to keep, run this command:
root# conary pin packagename
where packagename is the name of the installed software package.
Do not pin any Zenoss packages (for example, group-zenoss). Doing this results in an unsuccessful upgrade.
To upgrade the Zenoss Virtual Appliance, navigate to the console of your virtual appliance, and then follow these steps:
Back up your Zenoss data files, as outlined in the previous section titled "Back Up Data."
Shut down the server:
root# service zenoss stop
Run the following command to make sure all of the Zenoss processes have stopped. Verify that no results return from the command.
root# ps ax|grep zenoss
Note
If you see processes owned by MySQL, do not stop them.
Clean up cache files with the following commands:
root# rm /home/zenoss/var/*.zec root# find /home/zenoss/perf -name \*.pickle -delete
Start the ZEO database so that a migrate can be run:
root# su - zenoss -c "/home/zenoss/bin/zeoctl start"
If upgrading from Version 2.3 to Version 2.4, run this command to upgrade your Zenoss instance:
conary migrate --interactive --resolve \ group-zenoss=/zenoss-project.zenoss.loc@zenoss:core-2.4
If upgrading from Version 2.4.x to Version 2.5, run this command to upgrade your Zenoss instance:
conary migrate --interactive --resolve \ group-zenoss=/zenoss-project.zenoss.loc@zenoss:core-2.5
Reboot your system.
Zenoss should start automatically after reboot, and will display URLs on the console for accessing the interface. You can verify that the service has started by entering the following command:
root# service zenoss status
If the service does not start automatically, then use the following command to start it:
root# service zenoss start