To activate Artifactory HA, you must install an appropriate license as part of the installation.
There are three ways to manage the licenses:
Artifactory UI
Rest API
Kubernetes Secret
Specifying multiple licenses
Whether you are using the Artifactory UI, the REST API, or in the artifactory.cluster.license
file, make sure that the licenses are separated by a newline.
The easiest and recommended way is by using Artifactory UI. Using the Kubernetes Secret or REST API is for advanced users and is better suited for automation.
Warning
You should use only one of these methods. Switching between them while a cluster is running might disable your Artifactory HA cluster.
Option A: Using Artifactory UI
Once the primary cluster is running, open Artifactory UI and insert the license(s) in the UI. For more information, see HA installation and setup.
Enter all of the licenses at once, with each license separated by a newline. If you add the licenses one at a time, you may get redirected to a node without a license and the UI will not load for that node.
Option B: Using Rest API
You can add licenses via REST API. Note that the REST API uses "\n" for the newlines in the licenses (this is currently the recommended method).
Option C: Using a Kubernetes Secret
You can deploy the Artifactory license(s) as a Kubernetes Secret. You will need to prepare a text file with the license(s) written in it. If adding multiple licenses, they are added in the same file. Remember to add two new lines between each license block.
Create the Kubernetes secret (assuming the local license file is '
art.lic
').kubectl create secret generic artifactory-cluster-license --from-file=./art.lic
Create a
license-values.yaml
.artifactory: license: secret: artifactory-cluster-license dataKey: art.lic
Install with the
license-values.yaml
.Run the following command for JFrog Platform.
helm upgrade --install jfrog-platform --namespace jfrog-platform --create-namespace jfrog/jfrog-platform -f license-values.yaml
Run the following command for Artifactory.
helm upgrade --install artifactory --set artifactory.license.secret=artifactory-cluster-license,artifactory.license.dataKey=artifactory.lic --namespace artifactory jfrog/artifactory
Important
This method is relevant for initial deployment only. Once Artifactory is deployed, you should not keep passing these parameters, since the license is already persisted into Artifactory's storage (and they will be ignored). Updating the license should be done via Artifactory UI or REST API.
Create the Kubernetes Secret as Part of the Helm Release
Create a
license-values.yaml
.artifactory: license: licenseKey: |- <LICENSE_KEY1> <LICENSE_KEY2> <LICENSE_KEY3>
Install with the
license-values.yaml
.helm upgrade --install jfrog-platform --namespace jfrog-platform --create-namespace jfrog/jfrog-platform -f license-values.yaml