Upgrading the Graph Studio Server

Follow the instructions below to back up your existing installation and then upgrade the Graph Studio Server software.

Back up the Existing Installation

Before you upgrade Graph Studio, Cambridge Semantics recommends that you make a backup copy of the current installation in case you have issues and need to revert to the original version. There are three commonly used methods for backing up Graph Studio:

  • Some users choose to make a copy of the Anzo system volume or journal, <install_path>/Server/data/journal/anzo.jnl. If you keep a copy of anzo.jnl, you can restore the original Anzo version by reinstalling that release and then copying the backed up journal file into the installation.
  • Some users choose to copy or create a tarball of the entire Anzo installation directory, <install_path>/Anzo. A backup of the directory can be large, however, and you might want to remove log files to reduce the overall size of the directory before copying or compressing it. If you keep a copy of <install_path>/Anzo, you can restore that version by uninstalling the new version and moving the backed up directory to the original installation location.
  • Some users choose to take a snapshot of the application disk.

Upgrade the Anzo Server

Follow the instructions below to upgrade Graph Studio.

Complete the steps below as the platform service user that was used to install Graph Studio. When Graph Studio is initially installed, a server ID is generated based on a number of system properties, including the user account that runs the installation script. The server license is tied to that server ID. If Graph Studio is re-installed (for instance, during an upgrade) by a different user account, a new server ID is generated and the existing license will no longer be valid for the installation.

  1. Stop Graph Studio if it is running. Then copy the new Graph Studio installation script to the server and run the following command to make the script executable:
    chmod +x <file_name>
  2. Before you run the script, make sure that you are logged in as the service user that installed Graph Studio. If necessary, you can run the following command to become the appropriate user:
    su <name>

    Where <name> is the name of the platform service user. For example:

    su anzo
  3. Run the following command to start the installation wizard and perform the upgrade:
    ./<file_name>

    The wizard unpacks the JRE and then waits for input before starting the upgrade.

  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. Review the software license agreement. Press Enter to scroll through the terms. At the end of the agreement, type 1 and press Enter to accept the terms or type 2 and press Enter to disagree and stop the update.

    The installer prompts you to specify the components to upgrade:

    Which components should be installed?
1: Server [*1]
2: Client [*2]
(To show the description of a component, please enter one of *1, *2)
Please enter a comma-separated list of the selected values or [Enter] for the default selection:
[1,2]
  7. In a comma-separated list, specify the components to upgrade. Item 1 is the Graph Studio server and item 2 is the Graph Studio Admin command line client.

    If you exclude a component that is currently installed, that component will not be upgraded. The existing component will not be removed from the server.

  8. Specify the maximum amount of memory (in MB) that the server can use and then press Enter. The wizard lists the amount of memory you have dedicated to the existing Graph Studio installation. You can type a different value if necessary, and then press Enter. The wizard starts the upgrade and then asks if you want to start the server automatically when the upgrade completes.
  9. Press Enter to start Graph Studio when the upgrade completes. If you do not want to start the server, type n and then press Enter. The setup wizard completes the upgrade process.

During the upgrade, experimental features that were enabled in the previous version are reset to disabled in the new version. For more information and instructions on re-enabling features, contact your Cambridge Semantics Customer Success representative.