Migration from API Portal Legacy (Classic) 3.5 to API Developer Portal 5.0.2 fails with ERROR: Error POST Users SOMEUSER: Not Found

Products

• CA API Developer Portal

Issue/Introduction

When running the migration tool, no users are migrated. And the tool throws a migration error for all users.

The error is as follows  ERROR: Error POST Users ANYUSER: Not Found

This is due to the deprecated /Users APIs in 5.0.2

 

Resolution

1. Classic Portal 3.5 migration is only supported up to version Portal 5.0.2. 

- See: https://techdocs.broadcom.com/us/en/ca-enterprise-software/layer7-api-management/api-portal-legacy/3-5/migrate-to-enhanced-experience-api-portal.html

 

2. For version 5.0.2, there is an additional step to temporarily enable the deprecated & disabled endpoint /users, in order to allow the migration to "create" the users in 5.0.2. 

To re-enable the /Users API you will need to set a settings feature flag via PAPI.

 

 

The setting name is FEATURE_FLAG_ENABLE_DEPRECATED_API. Issue a PUT on the /Settings endpoint with the following payload:

 

{
  "Name": "FEATURE_FLAG_ENABLE_DEPRECATED_API",
  "Uuid": "{{GENERATED_UUID}}",
  "Value": "USERS_ENDPOINT_VERSION_4_5"
}

3. After the migration is completed and verified, disable the deprecated /Users API again. Issue a PUT on the /Settings endpoint with the following payload:
{

  "Name": "FEATURE_FLAG_ENABLE_DEPRECATED_API",
  "Uuid": "{{GENERATED_UUID}}",
  "Value": ""
}