FishEye 4.0 group name normalization

Upgrade version

This document assumes that you are upgrading FishEye & Crucible to version 4.1.2 or higher.  Switch to FishEye 4.1.1 group name normalization for FishEye & Crucible 4.1.0 and 4.1.1.

Group name normalization

Up to FishEye and Crucible 3.10 group names were case sensitive. With version 4.0 and the new user directories management functionality, group names are required to be unique after lowercasing. 

E.g. if in version prior to 4.0 there were 3 groups defined:

  • group-A
  • Group-A
  • grouP-A

The 4.1.2 upgrade task should resolve conflicting group names by merging those groups. After the upgrade the following groups will be configured:

  • group-a 

The upgrade task will merge all group related configuration including:

  • Internal directory groups
  • Repository permissions for groups
  • Permission scheme actions configuration for groups
  • Project default reviewers groups
  • Project allowed review participant groups
  • Administrators groups
  • Crowd/JIRA groups to synchronise

Reviewing merged groups

All groups for which there was a name conflict during the upgrade should be reviewed.

  1. Find all group names which caused conflict during upgrade

    grep WARN [FISHEYE_INST]/var/log/atlassian-fisheye-upgrade-db-*.log | grep merged

    Example result:

    WARN Group (2, Group-A) is not unique with group-A and will be merged to MigratedGroupsData{name=group-A, groupId=1, directoryId=1}.
    WARN Group (3, grouP-A) is not unique with group-A and will be merged to MigratedGroupsData{name=group-A, groupId=1, directoryId=1}.
  2. Review all repository permissions for groups for group-a

  3. Review all permission scheme actions configuration for groups for group-a

  4. Review all project default reviewers groups for group-a

  5. Review all project allowed review participant groups for group-a

  6. Review all administrators groups for group-a

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport