Currently it is not possible to automatically migrate Agile Hive data without assistance from our team. Please contact us via the Service Desk.
Introduction
For the purpose of migration it is necessary for us to make use of an external service because Atlassian currently does not currently () offer a direct migration path from the on premise version of Agile Hive to the Forge version running on Jira Cloud (for more information please refer to Migrate to Cloud).
To migrate the data we need to first transfer the data to the AHCMH (Agile Hive Cloud Migration Helper) app which is running on Atlassian Connect. The AHCMH app transforms the data into the format required by the Agile Hive Cloud Forge app and writes the data to the target Jira Cloud instance.
Obtaining the Agile Hive Cloud Migration Helper app
AHCMH is available free of charge on request via our Service Desk. Simply raise a new request of type ‘Cloud Migration Agile Hive’ and briefly describe your migration project:
Company: Name of your company (for partners: Company that plans to migrate)
Cloud Site: URL of the target Cloud site you’re migrating to
User: Current Jira Server / DC user tier & Cloud user tier
Migration Type: Sandbox or production?
We’ll then provide you with a customized installation link that can be used to install AHCMH in your Cloud target site.
Installation
To install the Agile Hive Cloud Migration Helper app in your Jira site, a Jira Administrator needs to navigate to ‘Manage apps’ in the ‘Apps’ section of Jira Administration. Then, scroll to the bottom of the list of installed apps and click on ‘Settings’. In the modal window, activate the checkbox for ‘Enable private listings’.
Then, refresh the page in your browser by performing a reload. After the page has reloaded, click the new button ‘Upload app’ right next to ‘Build a new app’ in the table header.
In the modal window, enter the URL you received from the Agile Hive team. Then click ‘Upload’ to install the AHCMH app.
Information on processing of data
Here are the most important points in regards to what data is used in what way and which data is stored persistently on an external database:
No customer generated data is persistently stored on the external database
we only persistently store the transaction-IDs that Atlassian attaches to migration requests
this is necessary to handle possible duplicate requests and cancellation requests
the transaction-ID for a migration is deleted once the migration has successfully completed
Customer generated data is non-persistently stored on external services only for the duration of the migration
issue data is loaded via a JQL query to specifically identify issues which have a Agile Hive hierarchy issue-link
this data is only non-persistently stored in RAM
this is necessary for the AHCMH app to transform the data from the on premise format to the Forge format and store it in the target Jira Cloud instance
this data is only ever accessed when migration requests from the Atlassian Migration Platform are sent to the ACHMH App
Some meta data is persistently logged for troubleshooting
total number of issues to migrate
number of issues migrated
error information from requests to the Jira Cloud instance
this data allows us to identify the scope and possible cause of issues that occurred during migration
this data is only accessed for error analysis and performance analysis
Link to this page: https://seibert.biz/ahc-migrationdocumentation