WSO2 IS 5.10.0迁移至6.0.0遇admin角色已存在错误如何解决？

错误根源 #

迁移过程中，GroupsAndRolesMigrator组件在迁移超级租户数据时尝试创建admin角色，但该角色已存在于你的MySQL主用户存储中，触发角色重复异常（错误码30012），导致迁移终止。

解决步骤 #

• 停止WSO2 IS 6.0.0服务：暂停当前迁移进程，避免异常扩散。
• 验证admin角色存在性：
  连接到MySQL主用户存储数据库，执行以下SQL查询确认admin角色：

  SELECT UM_ROLE_NAME FROM UM_ROLE WHERE UM_ROLE_NAME = 'admin';
  

  若返回结果，说明角色确实已存在。
• 修改迁移配置跳过admin角色创建：
  打开repository/conf/migration.yaml文件，在v5110版本的迁移配置中添加跳过角色参数：

  migrations:
    - version: v5110
      migratorClass: org.wso2.carbon.is.migration.service.v5110.migrator.GroupsAndRolesMigrator
      parameters:
        skipRoles:
          - admin
  

  保存配置后关闭文件。
• 同步admin角色权限（可选）：
  若需要将5.10.0中admin角色的权限同步到6.0.0，从旧版本数据库导出权限：

  SELECT UM_PERMISSION_NAME 
  FROM UM_ROLE_PERMISSION 
  INNER JOIN UM_PERMISSION ON UM_ROLE_PERMISSION.UM_PERMISSION_ID = UM_PERMISSION.UM_ID 
  WHERE UM_ROLE_ID = (SELECT UM_ID FROM UM_ROLE WHERE UM_ROLE_NAME = 'admin');
  

  将导出的权限手动插入到6.0.0数据库的对应权限表中，确保权限一致。
• 重启WSO2 IS 6.0.0服务：
  启动服务后，迁移客户端会跳过admin角色的创建，继续完成剩余迁移任务。

内容的提问来源于stack exchange，提问作者Nipuna Upeksha