Upgrade Artifactory with Linux Archive

This topic provides the steps to upgrade your JFrog Artifactory 7.x instance installed via a Linux archive 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 from a Linux Archive.

Log in as a root user.

Set the JFROG_HOME variable:

export JFROG_HOME=<Your JFrog home directory, for example /opt/jfrog>

Stop Artifactory: Navigate to the bin directory and stop the service.
```
cd $JFROG_HOME/artifactory/app/bin
./artifactoryctl stop
```
Download and Extract the New Archive: Download the new archive, then extract its contents. Replace <version> with your target version.
```
tar -xvf jfrog-artifactory-<pro|oss|cpp-ce>-<version>-linux.tar.gz
```

Export the JF_NEW_VERSION variable:

export JF_NEW_VERSION=<For example /opt/jfrog/artifactory-7.x>

Replace the existing app folder: Use the following commands to replace the existing app folder with the new one.

# Remove app
rm -rf $JFROG_HOME/artifactory/app
# Copy new app
cp -r $JF_NEW_VERSION/app $JFROG_HOME/artifactory
# Remove extracted new version
rm -rf $JF_NEW_VERSION
# Set permissions
chown -R artifactory:artifactory $JFROG_HOME/artifactory/app

Re-install as a Service (if applicable): If Artifactory was installed as a service previously, reinstall it to ensure the new version starts correctly. Otherwise, a restart of the server may lead to the older version of Artifactory starting up.
```
cd $JFROG_HOME/artifactory/app/bin
./installService.sh
```
Add your Database Connector (if required): Add your database connector to $JFROG_HOME/artifactory/var/bootstrap/artifactory/tomcat/lib if required. For example, if your database is MySQL, you need to add the MySQL connector before starting Artifactory services.
Start Artifactory: Start the Artifactory service.
```
sudo systemctl start artifactory.service
```
Alternatively, you can manage Artifactory using the control script:
```
$JFROG_HOME/artifactory/app/bin/artifactoryctl start|stop|check
```
Verify the Upgrade:
- 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.