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.
Find all group names which caused conflict during upgrade
grep WARN [FISHEYE_INST]/var/log/atlassian-fisheye-upgrade-db-*.log | grep merged
結果の例:
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}.
Review all repository permissions for groups for group-a
Review all permission scheme actions configuration for groups for group-a
Review all project default reviewers groups for group-a
Review all project allowed review participant groups for group-a
Review all administrators groups for group-a