Upgrade Windows Archive

Upgrading Artifactory on Windows is a straightforward process that involves downloading the new .zip archive, stopping the current service, and manually replacing the application files. This method offers a flexible solution for managing Artifactory directly on a Windows system.

Choose your environment below to get started:

• Upgrade Artifactory with a Windows Archive

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.

1. Stop Artifactory: Navigate to the bin directory and stop the service.

   Bash

   cd %JFROG_HOME%\artifactory\app\bin
   artifactory.bat stop

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

   Bash

   # 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.

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

   Bash

   # 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

4. 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.

   Text

   Search Impacted Resources by Package Version

5. 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.

6. Start Artifactory: Start the Artifactory service.

   Bash

   sc start artifactory

   Alternatively, you can manage Artifactory manually using the control script:

   Bash

   %JFROG_HOME%\artifactory\app\bin\artifactory.bat start|stop|check

7. 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.