Layer7 Saas API Developer portal showing sync error MqttException Already connected

Products

• CA API Developer Portal

Issue/Introduction

In our Saas Portal one of our Gateway Proxies is showing disconnected.

Environment

Saas API Developer Portal 5.x

Resolution

Gateway Proxy ssg_0_0.logs was showing error,

com.l7tech.external.assertions.portaldeployer.server.client.PortalDeployerClient: Attempting to reconnect to broker [wss://example.xxx.saas.xxxx.com:443/]
2025-08-25T07:04:48.481-0400 WARNING 10656  STDERR: MqttException (0) - java.io.IOException: Already connected
2025-08-25T07:04:48.481-0400 WARNING 10656  STDERR:     at org.eclipse.paho.client.mqttv3.internal.ExceptionHelper.createMqttException(ExceptionHelper.java:38)

Already connected means there is already a Proxy Gateway connected. In cases where you have copied the SSG Database from one cluster to another cluster (Example Prod to DR), you need to re-enroll the Gateway as a unique proxy to get a new portalman_xxxxxx key as its used as a unique identifier.

Steps taken to re-enroll in this situation:

In Policy manager

1) Take a VM Snapshot.

2) Go to Manage Private keys find the portalman* Key and remove this. Close the dialog.

3) Go to Cluster wide properties Select all the Portal.* Cluster properties (approx 37) and click Remove. 

4) Go to portal and remove this proxy, and get a new enrollment URL. 

5) Go to policy manager and enroll with portal using the (enrollment url from step 4). If Successful.

6) Restart SSG on all nodes.