Browse documentation
Docs/Admin Toolkit/Post-migration cleanup

Post-migration cleanup

Remove the “(migrated)” names a Server-to-Cloud migration leaves behind.

The problem. A Server-to-Cloud migration renames anything that collides. Fields become “Impact (migrated)”. Roles become “Developers (migrated)”. It is a sensible thing for the migration tool to do, and a bad thing to keep. Two tools undo it.

Migrated Fields Cleaner

Choose the Cleanup ModeField Names, Field Descriptions or Field Configurations — then scan. The results table shows each field's ID, the configuration it belongs to, its current value and the cleaned value it will become.

You approve the exact rename before it happens. Nothing is renamed until you select rows and apply.

Admin Toolkit → Migrated Fields CleanerIllustration

Migrated Fields Cleaner

Scan for Migrated Fields

Remove “(migrated)” tags from field names, descriptions and configurations after migration.

Cleanup Mode
Field Names — remove migrated tags from custom field names
Field Descriptions — remove migrated tags from custom field descriptions
Field Configurations — remove migrated tags from descriptions inside field configurations
IDConfigurationCurrent ValueCleaned Value
customfield_11890Default Field ConfigurationAffected service (migrated)Affected service
customfield_11902ITSM Field ConfigurationImpact (migrated 2024-06)Impact
Clean up selectedShow Details

Migrated Project Roles Cleanup

The role equivalent, and it does more than rename. It removes the “migrated” suffix and moves the users and groups from the migrated role back into the original role.

That second half is the step people skip, which is why permissions stay split across two nearly identical roles for years.

  1. 1Choose where to look: permission schemes, projects, workflows, or projects and permission schemes together. A migrated role can be referenced in all three, and they are worth clearing in that order.
  2. 2Scan to find migrated roles and their members.
  3. 3Decide what happens to the migrated role itself: copy leaves it in place with its members, or move empties it of the actors it can prove came from the migration. Copy first if you are not certain.
  4. 4Review which members will move into which original role.
  5. 5Apply the cleanup to the roles you selected.
Note
If the scan or the cleanup could not cover everything in its budget, it says This scan did not finish or This cleanup did not finish and gives the numbers. A partial sweep is never reported as a complete one.
Merging roles changes who can do what
Moving members back into the original role changes their effective permissions. Confirm the two roles really are the same role. A migration that renamed a role for a genuine reason is an exception you want to keep.
Do this within weeks of the migration
Once people start creating new configuration that references the “(migrated)” objects, this stops being cosmetic and becomes a project.

Something missing or wrong on this page? Tell us in the support portal or email contact@synapseoasis.com.