Upgrade Artifactory RPM Package

This topic provides the steps to upgrade your JFrog Artifactory 7.x instance installed via an RPM 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 RPM repository or a direct .rpm package download.

Method 1: Upgrade Using the JFrog RPM 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. Install New Version: Install the desired Artifactory version. Replace 7.111.11 with your target Artifactory version.
```
sudo yum install jfrog-artifactory-pro-7.111.11
```
  On newer Fedora or CentOS/RHEL versions, you might use dnf instead of yum.
```
sudo dnf 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/ui/ 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 .rpm Package
This method is useful for upgrading to a specific .rpm package directly.
1. Stop Artifactory: Before upgrading, stop the Artifactory service.
```
sudo systemctl stop artifactory.service
```
2. Download the .rpm Package: Download the .rpm 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-rpms/jfrog-artifactory-pro/jfrog-artifactory-pro-7.111.11.rpm'
```
3. Install the New Package: Navigate to the directory where you downloaded the file and use yum to install it. This will upgrade your existing installation.
```
sudo yum install -y ./jfrog-artifactory-pro-7.111.11.rpm
```
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/ui/ 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.