Upgrading AnzoGraph

Follow the appropriate instructions below to upgrade AnzoGraph on a single server or a cluster.

• Upgrading AnzoGraph on a Single Server
• Upgrading AnzoGraph on a Cluster

Upgrading AnzoGraph on a Single Server

1. If necessary, run the following command to become the Anzo service user:

   # su name

   Where name is the name of the service user. For example:

   # su anzo

2. If necessary, run the following command to make the AnzoGraph installation script executable:

   chmod +x script_name

3. Run the following command to start the installation wizard:

   ./script_name

   The script unpacks the JRE and then waits for input before starting the installation.

4. Press Enter to start the upgrade. The wizard detects the existing installation and asks if you want to update it.
5. Press Enter to update the existing installation.
6. The wizard prompts you to specify which components to upgrade. Specify 1 (AnzoGraph) and press Enter.
7. The wizard asks if you want to update the AnzoGraph configuration settings. Cambridge Semantics recommends that you choose to update the settings whenever possible so that your installation stays up-to-date with the latest default configuration setting values. Type y (yes) and press Enter to update the settings. Or press Enter to preserve the current settings.

   The installer saves a backup copy of the existing settings file before creating the new file. After the upgrade, you can revert AnzoGraph to a previous configuration any time by using a backup file. For more information, see Changing AnzoGraph Configuration Settings.

8. If you chose not to update settings, the wizard proceeds with the upgrade. When the upgrade completes, skip to the last step and start AnzoGraph. If you chose to update the settings, proceed to the next step.
9. At the server installation type prompt, accept the default option 1 (Standalone) and press Enter.
10. Indicate whether this installation is for use with Anzo. Press Enter for Yes. Answering yes configures AnzoGraph to use the settings that are optimal for Anzo. Answering no configures the settings that are optimal for AnzoGraph standalone use.
11. Set up the AnzoGraph admin user. Type a username to use for authentication. Anzo will use this username to connect to AnzoGraph. Then press Enter.
12. Type a password for the Anzo username and press Enter. Note: Some special characters, such as $ and *, are treated as parameters in bash. When typing a password, avoid or escape special characters to remove their special meaning to the command line. For more information, see Quoting in the Bash Reference Manual.
13. Configure any AnzoGraph settings. If Cambridge Semantics Support provided custom settings to use for your configuration, type the supplied values and then press Enter. Separate multiple settings with the new line escape sequence, \n. For example, the following entry sets two custom settings: truncate_clob=true\npersistence_directory=/data/.
14. The wizard extracts the AnzoGraph files and completes the upgrade.
15. Run the appropriate commands to start the system management daemon and database:
    • If services are set up as described in Installing AnzoGraph on a Cluster, run the following commands:

      sudo systemctl start azgmgrd

      sudo systemctl start anzograph

    • If services are not set up, run the following commands:

      /install_path/bin/azgmgrd

      /install_path/bin/azgctl -start

Upgrading AnzoGraph on a Cluster

Follow these steps to upgrade AnzoGraph on a cluster. The steps guide you through upgrading the leader server using the installation script and then cloning the updated AnzoGraph files to the compute nodes.

1. Log on to the leader server. If necessary, run the following command to become the Anzo service user:

   # su name

   Where name is the name of the service user. For example:

   # su anzo

2. If necessary, run the following command to make the AnzoGraph installation script executable:

   chmod +x script_name

3. Run the appropriate commands to stop the database and the system manager daemons for the existing installation:
   • If services are set up as described in Installing AnzoGraph on a Cluster, run the following commands on the leader server to stop the database and daemon on all servers in the cluster:

     sudo systemctl stop anzograph

     sudo systemctl stop azgmgrd

   • If services are not set up, run the following commands on the leader server to stop the database and daemon on all servers in the cluster:

     /install_path/bin/azgctl -stop

     /install_path/bin/azgctl -stopdaemon

4. Run the following command to start the installation wizard:

   ./script_name

   The script unpacks the JRE and then waits for input before starting the installation.

5. Press Enter to start the upgrade. The wizard detects the existing installation and asks if you want to update it.
6. Press Enter to update the existing installation.
7. The wizard prompts you to specify which components to upgrade. Specify 1 (AnzoGraph) and press Enter.
8. The wizard asks if you want to update the AnzoGraph configuration settings. Cambridge Semantics recommends that you choose to update the settings whenever possible so that your installation stays up-to-date with the latest default configuration setting values. Type y (yes) and press Enter to update the settings. Or press Enter to preserve the current settings.

   The installer saves a backup copy of the existing settings file before creating the new file. After the upgrade, you can revert AnzoGraph to a previous configuration any time by using a backup file. For more information, see Changing AnzoGraph Configuration Settings.

9. If you chose not to update settings, the wizard proceeds with the upgrade. When the upgrade completes, skip to the last step and start AnzoGraph. If you chose to update the settings, proceed to the next step.
10. At the server installation type prompt, accept the default option 2 (Cluster Leader) and press Enter.
11. Indicate whether this installation is for use with Anzo. Press Enter for Yes. Answering yes configures AnzoGraph to use the settings that are optimal for Anzo. Answering no configures the settings that are optimal for AnzoGraph standalone use.
12. Set up the AnzoGraph admin user. Type a username to use for authentication. Anzo will use this username to connect to AnzoGraph. Then press Enter.
13. Type a password for the Anzo username and press Enter. Note: Some special characters, such as $ and *, are treated as parameters in bash. When typing a password, avoid or escape special characters to remove their special meaning to the command line. For more information, see Quoting in the Bash Reference Manual.
14. Configure any AnzoGraph settings. If Cambridge Semantics Support provided custom settings to use for your configuration, type the supplied values and then press Enter. Separate multiple settings with the new line escape sequence, \n. For example, the following entry sets two custom settings: truncate_clob=true\npersistence_directory=/data/.
15. The wizard extracts the AnzoGraph files and completes the upgrade.
16. On the leader server and each of the compute servers, run the appropriate command to start the system management daemon:
    • If services are set up, run the following command:

      sudo systemctl start azgmgrd

    • If services are not set up, run the following command:

      /install_path/bin/azgmgrd

17. On the leader server, run the following command to clone the updated leader installation to the compute nodes:

    /install_path/bin/azgctl -clone 

    Depending on the number of nodes in the cluster, this step can take a few minutes.

18. When the clone process finishes and the prompt returns, run the appropriate command on the leader server to stop the system management daemon on all servers:
    • If services are set up, run the following command:

      sudo systemctl stop azgmgrd

    • If services are not set up, run the following command:

      /install_path/bin/azgctl -stopdaemon

19. On the leader server and each of the compute servers, restart the system management daemon:
    • If services are set up, run the following command:

      sudo systemctl start azgmgrd

    • If services are not set up, run the following command:

      /install_path/bin/azgmgrd

    Important

    Failing to restart azgmgrd on each server after the clone process can result in an incomplete upgrade.

20. On the leader server, run the appropriate command to start the database:
    • If services are set up, run the following command:

      sudo systemctl start anzograph

    • If services are not set up, run the following command:

      /install_path/bin/azgctl -start

Related Topics

• Installing AnzoGraph on a Single Server
• Installing AnzoGraph on a Cluster