JFrog Mission Control offers a convenient way to attach licenses to Artifactory instances it manages through the Manage module under Licenses | Update License. This works well when managing several instances of Artifactory, but may become more challenging as enterprises grow and start managing larger numbers of Artifactory instances.
From version 1.2, JFrog Mission Control introduces License Bucket management which automates, and therefore, greatly simplifies the management of licenses for large numbers of Artifactory instances.
To use JFrog Mission Control license bucket management, you first need to set up the following components on your system:
Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files
- JFrog Command Line Interface (CLI)
Installing the JCE Unlimited Strength Policy Files
To maintain privacy of your Artifactory licenses, JFrog Mission Control license buckets are provided in an encrypted format. For JFrog Mission Control to be able to decrypt the license buckets, you need to download and install the latest Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files on the server running Mission Control. While the JCE is an integral part of the JRE, you need to install this latest version of the policy files in your JRE installation.
Once the JCE Unlimited Strength Jurisdiction Policy files are installed, you need to restart JFrog Mission Control.
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 instances through Mission Control. For details on downloading and installing JFrog CLI, please refer to the JFrog CLI documentation.
Obtaining a Bucket of Licenses
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>
Loading the License Bucket
You can view all loaded license buckets in the Manage 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 instance at a time, you are free to move any license around to different Artifactory instances as long as the license remains valid. For example, you can temporarily attach a license from a bucket to an Artifactory instance used for a specific development project. Once the project is complete and the Artifactory instance 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.
attach-lic command extracts a license from the bucket specified and attaches it to the specified Artifactory instance.
detach-lic command removes the specified license from the specified Artifactory instance 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.
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.
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.
|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|
|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 instances in your organization and should consider purchasing more Artifactory licenses.