Print this page

How to Prepare for a Sandbox Migration

Knowledge Article Number 000230941
Description

Last Updated in English on May 5, 2016.

In order to provide exceptional performance, availability, and reliability of our service, we occasionally need to perform a capacity planning activity, called a sandbox migration, where we move all customers on an existing Salesforce sandbox in one data center to another data center. The sandbox name remains the same. This takes place during your standard system maintenance window.


NOTE: This document is for informational purposes only, and is not part of any legal or otherwise binding agreement. The policies and practices described in this document are subject to change at Salesforce's sole discretion.
Resolution

General FAQs
 

  1. Why do you perform a sandbox migration and how will this benefit me?

    1. Due to the extraordinary growth and success of our customers, we occasionally need to perform a sandbox migration, where we move all customers on an existing Salesforce sandbox from one data center to another data center. Moving an entire sandbox from one data center to another data center enables us to continue to maintain the high level of performance our customers have come to expect from Salesforce.

 
  1. What action do I need to take for the sandbox migration maintenance?

    1. Complete a refresh of your sandbox at least 4 hours prior to the start of the migration maintenance window. Please note that the time it takes to complete a sandbox refresh varies based on your environment. Refreshing your sandbox will move you to another sandbox in a new data center where you will not be affected by this scheduled sandbox migration maintenance on your current sandbox instance. For more information on how to refresh your sandbox, see the Create or Refresh a Sandbox article.

      1. If you refresh your sandbox during the preview window of a major release, depending on the location of your production instance, your sandbox may be placed on a non-preview instance. Information on each major release preview window can be found in the major release sandbox preview instructions posted to the Salesforce blog.

      2. If you choose to refresh your sandbox, your custom configurations will need to be exported prior to refreshing your sandbox and rebuilt. You may do so by exporting those changes via Metadata API or deploying them to production or to another sandbox. For more information on Metadata API, review the Salesforce1 Platform API Services Guide.
         

  2. What actions are required if I do not refresh my sandbox?

    1. If you do not refresh your current sandbox, you will experience the sandbox migration and the downtime window associated with the maintenance. In order to avoid any unintended service disruptions, ensure that you:

      1. Are aware of your scheduled maintenance window and plan your organization’s activities accordingly.

      2. Allow access to Salesforce IPs. More information on which IP ranges to include can be found in the What are the Salesforce IP Addresses to whitelist? article.

      3. Additional details regarding our infrastructure best practices are outlined on the Salesforce Infrastructure Overview & Best Practices site

 

  1. How do I refresh my sandbox to avoid the downtime?

    1. Please follow the instructions outlined in the Create or Refresh a Sandbox article.

 

  1. If I have built custom configurations in my sandbox, will they be preserved with the sandbox migration, or do I need to rebuild them?

    1. If you choose to refresh your sandbox, rather than undergo the sandbox migration, your custom configurations will need to be exported prior to refreshing your sandbox and rebuilt. You may do so by exporting those changes via the Metadata API or deploying them to production or to another sandbox. For more information on Metadata API, review the Salesforce1 Platform API Services Guide.

    2. If you choose not to refresh your sandbox, the custom configurations you have built will be preserved with the sandbox migration maintenance.

 

  1. What happens if my sandbox was in the middle of a refresh when the sandbox migration maintenance began?

    1. If you were in the middle of a sandbox refresh when the sandbox migration maintenance began, the sandbox refresh will stop and not complete prior to the migration. Your sandbox will experience the sandbox migration maintenance. The refresh will automatically be restarted (not resumed), in the new data center, approximately 24 hours after the migration is complete.

 

  1. Do I need to restart integrations after the maintenance?

    1. Restarting your integrations is not required, but if you experience any issues with your integrations following the sandbox migration maintenance, we recommend that you restart them as your first step in troubleshooting the resolution.

      1. By restarting your integrations following the maintenance window, you will be clearing the DNS lookup cache which allows your integrations to detect the IP address of the new data center.

 

  1. Where can I go if I have further questions?

    1. For additional questions, you can open a case with Customer Support via the Help & Training portal.





promote demote