Upgrading a License from the Command Line

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 or remove limitations by registering with Cambridge Semantics and generating a new license key. This topic provides instructions for upgrading a license using the command line.

For instructions on upgrading a license using the user interface, see Upgrading an AnzoGraph License.

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

    AnzoGraph returns a number of attributes associated with the current license, including a property_license.id value. For example:

    property_license.id: 2191-680E-178F-3D28-1535-D0F1

    The property_license.id value will be used as the Server ID when upgrading your license.

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

    install_path/bin/azg_get_server_id
  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:

  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 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.
  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 is stopped: Open in a text editor the license.pem file located in the install_path/azg/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 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:

      azg/bin/azgctl -license H4sIAAAAAAAAAG2RT0vDQBDF7/kUC54ELfsnu00LAautRRB7aC/qQaabSV2abMLuplo/v...
  11. Reintialize AnzoGraph to configure the database with the updated license. If necessary, stop the database by running the following command:
    install_path/bin/azgctl -stop

    Then run the following command to reinitialize the database:

    install_path/bin/azgctl -start -init

AnzoGraph is now configured to validate against the new license key.

Related Topics