Upgrade Artifactory Debian Package

This topic provides the steps to upgrade your JFrog Artifactory 7.x instance installed via a Debian package to a newer 7.x version.

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.

Upgrade Steps

The following steps outline how to upgrade your Artifactory single-node installation using either the JFrog APT repository or a direct .deb package download.

Method 1: Upgrade Using the JFrog APT Repository
This is the recommended method for upgrading as it simplifies the process.
1. Stop Artifactory: Before upgrading, stop the Artifactory service.
```
sudo systemctl stop artifactory.service
```
2. Update APT Cache and Install New Version: Update your package list and install the desired Artifactory version. Replace 7.111.11 with your target Artifactory version.
```
sudo apt-get update && sudo apt-get install jfrog-artifactory-pro=7.111.11
```
3. Start Artifactory: Once the package installation is complete, start the Artifactory service.
```
sudo systemctl start artifactory.service
```
4. Verify the Upgrade:
  - Check Status: Run sudo systemctl status artifactory.service to confirm the service is running.
  - Access UI: Access http://<SERVER_HOSTNAME>:8082/ in your browser to verify the UI loads.
  - Monitor Logs: Use tail -f $JFROG_HOME/artifactory/var/log/console.log to check for any startup errors.
Method 2: Upgrade Using a .deb Package
This method is useful for upgrading to a specific .deb package directly.
1. Stop Artifactory: Before upgrading, stop the Artifactory service.
```
sudo systemctl stop artifactory.service
```
2. Download the .deb Package: Download the .deb package for the specific Artifactory version you want to install. For example, to download version 7.111.11:
```
curl -g -L -O -J 'https://releases.jfrog.io/artifactory/artifactory-pro-debs/pool/jfrog-artifactory-pro/jfrog-artifactory-pro-7.111.11.deb'
```
3. Install the New Package: Navigate to the directory where you downloaded the file and use dpkg to install it. This will upgrade your existing installation.
```
sudo dpkg -i jfrog-artifactory-pro-7.111.11.deb
```
4. Start Artifactory: Once the package is installed, start the Artifactory service.
```
sudo systemctl start artifactory.service
```
5. Verify the Upgrade:
  - Check Status: Run sudo systemctl status artifactory.service to confirm the service is running.
  - Access UI: Access http://<SERVER_HOSTNAME>:8082/ in your browser to verify the UI loads.
  - Monitor Logs: Use tail -f $JFROG_HOME/artifactory/var/log/console.log to check for any startup errors.

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.