REDCap Quick Migration Instructions

Note: "Users" are not automatically transferred via the Migration Tool. To transfer users, please download any "DAGS," "User Groups," and "Users" from the Applications menu. Users that have already logged in to the VU instance will transfer. We recommend that users establish their VU instance accounts before exporting from the VUMC instance. 

  1. Login to the VU instance (https://redcap.vanderbilt.edu)
  2. Click on "New Project"  
  3. Select “Enter a project migration key” then click on “Get Instance ID”
  4. Save the instance ID which will be needed later in the process.  This ID is the same for all projects you are migrating to the VU instance.
  5. Login to the VUMC instance (https://redcap.vumc.org/index.php?action=myprojects)
  6. Go to a project you wish to migrate
  7. If you already have an API key you can skill this step. If you do not have an API key, click on API and then generate API token. 
  8. Click "Home"
  9. Select "Other Functionality"
  10. Scroll down and click on "Project Migration Tool"
  11. Select everything you want to migrate (if you are not sure what to select, select everything). NOTE: It is recommended that you manually copy your list of users. 
  12. Click "Generate migration key"
  13. Go back to the VU instance and enter copied migration key into VU REDCap instance.
  14. Review and select "Create"
  15. Click "Create" again.
  16. Your project will be migrated in the background. Please give some time for this process to complete.
  17. If your project needs to be in "Production," make sure that you put it into "Production" on the VU instance. 
  18. Once you are positive that your data has migrated correctly, return to the VUMC instance and under the "Other Functionality" tab, click "Mark Project as Completed."