Archived community.zenoss.org | full text search
Skip navigation
Currently Being Moderated

8.4 4 Upgrading the Virtual Appliance Image

VERSION 1 
Created on: Nov 17, 2009 11:43 AM by Zenoss API - Last Modified:  Nov 17, 2009 11:43 AM by Zenoss API

#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:

  1. Back up your #Zenoss data files, as outlined in the previous section titled "Back Up #Zenoss Data."

  2. Shut down the #Zenoss server:

    root# service zenoss stop
  3. 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.

  4. Clean up cache files with the following commands:

    root# rm /home/zenoss/var/*.zec
    root# find /home/zenoss/perf -name \*.pickle -delete
  5. Start the ZEO database so that a migrate can be run:

    root# su - zenoss -c "/home/zenoss/bin/zeoctl start"
  6. 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
  7. 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
  8. Reboot your system.

  9. #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
Comments (0)