Managing Licenses

JFrog Platform Administration Documentation

ft:sourceType
Paligo

Overview

The JFrog Platform Deployments (JPDs) manage activation, renewal and upgrade of all Artifactory type services under your control, including the following benefits:

  • Upload your license buckets using a signed URL or by uploading an offline bucket file

  • Licenses can be managed from the JPD UI or using the REST API.

  • Large number of Artifactory instances can be easily managed and automated using license buckets (requires Mission Control).

Licenses Management

Licenses are managed in the Administration module under Licenses | Licenses. You can upload individual licenses to JPD using the Licenses Management page.

license_keys.jpg

Warning

You cannot attach a license from Mission Control 3.x to JFrog Platform.

License Bucket Management

The JFrog Platform uses License Buckets to manage large number of Artifactory services. License buckets are available for Enterprise+ licence and require JFrog Mission Control.JFrog Mission Control

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

Obtaining a License Bucket

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

Contacting your JFrog representative to create a bucket

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

  • Enterprise Buckets: sales@jfrog.com

  • Enterprise+ and Artifactory Edge buckets: service_Eplus@jfrog.com

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

buckeet license info.png

Adding a License Bucket

Guidelines
  • Matching the URL and Key: For more than one license bucket, make sure the URL and Key that you enter 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.

  1. Go to the Administration module| Licenses| License Buckets, and clickAdd New Bucket.

    license_buckets.png
  2. Enter a Namefor your bucket, an Offline Bucket File or Signed URL, the Key you received from your JFrog representative, and click Add Bucket.

license_bucket_by file upload.png
license bucket by URL.png

Once the license bucket has been loaded to the JPD, 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, hover over a bucket and select View Report from the Actions drop-down menu.

viewing_license_buckets.png
license_bucket_report.png

Bucket Report Section

Description

Total Licenses

The total number of licenses in this bucket.

Bucket Identifier

The identifier of this license bucket.

Expiry Date

The expiry date for this license bucket.

Max. consumed licenses over time

The maximum number of licenses that were ever in use concurrently during the validity period of this bucket.

Split Buckets

The additional buckets split from this original bucket.

Services

The services attached to this license bucket.

Tip

Do you have enough or too many licenses in your 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.

Splitting a License Bucket

A license bucket can be split into any number of separate buckets that can be applied to multiple environments as needed.

This is useful for isolated environments that have disconnected networks, and each require a dedicated service. For example: separate environments for Development, Staging and Production. In this case you would split the bucket into additional sub-buckets that can be assigned to each service that's within each one of the environments in your organization.

To Split a bucket, select "Split" from the action drop down list.

aplitting_license_buckets.png

Add the new bucket name and the number of licenses to assign to it.

Once the new bucket is created, it will be added below the original bucket with the same name, appended by a dash and an ordered number.

For example:

  • original bucket ID: 905539862

  • new bucket ID: 905539862-1