As part of the strategy to upgrade from an older to a newer version of apiman, we'll need a way to update the JSON format of the export file. Whenever we make a data model change to apiman, this upgrade/migration tool will need to modify the JSON file to upgrade it from version X to version Y. For example, if we change the Gateway to rename one of its fields (say we rename the 'description' field to 'moreInfo' for some reason) then this tool will need to rename all those fields in the export JSON file. The result should be that, after running the JSON export file through this tool, the output will be a new JSON file in a format suitable to import into apiman version Y.

We also need a way to manipulate and/or filter the JSON file to make it easier to migrate from e.g. a Test to a Prod environment. This can include things like:

• Filtering out test data (orgs, apis, etc)
• Modifying server URLs (back-end endpoints, gateway URL, LDAP info, etc)
• Modifying credentials (jdbc creds, ldap creds, etc)