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.
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.
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.
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.
Go to the Administration module| Licenses| License Buckets, and clickAdd New Bucket.
Enter a Namefor your bucket, an Offline Bucket File or Signed URL, the Key you received from your JFrog representative, and click Add Bucket.
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.
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.
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