Documentation

Install your InfluxDB Clustered license

Install your InfluxDB Clustered license in your cluster to authorize the use of the InfluxDB Clustered software.

Install your InfluxDB license

  1. If you haven’t already, request an InfluxDB Clustered license.

  2. InfluxData provides you with a license.yml file that encapsulates your license token as a custom Kubernetes resource.

  3. Use kubectl to apply and create the License resource in your InfluxDB namespace:

    kubectl apply --filename license.yml --namespace influxdb
    

InfluxDB Clustered detects the License resource and extracts the credentials into a secret required by InfluxDB Clustered Kubernetes pods. Pods validate the license secret both at startup and periodically (roughly once per hour) while running.

Upgrade from a non-licensed release

If you are currently using a non-licensed preview release of InfluxDB Clustered and want to upgrade to a licensed release, do the following:

  1. Install an InfluxDB license

  2. If you use the AppInstance resource configuration to configure your cluster, in your myinfluxdb.yml, update the package version defined in spec.package.image to use a licensed release.

    If using the InfluxDB Clustered Helm chart, update the image.tag property in your values.yamlto use a licensed release.

    Upgrade to checkpoint releases first

    When upgrading InfluxDB Clustered, always upgrade to each checkpoint release first, before proceeding to newer versions. Upgrading past a checkpoint release without first upgrading to it may result in corrupt or lost data.

apiVersion: kubecfg.dev/v1alpha1
kind: AppInstance
# ...
spec:
  package:
    # ...
    image: us-docker.pkg.dev/influxdb2-artifacts/clustered/influxdb:
PACKAGE_VERSION
# values.yaml

image:
  tag: 
PACKAGE_VERSION

Replace PACKAGE_VERSION with the version number to upgrade to.

Troubleshoot licensing

After you have activated licensing, use the following signals to verify licensing and troubleshoot issues with your InfluxDB cluster.

In your commands, replace the following:

Verify database components

After you install your license, run the following command to check that database pods start up and are in the Running state:

kubectl get pods -l app=iox --namespace 
NAMESPACE

If a Pod fails to start, run the following command to view pod information:

kubectl describe pod 
POD_NAME
--namespace
NAMESPACE

Verify the Secret exists

Run the following command to verify that the licensing activation created a iox-license secret:

kubectl get secret iox-license --namespace 
NAMESPACE

If the secret doesn’t exist, view license-controller logs for more information or errors.

View license controller logs

The license controller component creates a Secret named iox-license from your License.

To view license controller logs for troubleshooting, run the following command:

kubectl logs deployment/license-controller --namespace 
NAMESPACE

Was this page helpful?

Thank you for your feedback!


The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Read more

InfluxDB v3 enhancements and InfluxDB Clustered is now generally available

New capabilities, including faster query performance and management tooling advance the InfluxDB v3 product line. InfluxDB Clustered is now generally available.

InfluxDB v3 performance and features

The InfluxDB v3 product line has seen significant enhancements in query performance and has made new management tooling available. These enhancements include an operational dashboard to monitor the health of your InfluxDB cluster, single sign-on (SSO) support in InfluxDB Cloud Dedicated, and new management APIs for tokens and databases.

Learn about the new v3 enhancements


InfluxDB Clustered general availability

InfluxDB Clustered is now generally available and gives you the power of InfluxDB v3 in your self-managed stack.

Talk to us about InfluxDB Clustered