Overview of Atlassian Data Center instance consolidation
When migrating your application to Data Center, you may choose to consolidate multiple application instances into a single Data Center deployment. Separate application instances may exist due to company acquisitions, or because individual teams within your company set up their own Atlassian applications. Consolidating instances onto a single Data Center deployment can help streamline management and operation of your Atlassian applications. This document provides a high-level overview of the consolidation process.
The Data Center migration plan outlines the overall process of migrating your Server application to Data Center. You will need to build a team, review current application status and settings, test the installation, and communicate updates. Additionally, consolidation requires that you standardize your application setup and merge instances by migrating application data from each source instance to a single destination instance. You should expect these tasks to increase your migration timeframe.
Based on how you decide to standardize and merge your instances, the consolidation process may affect the user experience, accessibility, and data for your users. It's important that you communicate all expected differences throughout the process, and provide your end users with any documentation and education they may need regarding these changes.
Standardize application setup
When reviewing all your current Server application instances, you will need to review their setup, such as custom fields, workflows, add-ons, customizations, etc. Stakeholders will need to review these against the needs of all your users, and decide which of these to include in the consolidated Data Center application. For example, one of the application instances may have a workflow used by a handful of people to track blog posts, and you may decide that it isn't necessary to implement across the entire organization. For any add-ons moved to the Data Center application, it's important to upgrade their licenses to match the license tier of Data Center that you are using. Additionally, it's important to review, modify, and communicate any changes in user permissions and privileges. For example, administrators of the individual application instances may not remain as administrators of the Data Center application.
After determining the application setup for the consolidated Data Center application, you will need to merge the different instances into a single destination instance, which is the first node of the Data Center cluster. Merging instances migrates all desired projects, spaces, etc., from a source instance of the application to a destination instance without destroying the configuration and data of the destination instance. Before starting the process, build a timeline for merging each instance one at a time, and communicate that schedule to your users, including any possible downtime your users may experience. The following steps provide a high-level guide for merging each instance:
You can also use a third party tool to migrate data when merging instances. For more information, see Migrating data with 3rd Party add-ons.
- Perform a backup the destination instance.
- Upgrade the source instance to the application version installed on the destination instance.
- Ensure that the application settings (i.e. language, locale) are the same across the source and destination instances.
- Ensure that any add-ons from the source instance ,which you intend to keep using on Data Center, are installed on the destination instance with the same version.
- Review and resolve users across the application instances.
- Remove stale users, as every active user migrated adds to your overall license count.
- Create unique usernames on the destination instance for any people who have conflicting usernames (two different people with the same username) on existing instances.
- Review and resolve the names of globally available configuration objects (i.e. projects, spaces, workflows, etc.) across the source and destination instances.
- For any objects with the same name, check if the names mean the same thing in both instances.
- If they mean different things, rename the object on one of the instances.
- Export data from the source instance. The following links are guides for exporting data for each application:
- Backing up JIRA data
Currently, Bitbucket does not offer the ability to export certain metadata, such as pull requests and comments that are related to projects and repositories. If you need to consolidate your Bitbucket instances into Data Center, we can recommend Enterprise Partners who have successfully done this for our customers.
- Import data into a development/staging environment that replicates the production environment of the destination instance. The following links are guides for importing data for each application:
- Perform user acceptance testing, and verify that the migration worked correctly.
After consolidating all instances, follow the rest of the process as outlined in the Data Center migration plan.
We're here to help
An Atlassian Technical Account Manager (TAM) provides strategic guidance for customers interested in consolidating their instances into Data Center. The TAM collaborates with the customer to develop best practices for configuring, deploying, and running a Data Center application a way that aligns with the organization's operations and long-term goals.
Atlassian Enterprise Partners are a valuable resource in working directly with our customers to consolidate application instances into a single Data Center deployment.