After manually installing NSX Edge VM on an ESXi host or as a Bare Metal server, you can edit a NSX Edge configuration.

A transport node is a node that is capable of participating in an NSX overlay or NSX VLAN networking. Any node can serve as a transport node if it contains an N-VDS. Such nodes include but are not limited to NSX Edges.

An NSX Edge can belong to one overlay transport zone and multiple VLAN transport zones. If a VM requires access to the outside world, the NSX Edge must belong to the same transport zone that the VM's logical switch belongs to. Generally, the NSX Edge belongs to at least one VLAN transport zone to provide the uplink access.

Prerequisites

  • VLAN and Overlay transport zones must be configured.
  • Verify that compute manager is configured. See Add a Compute Manager.
  • An IP pool (to be used as NSX Edge TEP pool) must be configured or must be available in the network deployment.
  • (NSX 4.0.1.1) Before you can use NSX Edge VM datapath interfaces in Uniform Passthrough (UPT) mode, meet the following conditions:
    Note: UPT mode is not supported on NSX Edge Bare Metal hosts.
    • NSX Edge hardware version is 20 (vmx-20) or later. Previous NSX Edge hardware versions do not support UPT mode.
    • Verify that the memory reservation on the configured NSX Edge is set to 100%.
    • From the vSphere Web Client, enable UPT on the NSX Edge VM network adapter. See the Change the Virtual Machine Network Adapter Configuration topic in vSphere Virtual Machine Administration guide.
    • At least one of the NSX Edge VM datapath interface must be backed by an ESXi host that hosts a Data Processing Unit-based SmartNIC. A SmartNIC is a NIC card that provides network traffic processing using a Data Processing Unit (DPU), a programmable processor on the NIC card, in addition to the traditional functions of a NIC card. For more information related to DPU, see NSX on vSphere Lifecycle Manager with VMware vSphere Distributed Services Engine.
  • Starting with NSX 4.0.1.1, NSX Edge VM hardware version will no longer default to virtualHW.version 13. NSX Edge VM hardware will depend on the underlying version of the ESXi host. VM hardware versions compatible with ESXi hosts are listed in KB article 2007240.

Procedure

  1. From a browser, log in with admin privileges to an NSX Manager at https://<nsx-manager-ip-address> or https://<nsx-manager-fqdn>.
  2. (NSX 4.0.1.1) To enable UPT mode on the NSX Edge node:
    1. Select System → Fabric → Nodes → Edge Transport Nodes.
    2. Select the NSX Edge node to enable UPT, click Actions and Change Node Settings.
    3. In the Change Node Settings window, ensure the Enable UPT mode for datapath interface field is enabled. This setting enables UPT on all datapath interfaces that support UPT mode or support network offloads.
    4. Click Save.
  3. To prepare the NSX Edge node as a transport node, select System > Fabric > Nodes > Edge Transport Nodes > Edit Edge. Configure the following fields to complete preparation of a NSX Edge node as a transport node.
  4. Enter the N-VDS information.
    Option Description
    Edge Switch Name Enter a name for the switch.
    Transport Zone Select the transport zones that this transport node belongs to. An NSX Edge transport node belongs to at least two transport zones, an overlay for NSX connectivity and a VLAN for uplink connectivity.
    Note: NSX Edge Nodes support multiple overlay tunnels (multi-TEP) when the following prerequisites are met:
    • TEP configuration must be done on one N-VDS only.
    • All TEPs must use the same transport VLAN for overlay traffic.
    • All TEP IPs must be in the same subnet and use the same default gateway.
    Uplink Profile Select the uplink profile from the drop-down menu.

    The available uplinks depend on the configuration in the selected uplink profile.

    IP Assignment (TEP)

    IP address is assigned to the NSX Edge switch that is configured. It is used as the tunnel endpoint of the NSX Edge.

    Select Use IP Pool or Use Static IP List for the overlay N-VDS.
    • If you select Use Static IP List, specify:
      • Static IP List: Enter a list of comma-separated IP addresses to be used by the NSX Edge.
      • Gateway: Enter the default gateway of the TEP, which is used to route packets another TEP in another network. For eample, ESXi TEP is in 20.20.20.0/24 and NSX Edge TEPs are in 10.10.10.0/24 then we use the default gateway to route packets between these networks.
      • Subnet mask: Enter the subnet mask of the TEP network used on the NSX Edge.
    • If you selected Use IP Pool for IP assignment, specify the IP pool name.

    DPDK Fastpath Interfaces / Virtual NICs

    Map uplinks to DPDK fastpath interfaces.

    Starting with NSX 4.0.1, you can map uplinks to DPDK fastpath interfaces that are backed by smartNIC-enabled DVPGs, VLAN logical switches or segments. The prerequisite is to enable UPT mode on NSX Edge VM virtual network adapters. The UPT mode requires at least one DPDK interface to be backed by smartNIC-enabled hardware also known as Data Processing Unit (DPU)-backed networks.

    Note: If the uplink profile applied to the NSX Edge node is using a Named Teaming policy, ensure the following condition is met:
    • All uplinks in the Default Teaming policy must be mapped to the corresponding physical network interfaces on the Edge VM for traffic to flow through a logical switch that uses the Named Teaming policies.

    You can configure a maximum of four unique data path interfaces as uplinks on a NSX Edge VM.

    When mapping uplinks to DPDK Fastpath Interfaces, if NSX Edge does not display all the available interfaces (four in total), it means that either the additional interface is not yet added to the NSX Edge VM or the uplink profile has fewer number of uplinks.

    For NSX Edge VMs upgraded from an earlier version of NSX to 3.2.1 or later, invoke the redeploy API call to redeploy the NSX Edge VM. Invoking the redeploy API ensures the NSX Edge VM deployed recognizes all the available datapath interfaces in NSX Manager UI. Make sure the Uplink profile is correctly configured to use additional datapath NIC.

    • For autodeployed NSX Edges, call the redeploy API.
      POST api/v1/transport-nodes/<transport-node-id>?action=redeploy
    • For manually deployed edges, deploy a new NSX Edge VM. Ensure all the vmx customizations of the old NSX Edge VM are also done for the new NSX Edge VM.

    Performing vMotion on a NSX Edge VM might result in the NSX Edge VM going into failed state or the additional network adapter cannot be enabled because of memory buffer issues. For troubleshooting memory-related issues when performing a vMotion on a NSX Edge VM, see https://kb.vmware.com/s/article/76387.

    Note:
    • LLDP profile is not supported on an NSX Edge VM appliance.
    • Uplink interfaces are displayed as DPDK Fastpath Interfaces if the NSX Edge is installed using NSX Manager or on a Bare Metal server.
    • Uplink interfaces are displayed as Virtual NICs if the NSX Edge is installed manually using vCenter Server.
  5. Click Save.
  6. View the connection status on the Transport Nodes page.
    After adding the NSX Edge as a transport node, the connection status changes to Up in 10-12 minutes.
    Note: ( NSX 4.0.1.1) When you enable the Actions > Change Node Settings > Enable UPT mode for datapath interface field, the NSX Manager puts the NSX Edge VM into maintenance mode, applies configuration, and removes NSX Edge from maintenance mode which makes the UPT configuration effective on the NSX Edge transport node.
  7. To successfully configure firewall rules on the NSX Edge node, enable service core on the transport node.

    set debug

    set dataplane service-core enabled

    restart service dataplane

  8. (Optional) View the transport node with the GET https://<nsx-manager>/api/v1/transport-nodes/<transport-node-id> API call.
  9. (Optional) For status information, use the GET https://<nsx-mgr>/api/v1/transport-nodes/<transport-node-id>/status API call.
  10. After an NSX Edge node is migrated to a new host using vCenter Server, you might find NSX Manager UI reporting stale configuration details (Compute, Datastore, Network, SSH, NTP, DNS, Search Domains) of the NSX Edge. To get the latest configuration details of NSX Edge on the new host, run the API command.
    POST api/v1/transport-nodes/<transport-node-id>?action=refresh_node_configuration&resource_type=EdgeNode

What to do next

Add the NSX Edge node to an NSX Edge cluster. See Create an NSX Edge Cluster.