Install the first node in the cluster.
Install Artifactory as a service on compatible Linux distributions, as a root user.
dpkg -i jfrog-artifactory-<pro|oss|cpp-ce>-<version>.deb
For more information, see Install Artifactory single node with Debian.
Important
Do not start Artifactory after you complete the installation.
Configure the
system.yamlfile with the database and node configuration details.Ensure that you set
haEnabledfield as true.For example:
shared: database: driver: org.postgresql.Driver password: password type: postgresql url: "jdbc:postgresql://<your db url, for example: localhost:5432>/artifactory" username: artifactory node: haEnabled: true taskAffinity: anyPerform Artifactory Product Configuration to configure the database and filestore.
Configure the filestore in
$JFROG_HOME/artifactory/var/etc/artifactory/binarystore.xmlwith the following entry.<config version="2"> <chain template="cluster-file-system"/> </config>If the directory and file do not exist, you can create them yourself.
Start the node.
service artifactory start
Repeat the preceding steps 1 through 3 to install the additional nodes.
All nodes must have the same database configuration and file store configuration.
Copy the
master.keyfrom the first node to the additional nodes located at$JFROG_HOME/artifactory/var/etc/security/master.key.For a node to join a cluster, the nodes must have the same database configuration and the master key.
Start the additional nodes.
Check the Artifactory log.
Configure log rotation of the console log
The
console.logfile can grow quickly since all services write to it. For more information, see configure the log rotation.Configuring Log Rotation for Tomcat
Install a non-management node
By default, all Artifactory nodes in a cluster are installed as equal nodes, meaning they can be be used to manage the cluster. You also have the option of installing a node that does not have management capabilities.
Set the system.yaml parameter taskaffinity to none for a non-management node.
Add licenses according to your license type.
License Key
Option 1: Copy the
artifactory.cluster.licensefile to the first node's configuration directory.cp artifactory.cluster.license $JFROG_HOME/artifactory/var/etc/artifactory/
This can also be done once you start Artifactory using:
Option 2: License Management in the UIManage Licenses
Option 3: Install License REST APIInstall License
Specifying multiple licenses
Whether in the Artifactory UI, using the REST API or in the artifactory.cluster.license file, make sure that the licenses are separated by two newlines.
License Bucket
Applying a license bucket requires JFrog Mission Control.
Complete configuring and starting the first node.
Enable Mission Control microservice in Artifactory.
Apply your license Bucket Management in the UIManage Licenses
After installing and before running Artifactory, you may set the following configurations:
System YAML Configuration File
Where to find system.yaml?
You can configure all your system settings using the
system.yamlfile located in the$JFROG_HOME/artifactory/var/etcfolder. For more information, see Artifactory YAML Configuration.If you don't have a System YAML file in your folder, copy the template available in the folder and name it
system.yaml.For the Helm charts, the
system.yamlfile is managed in the chart’svalues.yaml.Configuring Database
If you're planning to use it in production, it is highly recommended to first Configure the Database, and then start Artifactory.
Customize Java Opts (optional)
Remember to modify your JVM Parameters as needed by setting
JAVA_OPTIONSin Shared Configurations. The property to pass extra Java opts isartifactory.extraJavaOpts. It is highly recommended to set your Java memory parameters as follows:Tip
The larger your repository or number of concurrent users, the larger you need to make the -Xms and -Xmx values accordingly. If you can reserve at least 512MB for Artifactory, the recommended minimal values are:
-server -Xms512m -Xmx2g -Xss256k -XX:+UseG1GCFor more recommendations about your hardware configuration (especially the -Xmx parameter), see System Requirements
Additional Settings
These include: customizing ports, joinKey (join.key), masterKey (master.key).
Configuring the Filestore
By default, Artifactory is configured to use the local file system as its filestore. Artifactory supports a variety of additional filestore configurations to meet a variety of needs for binary storage providers, storage size and redundancy.
Enable TLS 1.0 and 1.1 for Connectivity with Older Databases
Artifactory version 7.25.2 onwards includes OpenJDK version 11.0.11 and later. TLS 1.0 and TLS 1.1 are disabled by default from OpenJDK 11.0.11 onwards. If your database version does not support TLS 1.2, the Artifactory startup fails.
If you are unable to upgrade your database to a version that supports TLS 1.2 or later, perform the following steps to run Artifactory.
Download the java.security file that has TLS 1.0 and 1.1 enabled.
Create the directory,
${JFROG_HOME}/artifactory/var/bootstrap/artifactory/java.Copy the java.security file into
${JFROG_HOME}/artifactory/var/bootstrap/artifactory/java.Provide the appropriate permissions to the directory.
Note
Artifactory startup takes a backup of the existing java.security file and bootstraps custom java.security into the
${JFROG_HOME}/artifactory/app/third-party/java/conf/securityfolder.