Error: "Sub allocated IP pool specified for edge gateway Edge-Name is invalid. Ranges in the pool should belong to external network IP pool" when attempting to add external network to edge gateway

Products

• VMware Cloud Director

Issue/Introduction

• An external network is already associated with the edge gateway.
• Attempting to add another external network in a different subnet following Add an External Network Connection to an NSX Edge Gateway to same edge gateway fails with error:
  
  [ ########-####-####-####-############ ] Sub allocated IP pool specified for edge gateway Edge-Name is invalid. Ranges in the pool should belong to external network IP pool. Sub allocated IP Ranges #.#.#.#-#.#.#.#. External network IP pool [].
  
  
• In the /opt/vmware/vcloud-director/logs/vcloud-container-debug.log on the VMware Cloud Director (VCD) cells, you see errors similar to:
  
  Cannot allocate multiple primary IP addresses for NSX-T Edge Gateway Edge-Name(com.vmware.vcloud.entity.gateway:########-####-####-####-############)

com.vmware.vcloud.api.presentation.service.BadRequestException: Cannot allocate multiple primary IP addresses for NSX-T Edge Gateway Edge-Name(com.vmware.vcloud.entity.gateway:########-####-####-####-############).
    at com.vmware.vcloud.networking.model.edge.nsxt.NsxTUplinkInterface.validatePrimaryIpAddress(NsxTUplinkInterface.java:189)
    at com.vmware.vcloud.networking.model.edge.nsxt.NsxTUplinkInterface.validate(NsxTUplinkInterface.java:83)
    ...

Environment

VMware Cloud Director 10.6.x

Cause

This issue occurs when the external network does not have any IP ranges added to it's static IP pool.

Resolution

To resolve this issue ensure that the external network being added to the edge gateway has a valid IP range configured under its static IP pools.
For more information on IP ranges in external networks see the documentation, External Networks in Your VMware Cloud Director.

Example steps to would be as follows:

1. Log into the VCD Provider portal as a System Administrator.
2. Navigate to Resources > Cloud Resources > External Networks and click the name of the external network to be modified.
3. Navigate to Configuration > Network Specification and click Edit to open the Edit Network Specification wizard.
4. Click the pencil icon under the Static IP Pools column for the subnets in the external network to open the Edit Static IP Pools wizard.
5. Define the desired IP range or ranges, click Add, and then Save to close the Edit Static IP Pools wizard.
6. Click Save again to close the Edit Network Specification wizard and apply the changes.
7. With an IP range now defined in the external network, attempt to add it again to the edge gateway as per the documentation, Add an External Network Connection to an NSX Edge Gateway in VMware Cloud Director.