Upgrade the First Artifactory Node

JFrog Installation & Setup Documentation

Content Type
Installation & Setup
  1. Remove the first node from the load balancer. All requests are directed to the additional nodes. Check $HOME/log/artifactory-request.log and ARTIFACTORY_URL/artifactory/api/tasks (search for running) to ensure that Artifactory is completely inactive.

  2. Continue with the upgrade according to the instructions for your installation type.

  3. Start up the first node. It will recognize that the HA cluster nodes are not all running the same version of Artifactory, and consequently, the system will be limited to allowing uploads and downloads.

    Any attempt to perform other actions such as changing the DB schema, modifying permissions, changing repository configuration and more, are strictly blocked. This limitation will continue until all the cluster nodes are once again running the same version.

    Version inconsistency generates exceptions

    Running the HA cluster nodes with different versions generates exceptions. These can be seen in the log files and reflect the temporary inconsistent state during the upgrade process. This is normal and should be ignored until all the cluster nodes are, once again, running the same version.

  4. When upgrading from Version 6.x and to 7.x, adjust your reverse proxy settingsHTTP Settings and update your load balancer configuration to use the new JFrog Platform URL http://<hostname>:8081.


    You may need to update the Custom URL base as part of the Artifactory upgrade from 6.x to 7.x. Remember to use a URL that will work correctly in all cases; for example: https://mydomain, which is correct if the reverse proxy is also updated to use both the Artifactory REST API port and the Router port as documented.

  5. Put the first node back to the load balancer.