Upgrade the Gateway

Upgrades to the gateway are made available in accordance to your service agreement.
gateway94
Upgrades to the 
Layer7 API Gateway
are made available in accordance to your service agreement.
This section describes how to upgrade a standalone Gateway or a cluster of Gateways. It is strongly recommended that you perform the upgrades across a secure network.
If your 
Layer7 API Gateway
includes any custom assertions, please verify with CA Support prior to upgrading that you are running the most recent version and that your particular custom assertion will not cause issues during the upgrade.
Choose the type of Gateway being upgraded:
Known Issues Related to Upgrade
Unable to use Publish Functions from Home Page After Upgrade  
Issue:
After upgrading from Gateway version 9.3 to Gateway 9.4, then clicking any Publish function from the Home page of the Policy Manager, the following error occurs: "The Policy Manager encountered an internal error or misconfiguration and was unable to complete the operation." You are unable to create an API.
This issue only occurs for Gateways matching all of the following criteria:
  • The Gateway was upgraded from version 9.3 to 9.4.
  •  A Security Zone has been created.
The cause of the issue is a work_queue feature that is not completely removed when upgrading to 9.4.
To resolve the issue:
  1. Open a terminal and connect to the affected node with admin/root user credentials.
  2. Connect to the mysql database:
    msql -u root -p
    Type your password. The mysql prompt appears. 
  3. Specify the database:
    mysql> use ssg;
    Where ssg is the name of your database.
  4. Search for and remove the references to work_queue in the security_zone table:
    mysql> SELECT*FROM ssg.security_zone WHERE entity_types LIKE "%WORK_QUEUE%"; mysql> DELETE*FROM ssg.security_zone WHERE entity_types LIKE "%WORK_QUEUE%";
  5. Search for and remove the references to security_zone in the rbac_role table:
    mysql> SELECT*FROM ssg.rbac_role WHERE entity_types LIKE "SECURITY_ZONE"; mysql> DELETE*FROM ssg.rbac_role WHERE entity_types LIKE "SECURITY_ZONE";
  6. Search for and remove the references to security_zone in the rbac_permission table:
    mysql> SELECT*FROM ssg.rbac_permission WHERE entity_types LIKE "SECURITY_ZONE"; mysql> DELETE*FROM ssg.rbac_permission WHERE entity_types LIKE "SECURITY_ZONE";
  7. Finally, remove the work_queue table, if existing: 
    mysql> SELECT*FROM ssg.work_queue; mysql> DELETE*FROM ssg.work_queue;
  8. Restart the Gateway.