How to migrate customers to the correct region after releasing data residency support

Hello,
We’re releasing Data Residency support for our apps imminently.
According to https://partners.atlassian.com/display/resources/Data+Residency+GA+Launch+-+Quick+Reference+Guide new Jira/Confluence customers will have access to the Data Residency feature within the host product from June 30th, and existing customers will have the feature turned on within the host product by Sept 30th.

  1. Am I correct in thinking that new customers who region-pin their instance before installing our apps will get the region-specific version of our apps installed?
  2. What happens to existing customers who were already region pinned before we released support for Data Residency in our app? At what point, if at all, will those Jira/Confluence instances start using the new region-specific domains specified in our app descriptor?
  3. Jira site imports are considered by Atlassian’s internal infra to be a new Jira with no prior knowledge of previous app installations. It’s my understanding that this may cause a situation where a site import triggers a region-specific version of an app to be installed, where previously a “global” installation had been in place, so app data may “go missing” from the customer’s perspective. What is Atlassian doing to help vendors mitigate this problem?

Thanks,
Jon

7 Likes

Hi Jon,

Thanks for the update. My feedback below to your questions:

  1. Am I correct in thinking that new customers who region-pin their instance before installing our apps will get the region-specific version of our apps installed?

Yes, that’s correct.

  1. What happens to existing customers who were already region pinned before we released support for Data Residency in our app? At what point, if at all, will those Jira/Confluence instances start using the new region-specific domains specified in our app descriptor?

An app reinstall is required for existing instances that want to use new region-specific domains specified in your app descriptor.

  1. Jira site imports are considered by Atlassian’s internal infra to be a new Jira with no prior knowledge of previous app installations. It’s my understanding that this may cause a situation where a site import triggers a region-specific version of an app to be installed, where previously a “global” installation had been in place, so app data may “go missing” from the customer’s perspective. What is Atlassian doing to help vendors mitigate this problem?

This is correct. We are currently assessing the best approach for handling various data lifecycle events including site imports. We will update you as we progress on this.

Thanks,
Sushant

2 Likes

Am I correct in understanding that the customer would need to uninstall and reinstall the app via the Manage Apps screen? And then the region specific URLs we define in the app descriptor will be used?

How is this different to us releasing updates to the descriptor, which trigger uninstall and reinstall lifecycle events? Am I correct in understanding that the app manager treats these two scenarios differently?

Hi @jbevan,

Yes, that’s correct.

Yes, it’s treated as a different scenario. For app version bumps (updated descriptor), there will be a ‘silent’ uninstall process without these lifecycle events sent out. Therefore, Connect will continue to use the existing installed region after an update, even if new regionBaseUrls have been added to the descriptor. However, once a ‘formal’ uninstall/reinstall is done, the relevant region specific URLs will apply.

2 Likes

Thanks.

We noticed one of our testing instances installed an app using the European baseUrl listed in our descriptor, however its not region pinned:

Is this because of

Customers who don’t have a data residency requirement, but are provisioned in the EU or US for performance reasons install into the nearest supported region. This may provide performance improvements for end users.

from https://developer.atlassian.com/cloud/jira/platform/data-residency/ ?

Hi Jon,

That’s correct. Even though an instance is not region pinned, install preference will be set depending on the region that the instance is hosted on at the time of install.

Thanks,
Sushant

1 Like