ARTIFACTORY: "data-transfer" Plugin Manual Install Steps

AuthorFullName__c
Patrick Russell
articleNumber
000006176
FirstPublishedDate
2024-09-12T06:51:51Z
lastModifiedDate
2025-05-21

ARTIFACTORY: "data-transfer" Plugin Manual Install Steps


Are you getting the following error when running the Cloud Migration "transfer-plugin-install" command?

jf rt transfer-plugin-install source

00:00:00 [🚨rror] can't find the directory in which to install the data-transfer plugin. Please ensure you're running this command on the machine on which Artifactory is installed. You can also use the --home-dir option to specify the directory.


You could try to pin down the right directory to put into the --home-dir option, but there is another way. 

This CLI command is installing an Artifactory User Plugin, so you can perform these steps yourself. This will let you proceed with the Cloud Migration without delay.

Manual Migration Plugin Installation Instructions
1. Download the data-transfer.jar and place it in $JFROG_HOME/var/etc/artifactory/plugins/lib/ (Create this folder if it’s not there)

If you can't use "wget" on your server, the JAR can be downloaded by following this link.

# Start from the "Artifactory Home" location
# Where the "etc" "log" and "data" directories are
mkdir -p etc/artifactory/plugins/lib 

wget "https://releases.jfrog.io/artifactory/jfrog-releases/data-transfer/[RELEASE]/lib/data-transfer.jar"

mv data-transfer.jar etc/artifactory/plugins/lib/

# "chown" the file to the right Linux user and group
# This may vary by install type

sudo chown artifactory:artifactory etc/artifactory/plugins/lib/*.jar


2. Download the dataTransfer.groovy plugin and place it in $JFROG_HOME/var/etc/artifactory/plugins/

If you can't use "wget" on your server, you can download this file by following this link.

wget "https://releases.jfrog.io/artifactory/jfrog-releases/data-transfer/[RELEASE]/dataTransfer.groovy"

mv dataTransfer.groovy etc/artifactory/plugins/

# Please ensure the Linux account is correct before running this chown step

sudo chown artifactory:artifactory etc/artifactory/plugins/dataTransfer.groovy


3. With the JAR in the "lib" folder and the plugin code in the "plugins" folder, reload the plugin using the Artifactory API:

curl -u admin -X POST http://localhost:8081/artifactory/api/plugins/reload


Expected Output:
Successfully loaded: dataTransfer.groovy

This completes the "Install the transfer plugins" step. You can proceed with the rest of the Cloud Migration.