Page Comparison

We integrate with CCMA

(Confluence Cloud Migration Assistant) to render the migration as painless as possible.

Before migrating

You need to:

• Update CCMA

• to the latest version

  • https://marketplace.atlassian.com/apps/1219672/confluence-cloud-migration-assistant?hosting=datacenter&tab=overview

• Update requirement yogi to version >

• 3.15 ⚠️

  • https://marketplace.atlassian.com/apps/1212523/requirements-yogi?hosting=server&tab=versions

• Install Requirement Yogi on the cloud.

  • https://marketplace.atlassian.com/apps/1212523/requirements-yogi?hosting=cloud&tab=overview

• Verify that the requirement yogi page can view and create pages in your spaces.

In Confluence > Settings > Security > Global Permissions:

• Requirement Yogi Core (Spring Boot) should be added in a user group in the User groups tab

• Requirement Yogi Core (Spring Boot) should be listed in the Apps tab

In Confluence > Settings > Security > Global Permissions

• The user group assigned to Requirement Yogi should be listed in the Default Space Permissions, with permissions to view and add Pages (Confluence doesn’t distinguish between add and edit permissions).

• Individual spaces where you want to use Requirement Yogi should not override the default space permissions for the RY user group.

NB: We only need to edit pages during the migration. Once the migration is over, you can remove the add pages permission for the app. Requirement Yogi uses the user’s permissions to transform the pages in the Transformation Wizard.

• Open the migration endpoint:

In the Requirement Yogi configuration, in the Support tab, you should open up the migration endpoint. This enables requirement yogi to receive notifications from the server migration assistant. You can close it once the migration is over.

Differences between Cloud and Server

• Data is stored in the cloud (

• https://requirementyogi.atlassian.net/wiki/spaces/RYC/pages/1804763557/Privacy+Policy#How-we-host-and-transfer-data-internationally ).

• You don’t have access to a rest

• API, or the database, or server logs.

• There is no report macro embeddable in documents.

• There is no baselines (replaced by variants in the cloud : Variants ).

• You cannot display the requirement's details in a popup when hovering over a requirement in Confluence.

• We cannot highlight a requirement in a page, or scroll down the page to show the requirement.

• The cloud editor seems to struggle with tables of over 100 requirements. We advise splitting your documents in multiple pages if that is the case for you. ⚠️

• You can quickly edit pages, and generate requirements using the Page transformations

• You can create and validate rules for your requirements (Validation rules )

• Configuring requirement properties is done through the Requirement Yogi Configuration macro (Configuring requirement properties )

• Our server is shared between customers, and we apply limits to some operations (like the traceability matrix) to avoid impacting the app performance for other customers.

Starting the migration

In Confluence server, under General Configuration > Migration Assistant

• Mark Requirement Yogi as “Needed in cloud” (App assessment approval by Atlassian pending)

  Image Added

• Proceed to the rest of the migration steps required by Atlassian.

• Wait for the migration to complete.

  Image Added

App migration can take a long time to run, especially if you have thousands of pages.

You can check the migration notifications in the cloud by:

• Clicking on the link in the app migration details,

• In the cloud, in Requirement Yogi configuration:

  • By clicking the link in the support tab

  • By going in the queue tab and clicking on the migration job

Image Added

Errors and warnings are listed on the notification page (Admin access required). Errors on pages have a link to the page that generated an error. You can go to the page and verify that the migration worked as planned, or manually edit the page yourself and mark the notification as “Resolved”

Please do feel free to open a ticket to notify us of errors generated by the migration tool by raising a support ticket (https://requirementyogi.atlassian.net/servicedesk/customer/portal/1/group/1/create/9 )

Troubleshooting

My app doesn’t process any pages?

Verify that the app user has view and edit permissions on the page. (Permission settings are handled by Atlassian)

The migration of requirement macros to the cloud format involves searching for pages containing requirement macros. Unfortunately, the search sometimes returns incomplete results and mistakenly assumes that no more pages need to be migrated. In that case, you can run the migration job again by clicking the “Retry” button in the Queue tab.

Image Added

You can also manually run the transformation wizard (Page transformations ) to transform server macros to cloud macros

.