Introduction
In a JFrog Artifactory High Availability (HA) environment, certain configuration files, such as the system.yaml, are local to each specific node. This article addresses why manual intervention is required when updating passwords within these configurations and how to ensure the changes are reflected across the entire cluster.
Goal of the Article
This article will guide you through the process of manually updating passwords in an HA setup and performing the necessary service restarts to maintain credential consistency across all nodes.
Resolution
Step-by-Step Instructions
The system.yaml file contains parameters unique to each individual node, it is not automatically synchronized or replicated across the HA cluster. Follow these steps to update a password:
- Modify the Local Configuration: Update the password in the system.yaml file on your primary node (e.g., Node 1).
- Manually Update Peer Nodes: Navigate to each additional node in the cluster (e.g., Node 2) and manually update its system.yaml file with the matching password entry.
- Perform a Rolling Restart: Execute a manual rolling restart of the Artifactory service on each node. This ensures the new configuration is properly loaded and that all nodes are using consistent credentials without causing full cluster downtime.
Conclusion
Maintaining consistent configurations across an HA cluster is vital for seamless operation. By manually updating the system.yaml on every node and performing a rolling restart, you ensure that your Artifactory instance remains stable and secure with the updated credentials.