Upgrading WSO2 IS as Key Manager to 5.9.0

The following information describes how to upgrade your WSO2 API Manager (WSO2 API-M) environment from APIM 1.8.0/1.9.0/1.9.1 when WSO2 Identity Server (WSO2 IS) is the Key Manager.


You can download the pre-packaged WSO2 Identity Server 5.9.0, which is also known as Identity Server as the Key Manager 5.9.0 from here. Make sure you are using the latest WUM updated pack.


  • You can use the following steps in either one of the following situations:

    • You are currently using a WSO2 IS 5.0.0 vanilla distribution that has WSO2 API Management related Key Manager features installed on top of it.
    • You are currently using a pre-packaged WSO2 Identity Server 5.0.0 distribution.
  • If you wish to upgrade your APIM environment from API-M 1.8.0/1.9.0/1.9.1 to 3.0.0, which is using the internal WSO2 Identity Server (WSO2 IS) capabilities, follow the instructions in Upgrading API Manager from 1.8.0/1.9.0/1.9.1 to 3.0.0.

Follow the instructions below to upgrade WSO2 API-M from WSO2 API-M 2.1.0 to 3.0.0 when using WSO2 IS as the Key Manager:

  1. Migrate the WSO2 Identity Server (WSO2 IS) from version 5.0.0 to 5.9.0. Migrate the WSO2 Identity Server (WSO2 IS) from version 5.0.0 to 5.9.0 as described in the WSO2 Identity Server 5.9.0 documentation.

  2. Migrate WSO2 API-M from 1.8.0/1.9.0/1.9.1 to 2.6.0.