Overview

JFrog Mission Control manages activation, renewal and upgrade of all Artifactory type services under your control, including the following benefits: 

  • Upload your license buckets to Mission Control using a signed URL or by uploading an offline bucket file
  • Licenses can be managed from the Mission Control UI or using REST API
  • Large number of Artifactory services can be easily managed and automated using license buckets and JFrog CLI

License Bucket Management

Mission Control uses License Buckets to manage large number of Artifactory services. License buckets are available for Enterprise+, Artifactory Edge and Enterprise.

Once you have your license bucket(s), you can add them to Mission Control and match them against their services.


Obtaining a License Bucket

Once your licence bucket is created, you will receive an email with a link to a dedicated web page.

For additional information on how you can get your License Buckets, please contact JFrog sales:

This page will display your personalized bucket license information needed when adding your bucket, including the Bucket IdentifierSigned URL and Key.


Adding a License Bucket

There are two ways to add your license bucket:

  1. The Onboarding Wizard
  2. The Admin Module

When using a signed URL to download a license bucket, the URL points to a location on JFrog Bintray. Ensure the host running Mission Control is able to connect to URLs prefixed with https://dl.bintray.com/

Onboarding Wizard

Step 4 of the Onboarding Wizard allows you to add your license buckets using an Offline Bucket File or Signed URL and Bucket Key.

Admin Module

Go to the Admin moduleLicenses > Bucket Management, and click Add new bucket.

Enter a Name for your bucket, an Offline Bucket File or Signed URL, the Key you received from your JFrog representative, and click Add Bucket.

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

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 Mission Control, you can attach licenses from it using JFrog CLI.

Viewing Bucket Information

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 license 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

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 not used all the licenses in this bucket concurrently, you may be able to manage with fewer licenses.
  • If you reached 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.

Removing a License Bucket

To view all loaded license buckets, go to Admin 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.


Automating License Buckets with CLI

Using license buckets and JFrog CLI, you can easily automate, and therefore greatly simplify, managing licenses for a large number of Artifactory services. 

Using Mission Control CLI

JFrog CLI is a compact and smart client that provides a simple interface to JFrog Mission Control (through its REST API). It 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. 

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.

Attaching and Detaching Licenses

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.


Updating Licenses

There are four steps to applying licenses:

  1. Select Artifactory Services

  2. Add Licenses

  3. Match Licenses to Services

  4. Apply Licenses

You may update the license of several Artifactory services at a time by matching the service with its corresponding license key, and applying all the license keys in a single bulk operation.

Select Artifactory Services

To enter or update an Artifactory license, go to Admin, select Licenses > Update license.

Select the one or more service for which you want to add or update a license, and click Continue.

Add Licenses

Paste the license keys you want to apply to your Artifactory services to the Add Licenses entry field, click Add Licenses and Continue.

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.

Matching Licenses to Services

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.

To apply the licenses click Execute All.


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 Management for individual Artifactory or Artifactory Edge

To apply licenses to a single Artifactory instance use the following steps:

1. Add a new bucket
2. Select Edit service for an existing Artifactory or Edge service
3. In the credentials section, enter username/password and select Test Connectivity. If the connectivity test succeeds, the dropdown for bucket selection is enabled.
4. Choose the new bucket from the list and select Save.

Mission Control will determine the number of licenses the selected Artifactory/Edge instance requires and deploys that many licenses. If the existing licenses have better expiry than the selected bucket, then no action is taken.

Note: For Artifactory and Artifactory Edge services, buckets of both types are available for selection. This allows you to switch an Artifactory to Artifactory Edge or vice versa.