API Management versions 7.5.X and 7.6.X have reached end of support in November 2020.
Check out the latest version of the documentation.

Resolve upgrade issues in Policy Studio

Policy Studio provides graphical features to help you detect and analyze upgrade issues. You can use the Tools > Upgrade Log Analysis option to analyze an upgrade.log file. You can also use the tool to analyze upgrade issues when creating a new project from existing configuration, or when importing a configuration fragment. For more information, see Upgrade log analysis in the API Gateway Policy Developer Guide.

You can also use Policy Studio to resolve configuration issues. If the upgrade process identifies issues with the configuration in your old installation, you can use Policy Studio to resolve the issues. There are two ways of doing this:

  1. Resolve the issues in the upgraded configuration during the upgrade, and deploy the updated configuration to the new installation when the upgrade completes. See Resolve issues during upgrade.
  2. Resolve the issues in the upgraded configuration after the upgrade completes, and deploy the changes. See Resolve issues after upgrade.

Resolve issues during upgrade

During the upgrade, if the upgrade command identifies configuration issues that must be resolved in Policy Studio, open the problematic configuration in Policy Studio. For example, in Policy Studio version 7.5.3, create a new project using From .fed file or From .pol and .env files, and select the correct files under the following directory:


Modify the problematic configuration in Policy Studio, and save the project for deployment after sysupgrade completes.

Tip   If Policy Studio is not installed on the node that has the problematic configuration, copy the directory to a machine where Policy Studio is installed, and edit it there.

Resolve issues after upgrade

Alternatively, you can choose to complete the upgrade first and then resolve the configuration issues in Policy Studio. In this case, load the configuration from the running API Gateway after the upgrade completes. For example:

  1. In Policy Studio version 7.5.3, click New Project from an API Gateway instance.
  2. Select the API Gateway group that has the problematic configuration.
  3. Make changes to the configuration in Policy Studio, and deploy them.
  4. Repeat this process for each API Gateway group in the topology that the upgrade step identified as problematic.
Note   You must take care to deploy the correct API Gateway project to the correct API Gateway group.

Related Links