Page Comparison

Below are instructions on how to migrate AssertThat BDD & Cucumber for Jira , Cucumber & Test Management plugin from Jira Cloud to Jira Server or Data Center

Differences between Server/DC and Cloud versions of the app

\uD83D\uDCD8 Migration instructions

...

1. Install https://marketplace.atlassian.com/apps/1219033/assertthat-bdd-cucumber-for-jira?tab=overview&hosting=datacenter plugin on your Jira Server or DC instance

2. Enable AssertThat BDD & Cucumber for Jira plugin for the projects which that you are going to migrate on the Cloud instance. Enable & configure AssertThat Plugin AssertThat Configuration & Enable for project (optional)

3. Download and install Python on the instance you are going to use for running migration scripts https://www.python.org/downloads/

...

1. Clone repository https://bitbucket.org/AssertThat/assertthat-bdd-server-migration/src/master/

2. Install dependencies. Run
   pip install -r requirements.txt

3. Update global configuration in ./config/global.json
   

   Code Block
   language json
   { "jira_server_url": "https://mycompany-jira.com", "jira_server_username": "username", "jira_server_password": "password", "jira_cloud_url": "https://mycompany.atlassian.net", "jira_cloud_username": "user@example.com", "jira_cloud_api_token": "", "default_assertthat_access_key": "", "default_assertthat_secret_key": "", "assertthat_host": "https://bdd.assertthat.app" }

   jira_server_url - The url of your Jira server or Data Center instance e.g https://jira.mycompany.com

   jira_server_username - The username of the Jira Server/DC user with admin access to the projects.
   jira_server_password - The password of the Jira Server/DC user with admin access to the projects.
   jira_cloud_url - The URL of the cloud Jira instance where the projects are being migrated from e.g. https://mycompany.atlassian.net
   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
   jira_cloud_api_token - API token of the Jira cloud user used in jira_cloud_username https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/
   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 Enable & configure AssertThat Plugin AssertThat Configuration & Enable for project
   default_assertthat_secret_key - pick one project where the AssertThat plugin is enabled on Cloud instance and get the secret key from the plugin configuration page Enable & configure AssertThat Plugin AssertThat Configuration & Enable for project
   asserttthat_host - Leave as the default set to https://bdd.assertthat.app

4. Run ‘get-cloud-projects.py' script, which will create a file listing the cloud projects for migration ./output/cloud-projects.json
   

   Code Block
   language py
   python get-cloud-projects.py

5. Explore the ./output/cloud-projects.json and exclude projects which that are out of scope of the migration.

6. For each project in ./output/cloud-projects.json fill in the corresponding Jira Cloud project details assertthat_access_key, assertthat_secret_key, and Jira Server DC derails - jira_server_project_id, which can be found on the project configuration page in Jira Cloud Enable & configure AssertThat Plugin AssertThat Configuration & Enable for project

7. Run 'migrate-config.py' which will migrate projects project configurations from Jira Cloud to Server/DC
   

   Code Block
   language py
   python migrate-config.py

8. Run 'migrate-features.py' which will migrate the features from Jira Cloud to Server/DC
   

   Code Block
   language py
   python migrate-features.py

9. Run 'migrate-executions.py' which will migrate manual execution results for each of the Scenarios which that are linked to Jira story.
   

   Code Block
   language py
   python migrate-executions.py

10. Run Re-indexing https://assertthat.atlassian.net/wiki/spaces/ABTMATDC/pages/21922119872334526644/Using+AssertThat+scenario+properties+in+JQL+search#Reindexing

...