Add a license to Kommander

Add licenses for Kommander clusters

Prerequisites

For licenses that you purchase from the AWS Marketplace, an AWS administrator must attach the AWS managed policy AWSLicenseManagerConsumptionPolicy to the control-plane.cluster-api-provider-aws.sigs.k8s.io role created when configuring AWS IAM policies for Konvoy.

Without this policy attached to the role, Kommander cannot verify the license information provided in the steps below.

Obtain a license token or AWS license ARN

For licenses purchased directly from D2iQ, obtain the license token via the customer support portal. Input this token in the last step below.

For licenses purchased via the AWS marketplace, find the license in the “Granted Licenses” table of AWS License Manager inside the AWS console. If necessary, modify the table view preferences to show “License ARN.” Copy this value for use in the last step below.

Enter license information

NOTE: An administrator must add licenses to Kommander.

From the Kommander UI, complete the following steps:

  1. Select Global in the workspace header drop-down.

  2. In the sidebar menu, select Administration > Licensing.

  3. Select + Add License to enter the Add License form.

  4. On the Add License form page, select D2iQ or AWS Marketplace depending on where you acquired your license.

  5. Paste your license token or AWS ARN in the text box and select Save.

If there is an error submitting a license acquired directly from D2iQ, you can add the license directly through kubectl.

Enter a D2iQ license via kubectl

You can add a license acquired from D2iQ directly using kubectl.

  1. Create a secret, replacing MY_LICENSE in the below command with your D2iQ-provided Kommander license:

    kubectl create secret generic my-license-secret --from-literal=jwt=MY_LICENSE -n kommander
    kubectl label secret my-license-secret kommanderType=License -n kommander
    
  2. Create a license object:

    cat <<EOF | kubectl apply -f -
    apiVersion: kommander.mesosphere.io/v1beta1
    kind: License
    metadata:
      name: my-license
      namespace: kommander
    spec:
      licenseRef:
        name: my-license-secret
    EOF
    

Return to the license page in the UI to see your valid license display.