Migrating from Cloud to another Cloud instance

Below are instructions on how to migrate AssertThat BDD, Cucumber & Test Management plugin from Jira Cloud to another cloud instance

\uD83D\uDCD8 Migration instructions

Prerequisites:

Install https://marketplace.atlassian.com/apps/1219033/assertthat-bdd-cucumber-for-jira?tab=overview&hosting=datacenter plugin on your target Jira Cloud instance
Enable AssertThat BDD & Cucumber for Jira plugin for the projects that you are going to migrate on the Cloud instance. AssertThat Configuration & Enable for project
Download and install Python on the instance you are going to use for running migration scripts https://www.python.org/downloads/

Migration steps

Clone repository https://bitbucket.org/AssertThat/assertthat-bdd-cloud-to-cloud-migration/src/main/
Install dependencies. Run
pip install -r requirements.txt
Update global configuration in ./config/global.json\
```
{
  "source_jira_cloud_url": "https://mycompany.atlassian.net",
  "source_jira_cloud_username": "user-admin@example.com",
  "source_jira_cloud_api_token": "",
  "source_default_assertthat_access_key": "",
  "source_default_assertthat_secret_key": "",
  "source_assertthat_host": "https://bdd.assertthat.app", //do not change
  "target_jira_cloud_url": "https://assertthat-dev.atlassian.net",
  "target_jira_cloud_username": "user-admin@example.com",
  "target_jira_cloud_api_token": "",
  "target_assertthat_host": "https://bdd.assertthat.app" //do not change
}
```
source_jira_cloud_url - The URL of the cloud Jira instance where the projects are being migrated from e.g. https://mycompany.atlassian.net
source_jira_cloud_username - The email address of the Jira Cloud user which has Browse users and groups global permission. More details here https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-users/#api-rest-api-3-users-search-get
source_jira_cloud_api_token - API token of the Jira cloud user used in source_jira_cloud_username https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/
source_default_assertthat_access_key - pick one project where the AssertThat plugin is enabled on the Cloud instance and get the access key from the plugin configuration page AssertThat Configuration & Enable for project
source_default_assertthat_secret_key - pick one project where AssertThat plugin is enabled on Cloud instance and get the secret key from the plugin configuration page AssertThat Configuration & Enable for project
source_asserttthat_host - Leave as default set to https://bdd.assertthat.app
target_jira_cloud_url - The URL of the cloud Jira instance where the projects are being migrated to e.g. https://mycompany.atlassian.net
target_jira_cloud_username - The email address of the Jira Cloud user which has Browse users and groups global permission. More details here https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-users/#api-rest-api-3-users-search-get
target_jira_cloud_api_token - API token of the Jira cloud user used in target_jira_cloud_username https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/
target_asserttthat_host - Leave as default set to https://bdd.assertthat.app
Run ‘get-projects.py’ script, which will create a file listing the cloud projects for migration ./output/source-projects.json\
```
python get-projects.py
```
Explore the ./output/source-projects.json and remove projects that are out of scope of the migration.
For each project in ./output/source-projects.json fill in the corresponding Jira Cloud source project details source_assertthat_access_key, source_assertthat_secret_key, and Jira Cloud target project details - source_assertthat_access_key, source_assertthat_secret_key, target_jira_project_id which can be found on the project configuration page in Jira Cloud AssertThat Configuration & Enable for project
Run ‘migrate-config.py’ which will migrate project configurations from source to target Jira Cloud\
```
python migrate-config.py
```
Run ‘migrate-features.py’ which will migrate the features\
```
python migrate-features.py
```
Run ‘migrate-executions.py’ which will migrate manual execution results for each of the Scenarios that are linked to Jira story.\
```
python migrate-executions.py
```
Run Re-indexing https://assertthat.atlassian.net/wiki/spaces/ABTM/pages/2192211987/Using+AssertThat+scenario+properties+in+JQL+search#Reindexing

In case of any issues or questions please reach us at support@assertthat.com