#8.4. Upgrading the Virtual Appliance Image
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 #Zenoss Data."
Shut down the #Zenoss 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