Open

Migration Pre-requisites

• Customer will be required to complete Jira migration from their Server/Data Center instance to Cloud instance prior to performing QTM4J Migration.

• Customer must migrate all Jira projects to the cloud so that migration should not get failed as QTM4J allows the linking of cross-project entities.

• The destination/target cloud Jira instance should not have any QTM4J data created on it.

Migration Process

Migration should be carried out as per the steps below on cloud staging instance first. Once it is verified successfully, the same should be performed on Production instance.

Step 1: Export Server 4.x Data to Secured QMetry Cloud

• Download and Install Postman for consuming the REST Endpoint to export the data of QMetry.

• Import the provided collection file (Export QMetry Data.postman_collection.json) in Postman.

Open

Once the collection is imported, you will find a POST API - ‘Export QMetry Data’.

Modify the place holders and click on the Send button to export the QMetry data as shown in the screenshot below.

You should get success response code 204 for successful API execution.

To check the status of the export process, you can use the ‘Get Export Progress’ request by updating the same details as shown in the screenshot above.

• Preparing the following zip files under the JIRA Home directory will take some time. (Generally, the path is: /var/atlassian/application-data/jira)

  • data.zip 

  • priority_icons.zip 

  • attachments-x.zip (x is the sequence number of the zip file. There can be multiple files) 

  • et_attachments-x.zip (x is the sequence number of the zip file. There can be multiple files)

• You may need to fetch export progress status multiple times, once you see “Completed” status in Get export progress API, collect and securely share the created files with QMetry team over secured link (will be provided by support team) to import that data on the Cloud staging and production instance.

Step 2: Import Data to QTM4J 4.x Cloud

Once Step 1 of exporting data to QTM4J Cloud is complete, execute the following steps mentioned on the Jira cloud instance and then inform the QMetry team.

Migration to Staging environment

• Uninstall QTM4J cloud add-on if already installed.

• Before performing further steps, please contact QTM4J Support team to get the private listing URL for installing QTM4J Cloud Staging instance.

• Once you get the URL, install QTM4J Cloud Staging add-on by following steps.

  • Apps > Manage your apps > Upload app > Enter given URL > Click Upload Button.

    • Note: If the Upload app option is not visible, then enable the development mode from the Settings option under the manage apps page.

      • Settings > select “Enable development mode” > click Apply

• Update Global permission for Browse User Permission (You can revoke the permission once the migration is completed).

  • Go to Jira Settings > System > Global permission (from the left panel).

  • In the Grant Permission section, provide values for Grant and Group.

    • Grant: Select “Browse users and groups” on the drop down.

    • Group: Set as “Public”.

  • Then click Add.

Migration to Production environment

Pre-requisites:

• There should be enough attachment storage space available on your cloud instance to migrate all these attachments. 

  • To check available storage space in cloud, go to Apps > Manager your apps > Attachment storage of QTM4J app.
    If there is no enough space, then you need to reach out to your QMetry Account Manager.

Steps:

• Install QTM4J Cloud production add-on directly from Atlassian marketplace.

• Update Global permission for Browse User Permission (You can revoke the permission once the migration is completed).

  • Go to Jira Settings > System > Global permission (from the left panel).

  • In the Grant Permission section, provide values for Grant and Group.

    • Grant: Select “Browse users and groups” on the drop down.

    • Group: Set as “Public”.

  • Then click Add.

Once the steps mentioned above are complete, inform QMetry Support on the ticket.

Next phase of migration process (Importing data to Cloud Staging/Production Jira Instance) will be taken care by QMetry Team. Once data is migrated successfully to cloud instance, QMetry team will inform you to verify end-to-end data on Staging/Production instance.