IP Address Pool Missing in Policy Plane but Visible in Manager Plane
search cancel

IP Address Pool Missing in Policy Plane but Visible in Manager Plane

book

Article ID: 414761

calendar_today

Updated On:

Products

VMware NSX

Issue/Introduction

  • An IP address pool is visible and in active use on the Manager Plane, but it does not appear in the Policy Plane.

  • When performing a global search in the NSX UI, the IP pool is found with a "Manager" tag under the resource type, indicating it was created via the Manager Plane as below :

Environment

VMware NSX

Cause

It's an Expected behaviour to not see the objects created directly from the management plane on the policy plane.

Resolution

To make Manager-created objects available in the Policy Plane, you need to promote them using the Manager to Policy promotion feature.

Steps to Promote Manager Objects to Policy Plane

  1. Start the Migration Coordinator Service

    On any one node in the NSX Manager cluster, run the following command:

     
    start service migration-coordinator
  2. Backup First

    Before proceeding with the promotion, take a full backup of the NSX environment.

  3. Launch Object Promotion in UI

    • Navigate to:
      System > General Settings > Manager Objects Promotion

    • Click Start Objects Promotion.

    • A summary of manager-only objects will be displayed.

    • Click Continue to begin the promotion.

  4. Monitor the Promotion Process

    • The system will show real-time progress and status.

    • If any object fails to promote, an error will be displayed.

      • You may choose to Skip and Continue or Cancel the operation.

Completion

Once successfully promoted, the system will display the Manager to Policy Objects Promotion summary page.

 

Additional Information

Important note :

Deprecation announcement for NSX Manager APIs and NSX Advanced UIs

NSX-T has two methods of configuring logical networking and security: Manager mode and Policy mode. The Manager API contains URIs that begin with /api, and the Policy API contains URIs that begin with /policy/api

Please be aware that VMware intends to remove support of the NSX-T Manager APIs and NSX Advanced UIs in an upcoming NSX-T major or minor release,  NSX-T Manager APIs that are planned to be removed are marked with "deprecated" in the NSX Data Center API Guide, with guidance on replacement APIs.

It is recommended that new deployments of NSX-T take advantage of the NSX Policy APIs and NSX Policy UIs. For deployments currently leveraging NSX Manager APIs and NSX Advanced UIs, please refer to the NSX Manager for the Manager to Policy Objects Promotion page and NSX Data Center API Guide to aid in the transition.

 

Impact of not promoting the manager to policy:

If you have any API-based automation, after upgrading to an NSX-T major or minor release, the manager APIs will be deprecated, and the API based automated workflows will be impacted.

Please promote the objects so that the components can then later interact with the same objects through NSX Policy UI or NSX Policy APIs.

Sample:

The Manager API contains URIs that begin with /api are deprecated.

You can see that the Manager APIs below are deprecated for the IP pool in NSX 4. X

 

Sample : 

These APIs with policy/api on the Policy will be valid on 4. X


Reference Documentation
NSX API guide : https://developer.broadcom.com/xapis/nsx-t-data-center-rest-api/latest 

For full details on promote manager objects , refer to the official NSX documentation:
Promote Manager Objects to Policy Objects – VMware NSX-T