4.4 Upgrading the Docker Deployment with an API

Secure API Manager provides an API that allows you upgrade each node in the cluster if you have Secure API Manager 2.1.1, SUSE Linux Enterprise Server 15 SP5, and Access Manager already installed.

  1. Perform a PUT request /agent/system/upgrade. Here is a sample of the body of the API call:

    {
    "name":"sapim-upgrade",
    "tag":"2.2.0"
    "namespace":"mfsecurity"
}

  2. Set Content-Type header to "application/json"

    IMPORTANT:The upgrade takes time and is not complete even if you receive the successful 200 OK as "text/plain". Give the upgrade time to complete before performing any additional tasks.

  3. To verify the upgrade, view the upgrade_tags.log located here:

    /var/opt/microfocus/sapim/upgrades/2.2.0

    A successful upgrade_tags.log contains the following entries:

    MILESTONE_DOCKER_UPGRADE_IMAGE_PULLED
MILESTONE_UPGRADE_INIT_SCRIPT_COMPLETE
MILESTONE_UPGRADE_SCRIPT_STARTED
MILESTONE_REMOVED_PREUPGRADE_OBJECTS
MILESTONE_INSTALLED_POSTUPGRADE_OBJECTS
MILESTONE_UPGRADE_SCRIPT_FINISHED

  4. Repeat the steps on each node in the cluster.

  5. (Conditional) If you import the Docker deployment, you must run an Update All in Access Manager on each Docker deployment that you imported.