Upgrading AnzoGraph

A key area of growth in AnzoGraph is the development and support of custom, user-managed extensions, such as the Graph Data Interface for virtualization and Elasticsearch support. Most AnzoGraph releases include revisions to the API and prepackaged extensions. Because of the frequency of AnzoGraph updates and because the extensions directory (<install_path>/lib/udx) is user-managed rather than AnzoGraph- or installer-controlled, you must uninstall the existing version of AnzoGraph and then install the new version. In-place upgrades are not supported.

Since AnzoGraph is stateless when used with Anzo and Anzo manages all of your data, removing the existing installation does not impact Anzo or your Graphmarts. Follow the instructions below to back up any custom files and remove the installation directory before deploying a new version.

Complete the steps below as the Anzo service user.
  1. First, run the following commands to stop the database and the system management daemon. On a cluster, run these commands on the leader node:
    sudo systemctl stop anzograph
    sudo systemctl stop azgmgrd
  2. Next, if you have custom files, such as certificates in <install_path>/config or JDBC drivers in the <install_path>/lib/udx directory, make a backup copy of those files. Make sure that you choose a backup location that is outside of the AnzoGraph installation path. After installing the new version of AnzoGraph, you can place the custom files back into the appropriate directories.

    If you have modified the settings file, <install_path>/config/settings.conf, Cambridge Semantics, Inc. recommends that you make a backup copy of the file on the leader server so that you can refer to it when configuring the new deployment. As a best practice, however, do not overwrite settings.conf in the new version of AnzoGraph with the backup copy from the previous version. Instead, Cambridge Semantics recommends that you apply all changes to the new file. Since new releases may add or remove settings or change the default value of certain settings, it is important to use the version of the file that was installed with the release.

  3. Remove the AnzoGraph installation directory from the file system. You can remove the software by deleting the installation directory or by running the <install_path>/uninstall script and following the prompts to remove the directory. On a cluster, uninstall AnzoGraph on all nodes.

Once AnzoGraph has been uninstalled, follow the instructions in Install AnzoGraph to install the new release.

Related Topics