License and sales key renewal

Renew your Instana license or sales key.

License renewal

When your license expires or you get a new sales key, you must renew your Custom Edition license. To do so, complete the following steps:

  1. Download the new license either by using the kubectl plug-in or by using the curl command.
    • Use the kubectl plug-in to download the new license.
      kubectl instana license download --sales-key <SalesKey>
    • Use the curl command to download the license.
      curl https://instana.io/onprem/license/download/v2/allValid?salesId=<your-SalesKey> -o license.json
  2. Update the license in the config.yaml that is in the unit secret.

    1. Extract the config.yaml from Instana unit secret and save it as config-unit.yaml file.

      kubectl get secret <tenant_name>-<unit_name> -n <unit_namespace> -o jsonpath={'.data.config\.yaml'}|base64 -d > config-unit.yaml

    2. Update the license in the config-unit.yaml file with the new license.

    3. Update the unit secret with the new config-unit.yaml file.

      kubectl delete secret <tenant_name>-<unit_name> -n <unit_namespace>
kubectl create secret generic <tenant_name>-<unit_name> -n <unit_namespace> --from-file=config.yaml=/path/to/config-unit.yaml

The new license automatically becomes active as soon as the old one expires. If you see a message on the UI about license expiry, you can ignore the message.

Sales key renewal

When you get a new sales key, you must update the salesKey value in the config.yaml of Instana core secret.

To update the sales key, complete the following steps:

  1. Extract the config.yaml from the Instana core secret and save it as config.yaml file

    kubectl get secret instana-core -n <core_namespace> -o jsonpath={'.data.config\.yaml'}|base64 -d > config.yaml

  2. Update the salesKey value in config.yaml file with the new sales key.

  3. Update the Instana core secret with the updated config.yaml file.

    kubectl delete secret instana-core -n <core_namespace>
kubectl create secret generic instana-core -n <core_namespace> --from-file=config.yaml=/path/to/config.yaml