ARTIFACTORY: Convert standalone node to HA cluster

ARTIFACTORY: Convert standalone node to HA cluster

AuthorFullName__c
Marwa Sharif
articleNumber
000005451
ft:sourceType
Salesforce
FirstPublishedDate
2022-11-02T18:17:52Z
lastModifiedDate
2023-02-12T09:13:20Z
VersionNumber
3
Relevant Versions: Artifactory 7.X 

This article describes how to convert a standalone instance into an HA cluster for Artifactory version 7.x.

Below are the steps on how to switch the Artifactory from a single node to a High Availability cluster:
1. In case you have an internal database (DerbyDB), please note that Artifactory HA requires an external database, and currently supports the following databases: PostgreSQL, Oracle, MySQL, and Microsoft SQL. Make sure you have completed setting up your external database before proceeding to install the cluster nodes. For more information, you can refer to our Setup Flow documentation.

2. In the first node, set the haEnabled to true in Artifactory's system.yaml file, you may use the following example for reference:
shared:
    node:
        haEnabled: true
NOTE: Please pay attention to the indentation

3. After modifying the haEnabled to true in the first node, you can add the additional license under the Administration module under Licenses (Each node in the cluster must be activated with a different Enterprise License)

4. Now, you can start with installing the second node as detailed on our HA Installation page using the same installation type as the first node and ensure to add the external database information and shared.node.haEnabled to true in the system.yaml 

5. Copy the master.key from the first node to the second node (located at $JFROG_HOME/artifactory/var/etc/security/master.key)

6. You may need to modify the binarystore.xml configuration to support cluster storage. You may find more details in Configuration of the Filestores.

7. Start the second node and you may monitor the node(s) cluster by navigating to the Administration module under Monitoring >  Service Status


IMPORTANT NOTES:
* All nodes in the same Artifactory HA cluster must be running the same Artifactory version
** Kindly run the first node and ensure that it is running successfully then you may proceed with adding additional nodes.