License activation and renewal

Activate and renew your Instana license.

License configuration

When you install the Self-Hosted Standard Edition, your license is automatically downloaded and configured. The installation creates a license.json file with your license information at the $HOME/.stanctl folder.

To view your license information, use the following command:

stanctl license info

License renewal

You need to update the license information in the following scenarios:

  • You renewed the current Standard Edition license because it was expiring.
  • You have a new sales key for your Standard Edition deployment. For example, you might want to start to use a sales key instead of using part numbers from IBM Passport Advantage.
  • You purchased an add-on license for logs in context.

Current license renewal

If you renewed your current Standard Edition license, you must update the license expiration date in the $HOME/.stanctl/license.json file.

  • In an online environment, run the following command:

    stanctl license update --sales-key <sales-key>

  • In an air-gapped environment, run the following commands:

    1. Download your Standard Edition license on the bastion host:

      stanctl license download --sales-key=<new-sales-key> --output-dir=</path/to/create/license.json>

    2. Transfer the generated license.json file from the bastion host to the Instana host that is in your air-gapped environment. Ensure that you transfer the license.json file to the $HOME/.stanctl/ directory on the air-gapped Instana host.

    3. Update the license expiration date by running the following command on the air-gapped Instana host:

      stanctl license update -f /path/to/license.yaml --sales-key <sales-key>

New sales key

When you get a new sales key, you also get a new download key with it.

If you have a new sales key, run the following commands to update the license information.

  1. Update your deployment to use the new license keys:
    stanctl backend apply --sales-key=<new-sales-key> --download-key=<new-download-key>
  2. Update the license number and expiration date in the $HOME/.stanctl/license.json file:
    stanctl license update --sales-key <new-sales-key>