Upgrade a License

By default, new AnzoGraph DB 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 DB user interface and the command line interface.

Upgrade a License from the User Interface

First, open the user interface by following the appropriate instructions below according to your method of deployment:

Deployment Instructions
Desktop Container Engine You can use the desktop application to open the AnzoGraph DB container in a browser, or open a browser and go to the following URL: http://127.0.0.1.

If you specified a port other than 80 for the host HTTP port when you deployed AnzoGraph DB, include that port in the URL. For example, http://127.0.0.1:8888.

Linux Container Engine If you are accessing a container image on a remote Linux host, note the IP address of the host, and then open a browser and go to the following URL: https://<host_IP_address>.

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

If you are using Docker locally on a Linux machine and need to know the IP address of the AnzoGraph DB 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": "172.17.0.2"
Kubernetes with Helm Using the AnzoGraph DB cluster or external IP obtained from the kubectl get service command, open a browser and go to the following URL: https://<IP_address>.
EL9 Installer Use the following URL to access the console: https://<host_IP_address>:<https_port>.
  1. On the login screen, type the username and password for the Admin user. If you deployed AnzoGraph DB with a container engine like Docker, Podman, or Rancher, use admin as the user name and Passw0rd1 as the password. Then click Sign In.
  2. On the top right of the screen, click the User drop-down menu and select Product License.

    The Product License screen is displayed. For example:

  3. On the Product License screen, scroll down and click the Request License link to go to the AnzoGraph License Offerings web page:

  4. 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.
  5. 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.
  6. 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 unique server ID for your AnzoGraph DB 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 DB if necessary. If services are set up (as described in Configuring the AnzoGraph DB Services and Starting the Database), AnzoGraph DB starts automatically when the VM restarts.
    4. Repeat the steps above to retrieve a license key using the new Server ID.
  7. 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.
  8. On the License Details page, copy the license key by clicking the Copy link next to the License Key field. For example:

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

    Because AnzoGraph DB shards data across slices, and the number if slices is determined by the number of available CPU allowed by the license, if your upgraded license allows for an increased number of CPU and/or nodes in the cluster, AnzoGraph DB must be re-initialized to clear the existing persisted data and take advantage of the increased resources.

  12. Reintialize AnzoGraph DB to configure the database with the updated license. Reinitializing the database requires running the following system manager (azgctl) command on the file system. How do I access the AnzoGraph DB file system with Docker? If you are using a cluster, run the command on the leader node:
    ./<install_path>/bin/azgctl -restart -init

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

Upgrade a License from the Command Line

  1. Run the following command to display your current deployment's license information:
    <install_path>/bin/azgctl -getlicenseid

    If AnzoGraph DB is stopped, you can run the following command to return the server ID:

    <install_path>/bin/azg_get_server_id

    The command returns a number of attributes associated with the current license, including a property_license.id value. The property_license.id value will be used as the Server ID when upgrading your license. For example:

    property_license.id: 2191-680E-178F-3D28-1535-D0F1
  2. Copy the property_license.id value, then open a web browser and go to the following URL, where you can view the licensing options: https://customercenter.cambridgesemantics.com/products/anzograph/license.html

  3. 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.
  4. 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.
  5. On the Create License screen, the product field is populated with the type of license you registered for. For example:

  6. In the Server ID field, paste the property_license.id value that you copied in step 2.
  7. 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 DB if necessary. If services are set up (as described in Configuring the AnzoGraph DB Services and Starting the Database), AnzoGraph DB starts automatically when the VM restarts.
    4. Repeat the steps above to retrieve a license key using the new Server ID.
  8. 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.
  9. On the License Details page, copy the license key by clicking the Copy link next to the License Key field. For example:

  10. After retrieving the new license key, apply the key to your deployment using one of the following options:
    • If AnzoGraph DB is stopped: Open in a text editor the license.pem file located in the <install_path>/config directory on the leader node. In the license.pem file, replace the existing contents with the new license key that you copied in the previous step. Then save and close the file.
    • If AnzoGraph DB is running, you can use the system manager to import the license key. On the leader node, run the following command to import the key and update the license.pem file:
      <install_path>/azg/bin/azgctl -license <license_key_text>

      For example:

      /opt/anzograph/bin/azgctl -license H4sIAAAAAAAAAG2RT0vDQBDF7/kUC54ELfsnu00LAaut...

      Because AnzoGraph DB shards data across slices, and the number if slices is determined by the number of available CPU allowed by the license, if your upgraded license allows for an increased number of CPU and/or nodes in the cluster, AnzoGraph DB must be re-initialized to clear the existing persisted data and take advantage of the increased resources.

  11. Reintialize AnzoGraph DB 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:
    ./<install_path>/bin/azgctl -restart -init

AnzoGraph DB is now configured to validate against the new license key. For information about loading data, see Load & Manage Data.