Installation.


Table of Contents



Prerequisites.

Before you install and use the SFDMU Plugin, ensure that the SF CLI is installed on your system.

If you wish to use the source code of the SFDMU Plugin, you must also install Node.js and Git.

Installation.

Installation as a SFDX Plugin

The simplest and the recommended method for installing SFDMU is as a standard SFDX plugin. This approach uses the production version of the plugin:

# Uninstall any old versions of the plugin:
$ sf plugins uninstall sfdmu

# Install the latest version of the plugin:
$ sf plugins install sfdmu

Installation from Cloned Source Code (for Debugging)

For debugging purposes, you can install the plugin from source code:

# Unlink any old linked source code:
$ sf plugins unlink

# Clone the latest source code:
$ git clone https://github.com/forcedotcom/SFDX-Data-Move-Utility

# Navigate to the installation directory:
$ cd SFDX-Data-Move-Utility

# Install required npm modules:
$ npm install

# Link the plugin to the SF CLI:
$ sf plugins link
Notes:
  • MacOS Users: If you encounter permission issues, prepend commands with sudo, e.g., $ sudo sf plugins install sfdmu.

  • CLI Version Compatibility: If using the older SFDX CLI, replace sf with sfdx and adjust commands accordingly, e.g., sfdx plugins:install sfdmu instead of sf plugins install sfdmu, etc.

  • If you have already installed the SFDMU plugin as an SFDX Plugin using sf plugins install sfdmu, you do not need to execute sf plugins link on the local repository directory if your intention is merely to use the source code for debugging purposes.

Last updated on 2nd May 2024