Rate this page:
The 'Migrate all data at once' feature is available for the Jira Cloud Migration Assistant (JCMA) version 1.9.0 and higher, for customers who want to migrate core product data and app data.
This feature may also be referred to as 'Bulk migration'.
Compared to the original Project-by-Project migration method of JCMA, the 'Migrate all data at once' feature of bulk migration:
The higher migration speed of this feature is made possible by using a direct import method on the cloud site, and makes larger migrations more viable for customers by considerably reducing the downtime required for migration.
A key focus of this feature has been to ensure compatibility with our Marketplace Partner’s existing investments into building automated migration paths for JCMA. As a result, we have designed the 'Migrate all data at once' feature to work in a way that's broadly transparent to your existing migration path.
This means that Marketplace Partners can use the same migration paths for 'Migrate all data at once' migrations, as was used by the original the Project-by-Project migration method.
The 'Migrate all data at once' feature cannot migrate data to a cloud site incrementally. This means that this feature needs to start with an empty cloud site, and its first action is to clear the destination site of all data and prepare it as a new site that's ready for import.
Functionally, a bulk migration using the 'Migrate all data at once' feature follows the same structure and has the same resources available to Marketplace Partners, as exists with the original Project-by-Project migration method.
/container/{transferId}/page
endpoint (API Reference)listener-triggered
webhook event which indicates the start of a transfer will be sent as normal./mapping/{transferId}/page
and /mapping/{transferId}/find
API endpoints
will be available as
normal (API reference). See
the complete list of supported mappings here/transfer/recent
as
normal (API reference)Triggering an 'Migrate all data at once' bulk migration can only be done to an empty cloud site, and the content is considered a replacement for any site that existed at that path in the past. As a result:
As the 'Migrate all data at once' bulk migration requires a blank site, all Marketplace partner apps will have to be re-installed as part of the migration process. This will happen as part of a migration stage before a Marketplace Ppartner’s app is notified of a new transfer.
It is important to note that you will not receive an uninstallation event as part of this process.
Your app should also be ready to handle multiple installation events via Atlassian’s Connect framework. Also, the license for your app will remain untouched.
Read more about why this is treated as a new install
As the bulk migration of the 'Migrate all data at once' feature requires a blank site, it can only support the initial migration a customer performs.
Customers can also:
The 'Site Import' feature uses the same direct import process as the 'Migrate all data at once' feature. However, some of the limitations of Site Import are that it:
As with Site Import, the 'Migrate all data at once' feature cannot migrate to a cloud site if it already contains data.
The following are currently not supported using the 'Migrate all data at once' feature:
This includes their associated mappings.
Atlassian is working on supporting the above features in future releases, without any requirement for change from Marketplace Partners.
Until support is available, customers will be notified using a pre-migration check in JCMA that they cannot use the 'Migrate all data at once' method to migrate apps that need either of these two features.
Currently, bulk migrations will carry over the server ID for nearly all entity types. However, this is not a contractual attribute and is subject to change in the future based on other requirements.
We expect customers in the short term to be able to use Site Import tooling where it already exists, rather than the JCMA path. However this will cease to be possible in the future, and it is recommended that all Marektplace Partners prepare their automated migration paths to ensure that it works with this new 'Migrate all data at one' bulk migration method.
Read more about how to run a 'Migrate all data at once' bulk migration with app support
Check out cloud migration methods for more information about different cloud migration methods supported by Atlassian or visit our support page.
Rate this page: