Have a question? Want to report an issue? Contact JFrog support

Skip to end of metadata
Go to start of metadata

Overview

The Mission Control Licenses sub-module manages activation, renewal and upgrade of all Artifactory services under your control. There are two ways to manage Services' licenses:

  • Updating individual licenses manually 
  • Managing multiple licenses automatically with License Buckets 

Updating Licenses Individually

 You may update the license of several Artifactory services at a time by matching the service with its corresponding license, and applying all the licenses in a single bulk operation. To enter or update an Artifactory license, in the Admin module, select Licenses | Update license. The process is fully described in Updating Licenses below. 

Using License Buckets

Using license buckets, you can automate, and therefore greatly simplify, managing licenses for a large number of Artifactory services. The process is fully described in License Bucket Management below. 

Updating Licenses 

The process of applying licenses has four steps:

  1. Select Artifactory Services

  2. Add Licenses

  3. Match Licenses to Services

  4. Apply Licenses

Page contents

Select Artifactory Services

Select the one or more service for which you want to add or update a license, and click "Continue" to move on to the next step

Add Licenses

Enter the different licenses you want to apply to your Artifactory services.

Simply paste the licenses you want to add into the Add Licenses entry field and click "Add Licenses". Click "Continue" to move on to the next step.

Adding multiple licenses at once

You can add licenses one at a time, or paste several licenses, separated by an empty line, into the Add Licenses field and add them to the list at once.

Match Licenses to Services

In this step, you need to match up the Artifactory services you have selected with the licenses you have added.

First select an Artifactory service. This will enable the list of licenses.

Then, select the license you wish to apply to the selected service and click "Add".

The column on the right displays your matched selections.

To change services and licenses matches, click Delete to return the service and license of a matched set to their respective lists.

Once you have matched all of your Artifactory services with their licenses, click "Continue" to move on to the next step.

 

Apply Licenses

The Summary screen displays the Artifactory services that should be updated with the licenses you selected for them.

 

Wrong screenshot 

To apply the licenses click "Execute All".

You can retry, but you cannot roll back.

If, for any reason, applying a license does not work in any of the Artifactory services, you can click the corresponding "Retry" button to try again.

However, once a licenses is applied, you cannot roll back to the previous licenses. 


License Bucket Management

JFrog Mission Control uses License Bucket Management which automates, and therefore, greatly simplifies the management of licenses for large numbers of Artifactory services.

JFrog Mission Control offers a convenient way to attach licenses to Artifactory services it manages through the Admin module under Licenses | Update License. This works well when managing several services of Artifactory, but may become more challenging as enterprises grow and start managing larger numbers of Artifactory services.

Getting a License Bucket

Contact JFrog Sales at sales@jfrog.com for additional information on how you can get your License Bucket.

Initial Setup

To use JFrog Mission Control license bucket management, you first need to set up the following components on your system:

  • JFrog Command Line Interface (CLI)

Installing JFrog CLI

JFrog CLI is a compact and smart client that provides a simple interface to JFrog Mission Control (through its REST API). JFrog CLI can be used by your automation environment for fully automated license management for all your Artifactory services through Mission Control. For details on downloading and installing JFrog CLI, please refer to the JFrog CLI documentation. 

Obtaining a Bucket of Licenses

To obtain your bucket of licenses, please contact your JFrog representative who will create a bucket with the number of licenses you require and send them to you. All licenses in a bucket have exactly the same activation parameters. That means they will all be enterprise or trial licenses with the same date of expiry.

 You will receive your license bucket through two email messages. The first message includes a signed URL that points to the archive containing the bucket of licenses. You should look out for a section similar to the below:

...

Here are the identifier and signed URL for this license bucket:

Bucket identifier: <bucket_id>

Signed URL: <signed_URL>

The second message includes a decryption key for the license bucket. You should look out for a section similar to the below:

Here are the identifier and Key for this license bucket:

Bucket identifier: <bucket_id>

Key: <key>

You need to enter the Bucket IdentifierSigned URL and Key in JFrog Mission Control as described in the next section.

Adding a License Bucket

You can view all loaded license buckets in the Admin module under Licenses | Bucket Management.

To load a new bucket, click Add New Bucket.

You can give the bucket a logical name in the Name field. Enter the signed URL and Key you received from your JFrog representative and click Get Bucket.


Match the bucket identifier to the URL and key

If you have received more than one license bucket, make sure you enter a URL and Key that correspond to the same Bucket Identifier.

 

Bucket name and identifier are two different things

Don’t confuse the bucket Name with the Bucket Identifier. The bucket name is an arbitrary logical name you assign to the bucket. The identifier is a unique identifier assigned to the bucket by JFrog.

Once the license bucket has been loaded into JFrog Mission Control, you can attach licenses from it using JFrog CLI.

Attaching and Detaching Licenses

While each Artifactory license can only activate one Artifactory service at a time, you are free to move any license around to different Artifactory services as long as the license remains valid. For example, you can temporarily attach a license from a bucket to an Artifactory service used for a specific development project. Once the project is complete and the Artifactory service is no longer needed, you can detach the license and return it to the bucket managed by Mission Control.

You can attach and detach licenses with the JFrog CLI.

The attach-lic command extracts a license from the bucket specified and attaches it to the specified Artifactory service.

The detach-lic command removes the specified license from the specified Artifactory service and returns it to the specified bucket in JFrog Mission Control

A license always belongs to the same bucket

When you detach a license, it is always returned to the same bucket it was attached from.

For details on using the JFrog CLI to attach and detach licenses, please refer to to the JFrog CLI documentation.

Working with Artifactory HA

From version 5.0 of JFrog Artifactory, licensing for all cluster nodes in an Artifactory High Availability configuration are managed through the Cluster License Manager. When attaching or detaching licenses to an HA cluster, Mission Control will detect the Artifactory version and work accordingly with the Cluster License Manager if the version is 5.0 or above, or directly with each node for earlier versions of Artifactory.

Removing a License Bucket

You can view all loaded license buckets in the Admin module under Licenses | Bucket Management.

To remove a bucket, hover over it and select delete. Removing the bucket will not remove the licenses from the services.

Once the license bucket is removed, the services that were attached to it should be assigned to a new bucket.

Bucket Report

A bucket report provides a variety of information on usage of licenses in the bucket. To view a bucket report, click the Bucket ID  in the list of license buckets.

To detach a license key, right click on it and select "Detach".

Bucket identifier
The identifier of this bucket
Max. consumed licenses
The maximum number of licenses that were ever in use concurrently during the validity period of this bucket
Current licenses in use

The number of licenses currently in use

Current available licenses
The number of licenses currently available
Total licenses
The total number of licenses in this bucket

Do you have enough or too many licenses in your bucket?

The value of Max. Consumed Licenses shows you that highest number licenses you ever used during the validity period of this bucket. This is something to consider when you renew your JFrog Artifactory licenses. If you never used all the licenses in this bucket concurrently, you may be able to manage with fewer licenses. If you did reach the total number of licenses in this bucket, you may not be meeting the demand for Artifactory services in your organization and should consider purchasing more Artifactory licenses.

  • No labels