Upgrading AnzoGraph

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

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 following commands to start the system management daemon and database:
    ./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 slave 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 following commands to stop the database and the system manager daemons for the existing installation:
    ./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 slave servers, run the following command to start the system management daemon:
    ./install_path/bin/azgmgrd
  17. On the leader server, run the following command to clone the updated leader installation to the slave 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 following command on the leader server to stop the system management daemon on all servers:
    ./install_path/bin/azgctl -stopdaemon
  19. On the leader server and each of the slave servers, run the following command to restart the system management daemon:
    ./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 following command to start the database:

    ./install_path/bin/azgctl -start
Related Topics