Update 5.6.0 to 5.7.0

This page describes how to update Service Impact 5.6.0 to 5.7.0. For earlier releases, use a different procedure.

The following list outlines recommended best practices:

Verify that Resource Manager is running normally. The update procedures stop, start, or restart specific services, but the required starting point is Resource Manager running normally.
Export service models. Exporting before an update provides a quick restore option if the update fails. If necessary, you can uninstall, remove the ZenPack, install the working version, and then import the service models.
Review the release notes for this release before proceeding. The latest information is provided there.
Use screen, tmux, or a similar program to establish sessions on the Control Center master host. If you become disconnected, the commands you initiate will continue to run.
Review the procedures in this section before performing them. Every effort is made to avoid mistakes and anticipate needs; nevertheless, the instructions may be incorrect or inadequate for some requirements or environments.

Download required files

To perform this procedure, you need:

A workstation with internet access.
Permission to download files from delivery.zenoss.io. To request permission, file a ticket at the Zenoss Support site.
A secure network copy program.

Follow these steps:

In a web browser, navigate to delivery.zenoss.io, and then log in.
Download the Docker image file for Service Impact.
- install-zenoss-impact_VERSION.run
Replace Version with the most recent version number available on the download page.
Download the Service Impact ZenPack files.
- ZenPacks.zenoss.ImpactServer-VERSION-py2.7.egg
- ZenPacks.zenoss.Impact-VERSION-py2.7.egg
Replace Version with the most recent version number available on the download page.
Use a secure copy program to copy the Docker image file and the ZenPack files to the Control Center master host.

Stage required files on the master host

To perform this procedure, you need permission to log in to the Control Center master host as root, or as a user with superuser privileges. Use this procedure to install the Docker image and to prepare the ZenPack files for installation.

Log in to the Control Center master host as root or as a user with superuser privileges.
Stage the Docker image file and ZenPack files in /tmp.
1. Create a directory in /tmp for the files. The directory must be local (not mounted) and must be readable, writable, and executable by all users. For example, /tmp/impact.
```
mkdir /tmp/impact
```
2. Copy or move the Docker image file and ZenPack files to /tmp/impact.
  
  Do not change the file names during the move or copy.
3. Change the file permissions. The files must have the same permissions as their parent directory.
```
chmod -R 777 /tmp/impact
```
Install the Service Impact image.
1. Change to the directory in which the Service Impact image is located.
```
cd /tmp/impact
```
2. Install the image.
```
yes | ./install-zenoss-impact_*.run
```

Update both Service Impact ZenPacks

Perform this procedure to update both Zenpacks, ZenPacks.zenoss.Impact and ZenPacks.zenoss.ImpactServer.

Log in to the Control Center browser interface.
In the Application column of the Applications table, click Resource Manager.
Scroll down to the Services table, and then locate the Impact service in the Infrastructure section.
Click Impact, and then locate the State Change Queue Length graph.
Log in to the Control Center master host as a user with serviced CLI privileges.
Create a snapshot of the Resource Manager application.
```
serviced service snapshot Zenoss.resmgr
```
Stop the zenimpactstate service, and then verify that it stopped.
1. Stop the zenimpactstate service.
```
serviced service stop zenimpactstate
```
2. Verify that the service is stopped.
```
watch serviced service status zenimpactstate
```
In the Control Center browser interface, monitor the length of the state change queue. When the queue length is 0 (zero), proceed to the next step.
Stop the Infrastructure/Impact service, and then verify that it stopped.
1. Stop the Infrastructure/Impact service.
```
serviced service stop Infrastructure/Impact
```
2. Verify that the service is stopped.
```
watch serviced service status Infrastructure/Impact
```

Export the Impact graph database. This will be imported by the upgrade.sh script.

serviced service shell Infrastructure/Impact su - zenossimpact -c "/opt/zenoss_impact/bin/neo4j-admin dump --verbose --expand-commands --database=neo4j --to=/opt/zenoss_impact/var/"

Extract the upgrade script from the ZenPacks.zenoss.ImpactServer ZenPack, make the script executable, and start the upgrade script.
1. Change to the directory in which the Service Impact ZenPack egg file is located.For example, the /tmp/impact directory:
```
cd /tmp/impact
```
2. Extract the upgrade script from the ZenPacks.zenoss.ImpactServer egg file. Replace VERSION with the ZenPack version number:
```
unzip -p ZenPacks.zenoss.ImpactServer-VERSION-py2.7.egg ZenPacks/zenoss/ImpactServer/upgrade/upgrade.sh > upgrade.sh
```
3. Make the script executable.
```
chmod +x upgrade.sh
```
4. Start the upgrade script.
```
./upgrade.sh
```
  Note
  
  The upgrade script might display CRITICAL warning messages, which can be ignored.
Start the Infrastructure/Impact service, and then verify that it started.
1. Start the Infrastructure/Impact service.
```
serviced service start Infrastructure/Impact
```
2. Verify that the service is started.
```
watch serviced service status Infrastructure/Impact
```

Install the ZenPacks.zenoss.Impact ZenPack. Replace VERSION with the ZenPack version number:

serviced service run zope zenpack-manager install ZenPacks.zenoss.Impact-VERSION-py2.7.egg

Restart Zenoss services.
```
serviced service restart Zenoss.resmgr/Zenoss
```
Alternatively, restart the Zenoss services by using the Control Center browser interface.

Reindex the graph database

Perform these steps:

Log in to the Control Center master host as root or as a user with superuser privileges.
Create a snapshot.
```
serviced service snapshot Zenoss.resmgr
```
On completion, the serviced command returns the ID of the new snapshot. If the installation of a ZenPack fails, you can restore the snapshot created in this step. For more information about restoring a snapshot, see Creating snapshots and rolling back.
Stop the Zenoss services, and then verify that the services are stopped.
1. Stop Resource Manager.
```
serviced service stop Zenoss.resmgr/Zenoss
```
2. Wait until all services are stopped. Use the watch command to monitor the status.
```
watch serviced service status Zenoss.resmgr/Zenoss
```
Start the Zenoss service that is needed to perform the graph rebuild.
1. Start the zeneventserver service.
```
serviced service start zeneventserver
```
2. Wait until the service is started. Use the watch command to monitor the status.
```
watch serviced service status zeneventserver
```
Start a Zope container.
```
serviced service shell zope
```
In the container, log in as user zenoss.
```
su - zenoss
```
Update the catalog.
```
zenimpactgraph run -x catclean
```
Rebuild indexes and constraints for the Neo4j graph.
```
zenimpactgraph run -x reindex
```
Exit the zenoss user account.
```
exit
```
Exit the Zope container.
```
exit
```

Restart all Zenoss services:

serviced service restart Zenoss.resmgr/Zenoss

Refresh the cache in your browser. The procedure varies by browser.