This topic covers the upgrade process for Artifactory when you are using an external database.
If you want to upgrade from any version lower than 7.x, see Upgrading Artifactory from 6.10.x to 7.x.
Preparation and Pre-Upgrade Checks
To ensure a smooth upgrade, consider the following:
Backup Your Data: We strongly recommend you to perform a full backup of your Artifactory data directory (
$JFROG_HOME/artifactory/var) and database before starting any upgrade process. This allows for recovery in case of unexpected issues.Review Release Notes: Always check the Artifactory Release Notes for the target version. They may contain critical information, breaking changes, or specific pre-upgrade tasks not covered here.
Downtime: In a single-node setup, the Artifactory service will be unavailable to users during the upgrade. In High-Availability (HA) mode, a rolling upgrade ensures only one node is down at a time, allowing the service to remain available to users.
Upgrading a Single Node
Run the helm upgrade command to upgrade your single-node Artifactory deployment.
Run the following command:
helm upgrade artifactory --namespace artifactory jfrog/artifactory
Upgrading an HA Setup
To upgrade an HA deployment with an external database that was originally installed using the artifactory chart, run the helm upgrade command.
Run the following command:
helm upgrade artifactory --namespace artifactoryha jfrog/artifactory
Troubleshooting and Post-Upgrade Notes
Database Migrations: During the first startup after an upgrade, Artifactory may run database converters to execute changes in the database schema.