Upgrading both Service Impact ZenPacks

Before performing this procedure, complete the steps in Preparing to install or upgrade.
Perform this procedure to upgrade both ZenPacks.zenoss.Impact and ZenPacks.zenoss.ImpactServer.
  1. Log in to the Control Center browser interface.
  2. In the Application column of the Applications table, click Resource Manager.
  3. Scroll down to the Services table, and then locate the Impact service.
    The service is in the Infrastructure section.
  4. Click Impact, and then locate the State Change Queue Length graph.
  5. Log in to the Control Center master host as a user with serviced CLI privileges.
  6. Stop the zenimpactstate service, and then verify it stopped.
    1. Stop the zenimpactstate service.
      serviced service stop zenimpactstate
    2. Verify the service is stopped.
      serviced service status zenimpactstate
  7. In the Control Center web interface, monitor the length of the state change queue.
    When the queue length is 0 (zero), proceed to the next step.
  8. Stop the Impact service, and then verify it stopped.
    1. Stop the Impact service.
      serviced service stop Impact
    2. Verify the service is stopped.
      serviced service status Impact
  9. Extract an upgrade script from the ZenPacks.zenoss.ImpactServer ZenPack, and then upgrade the Impact service.
    1. Change directory to the directory in which the Service Impact ZenPack egg files are located.
      For example, the /tmp/impact-zenpacks directory:
      cd /tmp/impact-zenpacks
    2. Extract the upgrade script from the ZenPacks.zenoss.ImpactServer egg file.
      Resource Manager 5.0.x: Replace Version with the ZenPack version number:
      unzip -p ZenPacks.zenoss.ImpactServer-Version-rm5.0.x-py2.7.egg \
        ZenPacks/zenoss/ImpactServer/upgrade/upgrade.txt > upgrade.txt
      Resource Manager 5.1.x: Replace Version with the ZenPack version number:
      unzip -p ZenPacks.zenoss.ImpactServer-Version-py2.7.egg \
        ZenPacks/zenoss/ImpactServer/upgrade/upgrade.txt > upgrade.txt
    3. Start the upgrade script.
      serviced script run upgrade.txt --service Impact
  10. Start the Impact service, and then verify it started.
    1. Start the Impact service.
      serviced service start Impact
      If you are upgrading a deployment that has internet access, the upgrade includes downloading a new image from Docker Hub, which takes about 3-5 minutes. If you are upgrading a deployment that does not have internet access, the required image is already installed.
    2. Verify the service is started.
      serviced service status Impact
  11. Install the ZenPacks.zenoss.Impact ZenPack
    1. Install the ZenPack.
      Resource Manager 5.0.x: Replace Version with the ZenPack version number:
      serviced service run zope zenpack install \
        ZenPacks.zenoss.Impact-Version-py2.7.egg
      Resource Manager 5.1.x: Replace Version with the ZenPack version number:
      serviced service run zope zenpack-manager install \
        ZenPacks.zenoss.Impact-Version-py2.7.egg
  12. Log in to the Control Center browser interface.
  13. In the Control Center browser interface, restart the Zenoss services. If you wish to use the command line instead, issue the following command to restart the Zenoss services.
    serviced service restart Zenoss.resmgr/Zenoss