Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Excerpt

If starting with a clean installation, there is nothing to do.

-include
INSTALLATION:API Management Migration Notes 7.5.0 ->

API Management

7.6.0

comes with the new Developer Portal. If updating an installation of API Management, follow the steps listed on Updating API Management and pay attention to the following changes:

During the Update Process

The Docker settings file .env has changed:

NewTo DoDEV_PORTAL_PORTAdd this new setting from the .env file that has been shipped with the installation files to your .env file.

For more information on this setting, refer to Installing API Management > Step 2: Configure the Installation Settings.

After Having Applied the Update

You need to add new configurations to Keycloak.

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNameopen_keycloak
PageWithExcerptINTERNAL:_installation_excerpts

You need to add the new client devportal to your Keykcloak.
This can be done by importing the Keycloak settings file that has been shipped with the installation files. This file is located here: api-mgmt-<VERSION>.zip/api-mgmt/configs/bootstrap/keycloak-default-realm.json.

Select Import from the menu of the Apiman realm, and select the above mentioned file for import.

Image Removed

Select option Skip for what to do if a resource to import already exists in the target system.

Note
If you do not select skip, the import will not only add new resources but overwrite the definitions in your Keycloak instance.

Image Removed

After a successful import, a log is displayed that lists the added elements.
  • Configure the devportal client in Keycloak as described on Installing API Management > Step 4: Configure the Authentication Service (Keycloak).
  • Verify that the existing admin user has role setting view-profile.
    1. Select Users from the menu of the Apiman realm.
    2. Click View all users.
    3. Click Edit on the admin user.
    4. Switch to tab Role Mappings.
    5. Select account from drop-down box Client Roles.
    6. If the admin user has no view-profile role assigned, select this role and add it to the list of Assigned Roles.

      Image Removed

  • INSTALLATION:API Management Migration Notes 7.5.0 -> 7.6.0
    nopaneltrue


    padding-top:0.5em;

    Panel
    titleRelated Pages:
    Rp
    Div
    Style
    Children Display
    pageAPI Management
    sorttitle
    reversetrue