Artifactory version 6.x to 7.x upgrade in Windows

Stop the current server.

cd %ARTIFACTORY_HOME%\bin
artifactory.bat stop

If you are running the Artifactory service as a process, stop the service from Services. Press the Windows key +R and enter services.msc to access Services.

Extract the contents of the compressed archive, move it into a newly created jfrog\artifactory folder, and go to the new folder.

Make sure to run all commands on the server with the user that runs Artifactory.

Set your ARTIFACTORY_HOME and JFROG_HOME variables.

SET ARTIFACTORY_HOME=<Path to your current Artifactory installation>
SET JFROG_HOME=<Path to jfrog folder>
SET JF_PRODUCT_HOME=%JFROG_HOME%/artifactory

The $ARTIFACTORY_HOME variable points to your existing installation, and the $JFROG_HOME variable points to the new installation.

When you set the ARTIFACTORY_HOME and JFROG_HOME variables, make sure to use Windows short name or escape space. For more information, see here.

Copy the directories from your current to the new path. Ignore if the target directory exists.

Mandatory Steps

# Artifactory data
 
mkdir %JFROG_HOME%\artifactory\var\data\artifactory
xcopy %ARTIFACTORY_HOME%\data %JFROG_HOME%\artifactory\var\data\artifactory /E /q
  
# Access data
mkdir %JFROG_HOME%\artifactory\var\data\access
xcopy %ARTIFACTORY_HOME%\access\data %JFROG_HOME%\artifactory\var\data\access /E /q
  
# Replicator data
# Note: If you've have never used the Artifactory Replicator
# your %ARTIFACTORY_HOME%\replicator directory will be empty
mkdir %JFROG_HOME%\artifactory\var\data\replicator
xcopy %ARTIFACTORY_HOME%\replicator\data %JFROG_HOME%\artifactory\var\data\replicator /E /q
  
# Artifactory config
mkdir %JFROG_HOME%\artifactory\var\etc\artifactory
xcopy %ARTIFACTORY_HOME%\etc %JFROG_HOME%\artifactory\var\etc\artifactory /E /q
  
# Access config
mkdir %JFROG_HOME%\artifactory\var\etc\access
xcopy %ARTIFACTORY_HOME%\access\etc %JFROG_HOME%\artifactory\var\etc\access /E /q
  
# Replicator config
# Note: If you've have never used the Artifactory Replicator
# your %ARTIFACTORY_HOME%\replicator directory will be empty
mkdir %JFROG_HOME%\artifactory\var\etc\replicator
xcopy %ARTIFACTORY_HOME%\replicator\etc %JFROG_HOME%\artifactory\var\etc\replicator /E /q
 
# master.key
mkdir %JFROG_HOME%\artifactory\var\etc\security
xcopy %ARTIFACTORY_HOME%\etc\security\master.key %JFROG_HOME%\artifactory\var\etc\security /q
  
# server.xml
mkdir %JFROG_HOME%\artifactory\var\work\old
xcopy %ARTIFACTORY_HOME%\tomcat\conf\server.xml %JFROG_HOME%\artifactory\var\work\old /q
  
# External database driver, for example: mysql-connector-java-<version>.jar
xcopy %ARTIFACTORY_HOME%\tomcat\lib\<your database driver> %JFROG_HOME%\artifactory\app\artifactory\tomcat\lib /q
 
# Change ownership of new Artifactory directory to the user intended to run Artifactory.
# This can be skipped if you performed all previous steps with the user intended to run Artifactory.
 
# Remove logback.xml with old links. Please consider migrating manually anything that is customized here
del %JFROG_HOME%\artifactory\var\etc\artifactory\logback.xml
del %JFROG_HOME%\artifactory\var\etc\access\logback.xml
 
# Move configuration files
# Note: Run the following only when upgrading from Artifactory version 6.x to version 7.5.x and above.
mkdir %JFROG_HOME%\artifactory\var\etc\artifactory\old
mkdir %JFROG_HOME%\artifactory\var\etc\access\old
mkdir %JFROG_HOME%\artifactory\var\etc\replicator\old
 
move /Y %JFROG_HOME%\artifactory\var\etc\artifactory\db.properties %JFROG_HOME%\artifactory\var\etc\artifactory\old\db.properties
move /Y %JFROG_HOME%\artifactory\var\etc\artifactory\ha-node.properties %JFROG_HOME%\artifactory\var\etc\artifactory\old\ha-node.properties
move /Y %JFROG_HOME%\artifactory\var\etc\access\db.properties  %JFROG_HOME%\artifactory\var\etc\access\old\db.properties
move /Y %JFROG_HOME%\artifactory\var\etc\replicator\replicator.yaml %JFROG_HOME%\artifactory\var\etc\replicator\old\replicator.yaml

Optional Steps

# Artifactory backup (optional)
 
mkdir %JFROG_HOME%\artifactory\var\backup\artifactory
xcopy %ARTIFACTORY_HOME%\backup %JFROG_HOME%\artifactory\var\backup\artifactory /E /q
  
# Access backup (optional)
mkdir %JFROG_HOME%\artifactory\var\backup\access
xcopy %ARTIFACTORY_HOME%\access\backup %JFROG_HOME%\artifactory\var\backup\access /E /q
  
# Replicator backup (optional)
mkdir %JFROG_HOME%\artifactory\var\backup\replicator
xcopy %ARTIFACTORY_HOME%\replicator\backup %JFROG_HOME%\artifactory\var\backup\replicator /E /q
  
# Artifactory logs (optional)
mkdir %JFROG_HOME%\artifactory\var\log\artifactory
xcopy %ARTIFACTORY_HOME%\logs %JFROG_HOME%\artifactory\var\log\artifactory /E /q
  
# Access logs (optional)
mkdir %JFROG_HOME%\artifactory\var\log\access
xcopy %ARTIFACTORY_HOME%\access\logs %JFROG_HOME%\artifactory\var\log\access /E /q
  
# Replicator logs (optional)
mkdir %JFROG_HOME%\artifactory\var\log\replicator
xcopy %ARTIFACTORY_HOME%\replicator\logs %JFROG_HOME%\artifactory\var\log\replicator /E /q
 
# Copy specific files from your current to the new path.

For HA installations, replace any relative paths in the %ARTIFACTORY_HOME%\etc\ha-node.properties file with absolute paths.

# relative path
artifactory.ha.data.dir=artifactory-ha
# absolute path
artifactory.ha.data.dir=\var\opt\jfrog\artifactory-ha

Run the migration script with the same privileges as you have in your current Artifactory installation. This script will copy over and translate your current configurations to the new configuration format, according to the new file system layout.

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

Check that the migration has completed successfully, by reviewing the following files.

1. migration log: %JFROG_HOME%\artifactory\var\log\migration.log

2. system.yaml configuration: %JFROG_HOME%\artifactory\var\etc\system.yaml

   This newly created file will contain your current custom configurations in the new format.

Manage Artifactory.

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

To install Artifactory as a Windows service, follow the steps here.

Access Artifactory from your browser at: http://SERVER_HOSTNAME:8082/ui/.

For example, on your local machine: http://localhost:8082/ui/

Check the artifactory-service.log.

type %JFROG_HOME%\artifactory\var\log\artifactory-service.log