Upgrading an AnzoGraph License

By default, new AnzoGraph deployments have an embedded "Free Edition" license that does not expire but is limited to operation on a single server using a maximum of 8 GB RAM. You can increase the memory limit or remove all limitations by registering with Cambridge Semantics and generating a new license key. This topic provides instructions for upgrading a license using the AnzoGraph console user interface.

For instructions on upgrading a license using the command line, see Upgrading a License from the Command Line.

  1. If you have not installed AnzoGraph Free Edition (8 GB), follow the instructions in Deploying AnzoGraph with Docker to deploy AnzoGraph. For information about installing and configuring Docker, see Docker Installation and Configuration Requirements. If AnzoGraph is deployed, proceed to the next step.
  2. Follow the appropriate instructions below to open the AnzoGraph console user interface:
    • Docker Desktop for Mac or Windows: You can use the Docker Dashboard to open the AnzoGraph container in a browser, or open a browser and go to the following URL:

      If you specified a port other than 80 for the host HTTP port when you deployed AnzoGraph, include that port in the URL. For example,

    • Docker on Linux: If you are accessing Docker on a remote Linux host, note the IP address of the host, and then open a browser and go to the following URL:

      If you mapped the container's HTTPS (8443) port to port 443 on the host when you deployed AnzoGraph, you do not need to specify a port. If you specified a port other than 443, include the port in the URL. For example,

      If you are using Docker locally on a Linux machine and need to know the IP address of the AnzoGraph container, you can run the following command:

      sudo docker inspect container_name | grep '"IPAddress"' | head -n 1

      For example:

      sudo docker inspect anzograph | grep '"IPAddress"' | head -n 1
      "IPAddress": ""
    • Kubernetes with Helm deployments: Using the AnzoGraph Cluster IP or External IP obtained from the kubectl get service command, open a browser and go to the following URL:
  3. The browser displays the AnzoGraph console login screen. On the login screen, specify admin as the user name and Passw0rd1 as the password. Then click Sign In. The End User License Agreement (EULA) is displayed.
  4. Review the EULA and click Accept to proceed. The Query Console is displayed.
  5. Click the Admin tab at the top of the screen. The console displays general information about the deployment, including the license status. For example:

  6. Click the Upgrade License button. The AnzoGraph License Offerings web page is displayed:

  7. On the License Offerings page, review the options and click the Get...License button for the type of license that you want to upgrade to. The Register for a License page is displayed.
  8. If you have not previously registered and therefore do not have a License Center account, type a valid email address on the left side of the screen and click Submit. If you have an account, click the Login button on the right side of the screen and log in to the License Center. The Cambridge Semantics Software Licensing page is displayed.
  9. On the Create License screen, the product field is populated with the type of license you registered for. And the Server ID field is populated with the server ID for your AnzoGraph instance. For example:

    Provide the rest of the requested information on the form, and then click Proceed. The Software License Agreement dialog box is displayed.

    If you get an error message that says the Server ID is not unique, follow the steps below to work around the issue and generate a new Server ID. Duplicated Server IDs can be assigned on image based operating deployments if the image contains a machine-id.

    1. As the root user, run the following command to unset the machine-id:
      cat > /etc/machine-id < /dev/null
    2. Reboot the Virtual Machine (VM). A new, unique machine-id will be assigned.
    3. Start AnzoGraph if necessary. If services are set up (as described in Setting up AnzoGraph Services), AnzoGraph starts automatically when the VM restarts.
    4. Repeat the steps above to retrieve a license key using the new Server ID.
  10. On the Software License Agreement dialog box, click the I Agree checkbox. Then click OK.
    • If you submitted your email address and were not previously registered, the License Center creates your account and displays a Registration Complete message. Instructions on signing in to the licensing center and collecting your key are emailed to you. Follow the instructions in the email to log in to the License Center.
    • If you are logged in to the License Center, the new license details are displayed.
  11. On the License Details page, copy the license key by clicking the Copy link next to the License Key field. For example:

  12. Return to the Admin tab in the AnzoGraph console user interface. On the top right of the screen, click the user drop-down menu and select Product License.

    The Product License screen opens and displays details about the current product license. For example:

  13. In the License Key field, paste the license key that you copied from the licensing center, and then click Apply. AnzoGraph displays a "License was updated successfully" message and the screen is refreshed to display the details for the new license.
  14. Click Close to close the Product License dialog box and return to the General tab.

    The license change will NOT be reflected in the general details until AnzoGraph is restarted. The new memory limit can only be applied during the startup process.

  15. Reintialize AnzoGraph to configure the database with the updated license. Reinitializing the database requires running the following system manager (azgctl) command on the file system. If you are using a cluster, run the command on the leader node. How do I access the AnzoGraph file system with Docker?

    If necessary, run the following command to stop the database:

    install_path/bin/azgctl -stop

    Then run this command to reinitialize the database:

    install_path/bin/azgctl -start -init

AnzoGraph is now configured according to the specifications of the new license key.

Related Topics