Registration of Avi Load Balancer Cluster with NSX Manager Fails with “Failed to Set System Configuration in NSX ALB Controller. Please try again.” Error

Products

• VMware Avi Load Balancer

Issue/Introduction

• Attempting to install and configure the Avi Load Balancer for vSphere Supervisor with NSX as outlined in the documentation (https://techdocs.broadcom.com/us/en/vmware-cis/vsphere/vsphere-supervisor/8-0/installing-and-configuring-vsphere-supervisor/networking-for-vsphere-with-tanzu/install-and-configure-nsx-and-nsx-advanced-load-balancer/install-and-configure-the-nsx-advanced-load-balancer-for-nsx.html), you may encounter the following error when registering the Avi LB with NSX Manager:

{“httpsStatus”: “BAD_REQUEST”,

“error_code”: 500016,

“module_name”: “Policy”,

“error_message”: “Error: Error: Failed to Set System Configuration in NSX ALB Controller. Please try again.”}

 

• In the NSX Manager’s log file (/var/log/proton/nsxapi.log), you will encounter the following error:

AlbControllerConfigUtils POLICY [ALB Controller] Got xAviVersion as 30.2.2

AlbControllerRestClient POLICY [ALB Controller] Rest template is being created with data: AlbControllerClusterConnectionInfo{username='***', ipAddress=<>, version='30.2.2', clusteringId='null', defaultCert=null}

INFO http-nio-127.0.0.1-7440-exec-20 AlbControllerRestClient 1842759 POLICY [nsx@6876 comp="nsx-maanager" level="INFO" reqId=<> sub comp="manager" username="admin"] [ALB Controller] AVI API GET https://<>/api/systemconfiguration/?include_name is called with Version 30.2.2
INFO-nio-127,9,9,1-7440-exec-20 AlbcontrollerConfigurationUtils 1842759 POLICY [nsx@6876 comp="nsx-manager" level="INFO" reqId=<> subcomp="manager" username="admin"] REST API https://<AVI_VIP>/api/systemconfiguration/?include_name failed with throwable 400 BAD REQUEST: "{"error": "invalid version"}"

 

• On AVI log file(/var/log/ngnix/portal.access.log), following error would be seen.

[2024-09-24 22:58:34,075] ERROR [error_handler.process_exception:95]  [31mData Exception in GET /api/systemconfiguration/ :  [0m
Traceback (most recent call last):
  File "/opt/avi/python/lib/avi/rest/api_version.py", line 246, in check_version
    from_index = supported_versions.index(version)
ValueError: '30_2_2' is not in list 

Cause

The NSX Manager is sending version 30.2.2 in its API calls to the Avi Controller as it had 30.2.2.AVI OVA file uploaded on NSX-T that does not match the currently deployed Avi version 22.1.7

Resolution

Permanent Fix:

Upload the OVA file matching the currently deployed Avi version through the NSX UI (System → Appliances). This enables NSX to reference the correct Avi version for API operations and then re-ran the onboarding API workflow .

OR

Alternatively, the same can be achieved by running the following API call:

POST https://{{mp_ip}}/policy/api/v1/repository/bundles?product=ALB_CONTROLLER&file_type=OVA
Request body:
{
"url": "ova link"
}