Upgrade Artifactory on Windows

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

Stop Artifactory: Navigate to the bin directory and stop the service.
```
cd %JFROG_HOME%\artifactory\app\bin
artifactory.bat stop
```

Download and Extract the New Archive: Download the new .zip archive for your target version and extract its contents to a temporary location.

# Example paths
SET JFROG_HOME=C:\Program Files\jfrog
SET JF_NEW_VERSION=C:\Temp\artifactory-pro-7.x

# Download and extract the .zip file to the new version directory.
# You will need to use a tool like 7-Zip or PowerShell's Expand-Archive.

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

# Remove old app directory
rmdir %JFROG_HOME%\artifactory\app /s /q

# Copy new app directory
xcopy %JF_NEW_VERSION%\app %JFROG_HOME%\artifactory\app /e /i

# Remove the temporary extracted new version
rmdir %JF_NEW_VERSION% /s /q

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.
```
Search Impacted Resources by Package Version
```
Add your Database Connector (if required): If your database requires a specific driver, add it to %JFROG_HOME%\artifactory\var\bootstrap\artifactory\tomcat\lib before starting Artifactory services. For example, you would need to add the MySQL connector if you use a MySQL database.
Start Artifactory: Start the Artifactory service.
```
sc start artifactory
```
Alternatively, you can manage Artifactory manually using the control script:
```
%JFROG_HOME%\artifactory\app\bin\artifactory.bat start|stop|check
```
Verify the Upgrade:
- Access UI: Open your browser and navigate to http://<SERVER_HOSTNAME>:8082/ui/ to verify the UI loads.
- Description: Search all resources (artifacts) that include a specific package version.

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.