When preparing to migrate from an on-premises Artifactory instance to a cloud-based Artifactory SaaS instance using the JFrog CLI, you may encounter an error message that reads:
22:05:24 [🚨Error] 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.
This error message indicates that the JFrog CLI is unable to locate the directory in which to install the data-transfer plugin. This plugin is necessary for transferring data from your on-premises Artifactory instance to the Artifactory SaaS instance.
In order to resolve this issue, please make sure that you have the JFROG_HOME environment set correctly pointing to the JFROG HOME folder on your system. Along with this, as the error output suggests, we can use the –home-dir option to identify where the JFROG home folder is located.
After taking the above steps, we can run the following command to make sure that everything is set up correctly before we perform the migration:
- jf rt transfer-config source-server target-server --prechecks
In this link, resides the transfer plugin. Once you've installed the plugin files, we can proceed to copy them to the plugins folder location (the plugins folder should be located under $JFROG_HOME/artifactory/var/etc/artifactory/plugins).
After the relevant plugin files are copied to the plugins folder, we can proceed with executing the Reload Plugins REST API call which will load the newly moved plugin files to Artifactory.
Finally, once the plugin is loaded, we can once again, run the below pre-check to ensure everything is set up correctly before our transfer-config process:
- jf rt transfer-config source-server target-server --prechecks