Offboarded local manager site cannot be re-onboarded to global manager

Products

• VMware NSX

Issue/Introduction

• The GM UI may show the message 

  On the UI Site <LM_NAME> is not registered with this global Manager. Please register the site on the Global Manager and try again.

• The GM UI may show the message 

  Error: Communication error occurred with reason 500 Internal Server Error: "{"error_code": 37000, "error_message": "Site manager error. <LM_NAME> Name is already bounded, it can't be changed without proper unbind call.", "module_name": "node-services"}" (Error code: 530039)

• On the GM, messages similar to the following may be seen in the /var/log/gmanager/gmanager.log file
  

  ERROR http-nio-127.0.0.1-64440-exec-77 GmConfigOnboardingServiceImpl 5551 POLICY [nsx@6876 comp="global-manager" errorCode="MP606117" level="ERROR" reqId="ID" subcomp="global-manager" username="admin"] Site {0} is not registered with this Global Manager. Please register the site on the Global Manager and try again.

• On the GM, messages similar to the following may be seen in the /var/log/gmanager/gmanager.log file
  

  2026-04-24T12:47:16.855Z  INFO http-nio-127.0.0.1-64440-exec-120 NsxTRestClient 8009 POLICY [nsx@4413 comp="global-manager" level="INFO" reqId="9218cdda-####-####-####-e425889ab325" subcomp="global-manager" username="<username>"] NSX API POST http://127.0.0.1:7441/api/v1/sites?action=onboard_site is called
  with OnboardSiteParametersDto{address='<LM_FQDN>:443', username='<username>', siteName='<SITE_NAME>', standbyGm='false'} and
  2026-04-24T12:47:17.318Z  WARN http-nio-127.0.0.1-64440-exec-120 SiteManagerRestClient 8009 POLICY [nsx@4413 comp="global-manager" level="WARNING" reqId="9218cdda-####-####-####-e425889ab325" subcomp="global-manager" username="<username>"] Failed to on-board with exception 500 Internal Server Error: "{"error_code": 37000, "error_message": "Site manager error. <LM_NAME> Name is already bounded, it can't be changed without proper unbind call.", "module_name": "node-services"}"
  org.springframework.web.client.HttpServerErrorException$InternalServerError: 500 Internal Server Error: "{"error_code": 37000, "error_message": "Site manager error. <LM_NAME> Name is already bounded, it can't be changed without proper unbind call.", "module_name": "node-services"}"
  …
  2026-04-24T12:47:17.319Z  WARN http-nio-127.0.0.1-64440-exec-120 PolicyPathUtil 8009 POLICY [nsx@4413 comp="global-manager" level="WARNING" reqId="9218cdda-####-####-####-e425889ab325" subcomp="global-manager" username="<username>"] Parent cannot be found for path /global-infra/sites/<SITE_NAME>/alarms/3c93805f-####-####-####-f39b54dd5c46
  2026-04-24T12:47:26.869Z  WARN ShaHeartbeater VcfGrpcClient 8009 MONITORING [nsx@4413 comp="global-manager" level="WARNING" s2comp="sha-vcf-grpc-client" subcomp="g
  lobal-manager"] Failed in sending heartbeat:process_name: "global-manager"
  timestamp: 1777034846869
  seq: 80606
  heartbeat {
    type: NORMAL
  }

Environment

• VMware NSX 4.X
• NSX Federation
• Security Services Platform (SSP)
• Local Manager is being Re-OnBoarded.

Cause

This issue may occur when a LM is OffBoarded from a GM but not from SSP. If the Local Manager (LM) name is subsequently changed and later Re-OnBoarded in to the GM, it will not complete the OnBoarding.

Resolution

• The LM must be offboarded from SSP as well before it can be re-onboarded to the GM.

Additional Information

Security Services Platform 5.0 - Onboard NSX Manager