Patching Software Gateway command line to Upgrade from 11.0 to 11.1.2
search cancel

Patching Software Gateway command line to Upgrade from 11.0 to 11.1.2

book

Article ID: 397894

calendar_today

Updated On: 05-19-2025

Products

CA API Gateway

Issue/Introduction

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 

Environment

CA API Gateway 11.0 Software form Factor

RHEL 8, 9

Resolution

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