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.

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 --sales-key <sales-key> --air-gapped

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>