The upgrade process (11.0 to 11.1.2) using command line is prone for mistakes between the different closely named files, uploading, then installing all required patches to get to the finish line.
Below the steps to upgrade the Software Gateway form factor from 11.0 to 11.1.2
CA API Gateway 11.0 Software form Factor
RHEL 8, 9
At 11.0 version, the PMS 1.0 (Patch Management System) will allow us to install the first patch
/opt/SecureSpan/PatchManagement/bin/patch.sh <action>
Steps for each patch:
First Patch:
1) /opt/SecureSpan/Gateway/runtime/bin/gateway.sh stop
cd /opt/SecureSpan/PatchManagement/bin/
./pms.sh start
2) upload , then install the patch with command below
/opt/SecureSpan/PatchManagement/bin/patch.sh upload /home/Layer7_API_Gateway_v11.1.00.17707.L7P
/opt/SecureSpan/PatchManagement/bin/patch.sh install /home/Layer7_API_Gateway_v11.1.00.17707.L7P
4) REBOOT
Note : the Layer7_API_Gateway_Software_Installer_Upgrader_11.1.00.zip
which contains Layer7_API_Gateway_v11.1.00.17707.L7P
Second Patch
For the Second Patch , need to update first the PMS version, due the newer than Aug 2024 Patches has a new cipher certifcate which works with PMS v2.0 only.
Steps to update PMS 1.0 to PMS v2.0.0:
1) /opt/SecureSpan/Gateway/runtime/bin/gateway.sh stop
cd /opt/SecureSpan/PatchManagement/bin/
./pms.sh start
2) Upload Patch:
-Provide FULL path to .L7P file even though you are in the directory where it resides
patch.sh upload /opt/apigw/software/gateway/Layer7_API_PMS_RHEL_v2.0.0-20240715115049.L7P
3) patch.list (shows which patch was uploaded , ready to be installed on next step)
4) Install Patch: (this step use PMS v1.0 to install PMS v2.0.0), from /opt/SecureSpan/Controller/bin
use command below :
patch.sh install Layer7_API_PMS_RHEL_v2.0.0-20240715115049
Note : PatchID used on install command does not includes the L7P extension. Else will get error.
5) REBOOT
Third Patch
1) /opt/SecureSpan/Gateway/runtime/bin/gateway.sh stop
cd /opt/SecureSpan/PatchManagement/bin/
./pms.sh start
rpm -qa |grep patch- , ensure version is PMS 2.0
2) upload , then install the patch with command below :
/opt/SecureSpan/PatchManagement/bin/patch.sh upload /home/Layer7_API_Gateway_v11.1.1.18484.L7P
/opt/SecureSpan/PatchManagement/bin/patch.sh install /home/Layer7_API_Gateway_v11.1.1.18484
3) REBOOT
Forth Patch
1) /opt/SecureSpan/Gateway/runtime/bin/gateway.sh stop
cd /opt/SecureSpan/PatchManagement/bin/
./pms.sh start
2) upload , then install the patch with command below :
/opt/SecureSpan/PatchManagement/bin/patch.sh upload /home/Layer7_API_Gateway_v11.1.2.20324.L7P
/opt/SecureSpan/PatchManagement/bin/patch.sh install /home/Layer7_API_Gateway_v11.1.2.20324
3) REBOOT
4) if you have Gw 11.1.2 but the database is version 11.1.0 proceed with the db_upgrade_v2.zip
Update the ssg Database using the following script
example :
copy the .sh to the Gateway VM
chmod a+x ./path/to/script/db_upgrade_v2.sh
./path/to/script/db_upgrade_v2.sh <db_admin_username> <db_admin_userpass>
ref:
Automating API GATEWAY database upgrade process 11.1.x via script command line