Newer Version Available

This content describes an older version of this product. View Latest

Installing the Force.com Migration Tool

To download and install the Force.com Migration Tool:

  1. Log into a Salesforce organization on your deployment machine.
  2. From Setup, click Develop | Tools, and then click Force.com Migration Tool.
  3. Save the .zip file locally and extract the contents to the directory of your choice.
  4. Copy ant-salesforce.jar and paste into your Ant installation's lib directory. The lib directory is located in the root folder of your Ant installation.

If you do not have Ant installed, see Prerequisites for Using the Force.com Migration Tool.

Note

When you extract the Force.com Migration Tool zip files, the following folders and files are written to the location you specified:

  • A Readme.html file that explains how to use the tools
  • A Jar file containing the ant task: ant-salesforce.jar
  • A sample folder containing:
    • A codepkg\classes folder that contains SampleDeployClass.cls and SampleFailingTestClass.cls
    • A codepkg\triggers folder that contains SampleAccountTrigger.trigger
    • A mypkg\objects folder that contains the custom objects used in the examples
    • A removecodepkg folder that contains XML files for removing the examples from your organization
    • A sample build.properties file that you must edit, specifying your credentials, in order to run the sample ant tasks in build.xml
    • A sample build.xml file, that exercises the deploy and retrieve API calls