Upgrade docker swarm portal from 5.2.2.1 to 5.3.1.1

Products

• CA API Developer Portal

Issue/Introduction

Looking for the steps to upgrade portal platform and portal application from 5.2.2.1 Debian platform to 5.3.1.1

Environment

Portal 5.2.x 5.3.x

Resolution

Portal application two step upgrade including platform update Debian 11 to Debian 12

1. Upgrading to Portal 5.2.3: Upgrade paths from 5.2.2 Debian 11
2. Upgrading to Portal 5.3.3.1: Upgrade paths 5.2.3 are supported

Update the platform  check /opt/SecureSpan/PatchManagement/var/patches

Download 

Update to latest platform for Debian 11:

Layer7_API_PortalPlatformUpdate_64bit_v11.X-Debian-2024-03-11.zip

Shut down portal

$ sudo docker stack rm portal

Start PMS

$ sudo /opt/SecureSpan/PatchManagement/bin/pms.sh start

Upload the OS upgrade patch: (run from folder where the patch was downloaded)

$ sudo /opt/SecureSpan/PatchManagement/bin/patch.sh upload Layer7_API_PortalPlatformUpdate_64bit_v11.X-Debian-2024-03-11.L7P

Using the patch ID, install the OS upgrade patch:

$ sudo sudo /opt/SecureSpan/PatchManagement/bin/patch.sh install Layer7_API_PortalPlatformUpdate_64bit_v11.X-Debian-2024-03-11

Portal APP upgrade to 5.2.3 without analytics (download the offline files)

$ sudo docker stack rm portal

$ sudo docker service ls

$ sudo tar –xzf “API Developer Portal Installer Offline 5.2.3.tar.gz” -C <previousInstallationDirectory> --strip-components=1

$ sudo ./portal.sh

Platform Debian 11 to Debian 12 docs link

• Download the OS upgrade patch file from the API Developer Portal Solutions and Patches page  (i.e., Layer7_API_PlatformUpdate_Debian-12_2024-06-19.L7P).

Stop the Portal stack.

$ sudo docker stack rm portal

Install and apply the Layer7_API_PMS_Debian_v2.0.0-20240722103829.L7P patch on the PMS for the v2.0.0 upgrade.

Upload the OS upgrade patch: (run from folder where the patch was downloaded)

$ sudo /opt/SecureSpan/PatchManagement/bin/patch.sh upload Layer7_API_PMS_Debian_v2.0.0-20240722103829.L7P

Using the patch ID, install the OS upgrade patch:

$ sudo sudo /opt/SecureSpan/PatchManagement/bin/patch.sh install Layer7_API_PMS_Debian_v2.0.0-20240722103829

Restart the Virtual Machine

Perform an In-Place OS Upgrade - Debian 12 PPP

Stop the Portal stack.

$ sudo docker stack rm portal

Upload the OS upgrade patch: (run from folder where the patch Layer7_API_PortalPlatformUpdate_64bit_v11.X-Debian-2024-03-11.zip was downloaded/unzipped)

$ sudo /opt/SecureSpan/PatchManagement/bin/patch.sh upload Layer7_API_PortalPlatformUpdate_64bit_v11.X-Debian-2024-03-11.L7P

Using the patch ID, install the OS upgrade patch:

$ sudo sudo /opt/SecureSpan/PatchManagement/bin/patch.sh install Layer7_API_PortalPlatformUpdate_64bit_v11.X-Debian-2024-03-11

Restart the Virtual Machine

Start the Portal stack.

$ sudo ./portal.sh

Portal App update 5.2.3 to 5.3.3.1

# docker stack rm portal

# sudo docker service ls

# tar –xzf “API Developer Portal Installer Offline 5.3.3.1.tar.gz” -C <previousInstallationDirectory> --strip-components=1

# sudo ./portal.sh