Managing Licenses

---

Licenses Management

Licenses are managed in theAdministrationmodule underLicenses | Licenses. You can upload individual licenses to JPD using the Licenses Management page.

---

License Bucket Management

The JFrog Platform usesLicense Bucketsto manage large number of Artifactory services. License buckets are available forEnterprise+ licenceand requireJFrog 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.

This page will display your personalized bucket license information needed when adding your bucket, including theBucket Identifier,Signed URLandKey.

ƒ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 theAdministrationmodule|Licenses|License Buckets, and clickAdd New Bucket.
   
   

2. Enter aNamefor your bucket, anOffline Bucket FileorSigned URL,theKeyyou received from your JFrog representative, and clickAdd Bucket.

Once the license bucket has been loaded to the JPD, you can attach licenses from it usingJFrog 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 selectView Reportfrom theActionsdrop down menu.

---

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 dedicatedservice. 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

The newly created licenses bucket should be downloaded and uploaded to the JPD environment it is intended for.

To download the split license bucket, hover over the bucket and selectDownload BucketandCopy Keyfrom the from theActionsdrop down menu.

---

Attaching Licenses

To attach a license to a license bucket, select Attach License from the drop-down list.

---

Removing a License Bucket

To remove a license bucket, go toAdministrationmodule>License>License Buckets, hover over a specific bucket and select删除from theActionsdrop down.

Updating Licenses

To attach a license bucket, hover over the bucket and selectAttach Licensefrom theActionsdrop down menu.

The Attach License page displays theavailableand used licenses within the selected license bucket, and theonlineservices.

You can attach as many licenses to anJPDcluster as needed.

To set thenumber of licensesyou would like to attach to each service, select thegreen check iconand click onAttach licenses. You can set the licenses to all services in bulk by selecting the uppermost green checkbox.

The "# Licenses to Attach" column initially displays the minimum number of licenses the specific service requires. You can increase this number according to the number of available licenses in your bucket. However, you cannot attach less licenses than this default number.

Automating License Buckets with CLI

可以使用许可桶和JFrog CLI 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 theCLI for JFrog Mission Control.

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.

Deploying and Releasing Licenses

You can deploy or release licenses with the JFrog CLI.

TheDeploying a Licensecommand deploys a license from the bucket specified and attaches it to the specified Artifactory service.

TheReleasing a licensecommand 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 release a license, it is always returned to the same bucket it was attached from.

For details on using the JFrog CLI, please refer to to theJFrog CLI documentation.

---

License Management for an Individual Artifactory or Artifactory Edge

To apply licenses to a single JPD 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 selectTest Connectivity. If the connectivity test succeeds, the dropdown for bucket selection is enabled.
4. Choose the new bucket from the list and select Save.

The JPD 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.