What do I need to do about my upcoming Salesforce instance refresh?

Issue

I received an email from Salesforce about an "Instance Refresh". What do I need to do to ensure that Connect continues to operate?

Resolution

Pre-emptive Steps

There are a few steps you can take in advance of the refresh, depending on the configuration of your mappings:

Read-Only Mappings

If all of your mappings are read only, you don't need to do anything before the instance refresh.

Read-Write Mappings

Connect is designed to detect that Salesforce is in read-only mode and retry sending changes while Salesforce is unavailable. You may also wish to pause your connection from the Connect Dashboard just before the instance refresh starts. This will ensure that any data written to your database gets successfully synced to the correct instance.

Pre-authorizing with My Domain

Salesforce offers a feature called 'My Domain' that allows you to create a persistent hostname that won't change as the result of an instance refresh. Since Connect authorization is based on hostnames, you can configure My Domain for your Salesforce org and re-authenticate with that hostname any time before the instance refresh. Then you won't need to worry about re-authenticating immediately afterward or for any future instance refreshes. More information on 'My Domain' is available here.

More information about Instance Refresh and other Org Maintenance and Release topics can be found here.

After the Refresh is Complete

If you're not using a My Domain, you'll need to log in to your Connect Dashboard and re-authorize your connection in order for sync to resume.

If you are using a My Domain, you should not need to do anything following the instance refresh.

Ask on Stack Overflow

Engage with a community of passionate experts to get the answers you need

Ask on Stack Overflow

Heroku Support

Create a support ticket and our support experts will get back to you

Contact Heroku Support