VMware NSX-T Data Center 2.4 | 28 February 2019 | Build 12456646
Check regularly for additions and updates to these release notes.
What's in the Release Notes
The release notes cover the following topics:
- What's New
- Compatibility and System Requirements
- API and CLI Resources
- Revision History
- Resolved Issues
- Known Issues
NSX-T Data Center 2.4 provides a variety of new features to provide new functionality for virtualized networking and security for private, public, and hybrid clouds. Highlights include a new intent-based networking user interface, context-aware firewall, guest and network introspection features, IPv6, highly-available clustered management, profile-based NSX installation for vSphere compute clusters, rebootless maintenance upgrade mode of NSX for vSphere compute, new in-place upgrade mode for vSphere compute and a migration coordinator for migrating from NSX Data Center for vSphere to NSX-T Data Center.
The following new features and feature enhancements are available in the NSX-T Data Center 2.4 release.
NSX-T Data Center 2.4 now supports the ability to create a cluster of managers for high availability of the user interface and API. This clustering supports both external balancers for redundancy and load distribution or a NSX provided virtual IP for redundancy. In addition, the management plane function and the central control plane function have been collapsed into this new management cluster to reduce the number of virtual appliances that need to be deployed and managed by the NSX administration. The NSX Manager appliance is available in three different sizes for different deployment scenarios. A small appliance for lab or proof-of-concept deployments. A medium appliance for deployments to 64 hosts and a large appliance for customers who deploy to a large scale environment. For details on configuration maximums, see the VMware configuration maximums tool at: https://configmax.vmware.com
Policy and UI
NSX Management and Automation
- Declarative Policy Management - Simplify and automate network and security configurations through outcome-driven policy statements. This new declarative policy API reduces the number of configuration steps by allowing users to describe desired end-goals, while letting the system figure out how best to achieve it. Define an entire network topology and deploy it all in one shot, in an order-independent, prescriptive manner.
User Interface Enhancements
- Enhanced Navigation and Page Layouts: improved navigation bar and page layouts to reduce the number of clicks to access critical information.
- Internationalization: improved handling of locale-specific items, such as date/time format, number format, time zone.
Distributed Firewall and Gateway Firewalls will support filtering of IPv6 traffic from NSX-T Data Center 2.4. Additionally, there are various operational features added to the product as listed below:
A single publish button is available for the entire firewall table. This will be available for both Distributed and Gateway Firewalls. Prior to NSX-T Data Center 2.4, the publish button was for each section separately. This will be available via API. Additionally, you will have the option to revert your changes. You will also have the option to lock sections when changes are updated.
Each rule will have the hit count, packet count, session count, byte count and popularity index. It will also have maximums seen versus current hit counts. This statistics can be reset by a button.
Additional grouping criteria based on operating system for the VM and Active Directory groups are available.
Rule Visibility per VM
List of Firewall rules for a particular VM is available by looking at the logical switch port associate for every virtual machine.
IP Discovery for Virtual Machines
The default IP Discovery profile is being updated to include VMTools based IP discovery in addition to ARP snooping and DHCP Snooping. Existing customers upgrading from prior releases will have to update the IP Discovery profile to enable VMTools based detection. Additionally, creation of a global IP discovery profile is supported with NSX-T 2.4. Additionally, there are the following changes:
- IPv6 IP discovery based on DHCPv6 and Neighbor Discovery mechanisms are available.
- IPv6 discovery is disabled by default
- Auto-Discovered IP bindings can be either manually whitelisted or put in ignore list.
- Local Link IPv4 addresses will be ignored by default.
NSX-T Data Center 2.4 introduces Identity (User ID) based rules for Distributed Firewall. Firewall Administrators can now configure distributed rules on virtual machines based on Active Directory based groups. This feature allows firewall administrators to provide firewall rules based on the users logged into the virtual machines. NSX will auto-detect users logged in / logged off and accordingly specific rules will be enabled for the users. Identity based Firewall can detect and enforce rules for a single user per VM or even track multiple users with particular sessions in the same VM. Firewall administrators will be creating NSX-T groups using Active Directory groups as a criteria. NSX-T manager will automatically retrieve a list of Active directory groups from the provide Domain Controllers. Firewall administrators can control east-west access of users especially in virtual desktop environments or remote desktop sessions with terminal services enabled.
L7 Application Signatures for Context-Aware Distributed Firewall
NSX-T Data Center 2.4 provides the ability to L7 based application signatures in Distributed Firewall rules. Users can either use a combination of L3/L4 rules with L7 Application Signatures or can just create L7 Application Signature-based rules only. We currently support Application signatures with various sub-attributes for Server-Server or Client-Server Communications only. In NSX-T Data Center 2.4, this will be available for ESXi based transport nodes only.
FQDN/URL Whitelisting for Context-Aware Distributed Firewall
NSX-T Data Center 2.4 introduces URL / FQDN whitelisting based rules in Distributed Firewall. NSX-T Data Center introduces an innovation using Distributed DNS snooping to allow each connection from each VM to have its own resolution of URL/FQDN. Firewall Administrators can use pre-canned URL domains and apply it to rules in distributed firewall. Applications that are hybrid in nature accessing SaaS services or cloud-based services can micro-segment based on the URLs accessed. Client applications or Browsers accessing SaaS applications can be given access on a granular basis. In NSX-T Data Center 2.4, this will be available for ESXi based transport nodes only.
NSX-T Data Center 2.4 introduces a broad array of native security functionality such as Layer 7 Application Identity, FQDN Whitelisting and Identity Firewall, which enable even more granular micro-segmentation. Besides the native security controls delivered by the Distributed and Gateway Firewall, the NSX Service Insertion Framework allows various types of Partner Services like IDS/IPS, NGFW and Network Monitoring solutions to be inserted transparently into the data path and consumed from within NSX without making changes in the topology.
In NSX-T Data Center 2.4, Service Insertion now supports East-West Traffic (i.e., Traffic between the VMs in the Data Center). All the traffic between VMs in the Data Center can be redirected to a dynamic chain of partner services.
The E-W service plane provides its own forwarding mechanism that allows policy-based redirection of traffic along chains of services. Forwarding along the service plane is entirely automated by the platform: failures are detected, and existing/new flows redirected as appropriate, flow pinning is performed to support stateful services, and multiple path selection policies are available to optimize for throughput/latency or density.
NSX-T Data Center 2.4 introduces the Guest Introspection service platform for VMware partners to provide policy-based agent-less antivirus and anti-malware offload capabilities for Windows-based Guest VM workloads on vSphere ESXi hypervisors.
In NSX-T Data Center 2.4, the Guest Introspection platform provides:
- Simplified deployment and life-cycle management by consolidating the Guest Introspection deployment into the NSX Agent host preparation installation and no longer requiring the Guest Introspection Universal Service VM to be deployed on each ESXi hypervisor.
- Consistent policy-based services across multiple vCenters.
- VMware partner scale enhancements through sizing of partner SVM (i.e., "Small," "Medium, "Large" partner appliances).
Multiple N-VDS per Host
Apart from providing flexibility to organize VM traffic, this new capability to support multiple N-VDS per host facilitates compliance with PCI regulation where strict isolation is required for VM traffic.
With the addition of this feature, one can now separate ENS uplinks from non-ENS uplinks; this is a useful functionality since ENS does not have feature parity with N-VDS today so ENS powered workloads will get fast path but go low on features.
This functionality provides the capability to manage the N-VDS as a standalone object with the ability to drill down to see connected hosts, etc. When looking at a specific host, one is able to see a UI grid that shows how it's connected to the N-VDS. Logical interfaces like VM kernel interfaces are also visible as part of the N-VDS. This is a dramatic improvement over the host view shows list of interfaces that includes all physical NICs, VM Kernel interfaces, and all OVS ports in one view.
LLDP Support for Physical NICs
This feature helps close the gaps in LLDP implementation for NSX. It provides debugability for physical switch connectivity. The ability to decipher which physical ports are connected to which interfaces on a host lends to easy troubleshooting of cabling problems. The scope of this feature applies to all physical hosts (ESXi, KVM, Baremetal Linux Hosts and Baremetal Edge) that participate in NSX dataplane.
Support for Proxy ARP on Edge Node
When external clients access services like LB, IKE etc., with same subnet addresses, they hit device routing. They send ARP queries for those addresses bound to loopback ports, however, LR loopback ports don't have the MAC addresses, so they do not respond to those ARP queries. This causes access problems.
Currently the workaround is to configure a /32 routing in those clients, like Loopback IP/32 → uplink/CSP, so the traffic can be forwarded to uplink/CSP ports, then it can go to the correct loopback port. ARP Proxy is the right solution to overcome this drawback.
MTU Configuration Enhancements
NSX-T 2.4 offers two new MTU global parameters:
- Global Physical Uplink MTU, which configures the MTU for all the NVDS instances in the NSX domain. This can be translated as the maximum frames size for the GENEVE encapsulated frames or TEP MTU.
- Uplink Profile MTU can override the global physical uplink parameter on a specific host.
- Global Logical Interface MTU, which configures the MTU for all the logical router interfaces.
- Logical Router Uplink MTU and CSP port MTU can override on a specific port the global logical interface MTU if needed.
This will allow end to end communications for VM configured with MTU larger than 1500 bytes for east-west and north-south traffic.
Inter SR Routing
Tier0 logical routers in active/active mode can now automatically establish full mesh iBGP peerings among all the Service Routers (SR) part of a given Tier0 logical router. This prevents traffic drops in case of SRs configured with multiple uplinks and a failure of only one of them. A SR in this failure scenario will now forward the traffic to another SR if the destination is not available on its own uplinks.
DNS Forwarder Enhancements
- The DNS forwarder function can now be enabled or disabled without losing its current configuration.
- The DNS forwarder function exposes also statistics, events and alarms through API and UI.
Support SNAT from Uplink to Uplink
NSX-T 2.4 introduces the support of SNAT (Source address Translation) for traffic entering a Tier0 logical router through an uplink and leaving the same logical router through another uplink. This feature is useful when multiple Tier0 logical routers are interconnected.
Support for Proxy ARP on Tier0 Logical Router
NSX-T 2.4 introduces the support of Proxy ARP on Tier0 logical router uplinks. This will allow the deployment of NSX-T in environments where routing cannot be configured on the routers northbound of the Tier0 logical router. With this feature, NAT, LB or any stateful services can be configured with an IP address that belong to the network of the Tier0 uplink.
Bare Metal Edge Node Enhancements
- NSX-T 2.4 introduces the option on Bare Metal Edge node to support the management on the fast path NICs, no longer requiring a dedicated management NIC.
- Bare Metal Edge node supports also 25 Gbps Intel NICs XXV710.
- Edge node supports multiple GENEVE Tunnel EndPoint (TEP). This allows edge nodes not to be forced to use LAG for high-availability of the overlay traffic.
- Starting from NSX-T 2.4, Tier0 logical routers support iBGP peering with physical routers northbound.
- NSX-T 2.4 introduces the option to enable ECMP across eBGP peers in different ASN (as-path multipath relax) and also the support for the Tier0 logical router to allow its own ASN in the AS-path (allow-as in).
NSX-T 2.4 introduces IPv6 routing/forwarding and security. This includes the support for:
- IPv6 static routing
- IPv6 Neighbor Discovery
- DHCPv6 relay
- IPv6 Distributed Firewall (DFW)
- IPv6 Edge Firewall
- IPv6 address-family for MP-BGP and associated prefix-list/route-map
- IPv6 switch security
- IPv6 address discovery
- IPv6 ops tools
Traceflow adds support for even more troubleshooting and visualization capabilities. In NSX-T 2.4, Traceflow provides observations for centralized services such as Edge Firewall, Load Balancer, NAT and Route-based VPN.
- NSX enables simplified deployments using a new profile-based installation of NSX components for vSphere compute clusters. This feature helps enable faster deployments, drives configuration consistency, avoids manual errors and provides a way to “define once and re-use multiple times.”
- Support for automated installation and clustering of NSX manager nodes from the UI.
- Support for more deployment configurations that can create multiple N-VDS switches, migrate VMKernel ports and physical adapters via profiles.
- Enhancements to provide fully orchestrated upgrades of ESXi hosts without incurring the cost of a host reboot using the default Maintenance mode NSX upgrade.
- Introduced a new NSX upgrade mode called "in-place" upgrade. This features helps provide operational simplicity and enables faster upgrades. When using this mode, the NSX components on the ESXi hosts are upgraded without having to power-off workloads or migrate them to a different hypervisor.
- Introduced a new framework and provided out-of-the-box tests to do pre-checks and post-checks during the NSX upgrade that can help highlight dormant underlying issues before you begin the actual upgrade or immediately after the upgrade.
NSX Backup On Change Detection
NSX enhances its disaster recovery solution by providing the ability to detect configuration changes and proactively back them up to secure storage. This feature enables customers to have better SLA for configuration backups without incurring the cost of backing up unnecessary files to the storage server.
The N-VDS switch will now support the following enhancements in EDP mode.
- Distributed firewall
- IP Discovery
- Spoof guard
- IP Fix
- Enhanced performance for the Edge VM, which now provides up to five times more throughput in EDP mode.
- Path redundancy for multi-homed applications. Ability to pin a VM to a specific uplink allows the construction of a multi-homed redundant path today on NSX with VTEPs.
Operations - AAA/RBAC and Platform Security
- Principal Identity Enhancements: Enables Principal Identity users to register and install NSX components. Added UI support for creation of Principal Identity users and role assignment.
Password Policy Enhancements: Enforces minimum password length of 12 characters for default passwords. Introduces ability to set password expiration times and generates alarms when password is about to expire.
- Certificate Management: Adds ability to check the revocation status of certificate.
NSX-T 2.4 has added the following capabilities for VPN services:
- Policy API and GUI are available for both L3 VPN and L2 VPN services.
- L3 VPN services support certificate-based authentication for better security management.
- The L2 VPN Client mode is available to support L2 extension from NSX-T SDCC to NSX-T SDCC.
- DH groups 19, 20, and 21 are available to meet high security requirements.
NSX-T 2.4 has added the following capabilities for load balancing services:
- Policy API and new GUI are available. The old Load Balancer GUI is still available under the Advanced Networking & Security tab.
- VIPs on Standalone SR can belong to the same subnet as the Centralized Service Port or CSP. Prior to this release, if you wanted to create a VIP on the same subnet as the CSP network, the CSP IP address had to be used for the VIP. Otherwise, you had to create a VIP on a different network.
- DNAT and Edge Firewall are supported for load balancer traffic flows on the same Tier-1 gateway. Prior to this release, load balancer traffic flows bypassed the Edge firewall.
- LB rules support HTTP headers beginning with "_". With this enhancement, NSX Load Balancer can be deployed for vIDM and AirWatch.
- A VIP can be used as a source IP address for LB SNAT.
- The maximum HTTP response header size can be configured up to 64K Bytes. The default size stays the same as the previous release at 4K Bytes.
- A Large Edge VM supports a Large LB instance. Prior to this release, the Large Edge VM supported up to a Medium LB instance.
NSX Data Center for vSphere to NSX-T Data Center Migration
NSX-T 2.4 now has a Migration Coordinator which can be used to aid in the migration from NSX Data Center for vSphere to NSX-T Data Center. This feature is designed to migrate existing hosts without the use of vMotion. The Migration Coordinator supports migration of layer 2 networking, layer 3 networking, firewall, load balancing, and VPN. The NSX-T Data Center Migration Coordinator Guide provides details of the tool.
There is no need for additional compute resources beyond just the deployment of NSX-T Managers and Edge Nodes. Once the migration is complete, a customer can un-install NSX for vSphere and the associated Managers, Controllers and Edges. Please note that this migration does impact data plane traffic and is designed to be completed in a single change window.
Automation, OpenStack and other CMP
NSX-T 2.4 introduces the following capabilities for OpenStack consumption via its Neutron plugin:
- Support of Rocky and Queens
- Support of Management Plane Clustering
The OpenStack Neutron Plugin takes advantage of the new ability to have a cluster of managers. It can consume the three managers REST API endpoints without an external VIP for additional performance and higher availability.
- Support of Barbican
The OpenStack Neutron Plugin now supports Barbican. Barbican is a REST API designed for the secure storage, provisioning and management of secrets such as passwords, encryption keys and X.509 Certificates. This allows to manage certificate for the Load Balancer as a Service in order to do HTTPS termination. This is a feature currently supported in VIO environment only.
NSX-T Terraform Provider adds the following capabilities in NSX-T 2.4 to those already existing (Creation of logical switches, routers, firewall rules etc.):
- Ability to support CRUD on Load Balancer and Load Balancer configuration (Monitor, Pool etc.)
- Ability to support CRUD on DHCP Servers
- Ability to support CRUD on NSX-T IPAM (IP Block, IP pool)
NSX-T 2.4 for NSX Cloud has many new features to ease adoption/deployment for a customer, give more options with respect to how a customer can do service insertion, VPN termination, manage their VDI environments and thereby manage a true multi-region, multi-cloud hybrid deployment.
These are some of the key features in NSX Cloud with NSX-T 2.4:
- Shared Gateway in Transit VPC/VNET for simplified, faster onboarding and consolidation
- VPN for back-haul traffic back to on-premises DC
- Selective North-South Service Insertion & Partner Integration
- Micro-segmentation on Horizon Cloud for Azure
- Intent-Based Policy for Hybrid Workloads
Simplified Transit VPC/VNET architecture: Starting with 2.4, customers can install a single NSX Cloud gateway on a transit VPC/VNET and manage up to 10 compute VPCs/VNETs. This simplifies the hub and spoke transit/compute architecture and enables Transitive Routing between Compute VPCs even when they don’t have a peering connection. Using NSX overlay tunneling, traffic between VPCs can now be sent in an overlay tunnel. Forwarding policies can be set up right down at the VM level to dictate if traffic should be Geneve encapsulated and sent in the Overlay, or if it should be sent in the public cloud provider’s underlay network. All these features give more flexibility in terms of how users can route traffic within and outside of their public cloud network.
VPN for back-haul traffic: NSX Cloud now has built-in support to have VPN tunnels to back-haul traffic from public cloud to on-premises Data Center. VPNs from on-premises Data Center can now be directly terminated at the NSX Cloud Gateway in the public cloud. Customers don't need the VGW provided by public cloud vendors and this reduces cost. It also reduces the management overhead as NSX Cloud Gateway automatically propagates the routes over BGP. From a BW perspective, NSX Cloud gives a huge bump in the capacity as well: Inter-VPC traffic flows can be at 5Gbps over peered VPCs versus just 1Gbps offered over VGW.
Selective North-South Service Insertion & Partner Integration: Customers can deploy Partner Service directly from Public Cloud Marketplace in the Shared Services / Transit architecture. The NSX Cloud gateway present in the transit VPC/VNET can be programmed to selectively route traffic to partner service appliance based on NSX policies. This can be huge cost savings to a customer as they are not forced to direct all traffic through a virtual L7 firewall appliance that they have bought for the public cloud which is billed based on the traffic that passes through it. And if that wasn't enough, service insertion with NSX Cloud requires no VPNs to compute VPCs/VNETs. More cost savings and less operational.
Micro-segmentation on Horizon Cloud for Azure: NSX Cloud now has a combined solution with Horizon Cloud for Azure. For customers who choose to have a Horizon VDI environment deployed in Azure, NSX Cloud will provide the necessary micro-segmentation and secure the VDI env.
Intent-Based Policy for Hybrid Workloads: The Cloud Service Manager (CSM) is now integrated with the NSX manager. Customers can now define a single intent-based policy from the Policy Manager without worrying about where the workloads are deployed or where they will move in the future. NSX Cloud will realize this policy in a consistent manner across on-premises DC, Azure and AWS.
Compatibility and System Requirements
For compatibility and system requirements information, see the NSX-T Data Center Installation Guide.
API and CLI Resources
See code.vmware.com to use the NSX-T Data Center APIs or CLIs for automation.
The API documentation is available from the API Reference tab. The CLI documentation is available from the Documentation tab.
Document Revision History
28th February. First edition.
- Fixed Issue 1842511: Multihop-BFD not supported for static routes
In NSX-T 2.0, BFD (Bi-Directional Forwarding Detection) can be enabled for a (MH-BGP) multihop BGP neighbor. The ability to back a multihop static route with BFD is not configurable in NSX-T 2.0, only BGP. Note that if you have configured a BFD backed multihop BGP neighbor and configure a corresponding multihop static route with the same nexthop as the BGP neighbor, the BFD session status affects both the BGP session as well as the static route.
- Fixed Issue 1931707: Auto-TN feature requires all hosts in the cluster to have the same pnics setup
When the auto-TN feature is enabled for a cluster, a transport node template is created to apply to all hosts in this cluster. All pnics in the template must be free on all hosts for TN configuration or the TN configuration might fail on those hosts whose pnics were missing or occupied.
- Fixed Issue 1909703: NSX admin is allowed to create new static routes, nat rules and ports in a router created by OpenStack directly from backend
As part of RBAC feature in NSX-T 2.0, resources like Switches, routers, Security Groups created by the OpenStack plugin cannot be deleted or modified directly by NSX admin from the NSX UI/API. These resources can only be modified/deleted by the APIs sent through the OpenStack plugin. There is a limitation in this feature. Currently NSX admin is only stopped from deleting/modifying the resources created by OpenStack, although admin is allowed to create new resources like static routes, nat rules inside the existing resources created by OpenStack.
- Fixed Issue 1989407: vIDM users with the Enterprise Admin role cannot override object protection
vIDM user with the Enterprise Admin role cannot override object protection and cannot create or delete Principal Identities.
- Fixed Issue 2030784: Cannot log in to NSX Manager with remote username that contains non-ASCII characters
You cannot log in to the NSX Manager appliance as a remote user with username containing non-ASCII characters.
- Fixed Issue 2111047: Application Discovery not supported on VMware vSphere 6.7 hosts in the NSX-T 2.2 release
Running application discovery on a security group which has VMs running on a vSphere 6.7 host causes the discovery session to fail.
- Fixed Issue 2157370: When configuring L3 Switched Port Analyzer (SPAN) with truncation, specific physical switch drops mirrored packets
When configuring L3 SPAN which includes GRE/ERSPAN with truncation, truncated mirrored packets are dropped because of the physical switch policy. A possible cause might be that the port is receiving packets where the number of bytes in the payload are not equal to type length field.
- Fixed Issue 2174583: In the Getting Started wizard, the Set Up Transport Nodes button does not work properly on the Microsoft Edge browser
- Fixed Issue 2114756: In some cases, VIBs are not removed when a host is removed from the NSX-T prepared cluster
When a host is removed form the NSX-T prepared cluster, some VIBs might remain on the host.
- Fixed Issue 2059414: RHEL LCP bundle installation fails due to older version of python-gevent RPM
If a RHEL host contains a newer version of the python-gevent RPM, then the RHEL LCP bundle installation fails because NSX-T Data Center RPM contains an older version of python-gevent RPM.
- Fixed Issue 2142755: OVS kernel modules fail to install depending on which minor RHEL 7.4 kernel version is running
OVS kernel modules fail to install on a RHEL 7.4 host running a minor kernel version 17.1 or above. The installation failure causes the kernel data paths to stop working which leads the appliance management console to become unavailable.
- Fixed Issue 2125725: After restoring large topology deployments, the search data becomes out of sync and several NSX Manager pages are unresponsive
After restoring NSX Manager with large topology deployments, the search data becomes out of sync and several NSX Manager pages display the error message, An unrecoverable error has occurred.
- Fixed Issue 2187888: Automatically deployed NSX Edge from the NSX Manager user interface remains in Registration Pending state indefinitely
Automatically deployed NSX Edge from the NSX Manager user interface remains in Registration Pending state indefinitely. This state causes the NSX Edge to become unavailable for further configuration.
- Fixed Issue 2077145: Attempting to forcefully delete the transport node in some cases might cause orphaned transport nodes
Attempting to forcefully delete the transport node using an API call where for example, there is a hardware failure and the hosts become irretrievable, changes the transport node state to Orphaned.
- Fixed Issue 2099530: Changing the bridge node VTEP IP address causes traffic outage
When the bridge node VTEP IP address is changed, the MAC table from VLAN to the overlay is not updated on the remote hypervisors causing traffic outage up to 10 minutes.
- Fixed Issue 2106176: NSX Controller automatic installation stalls during the Waiting to Register step of the installation
During the automatic installation of NSX Controllers using either the NSX Manager API or UI, the status of one of the in-progress NSX Controllers stalls and shows as Waiting to Register indefinitely.
- Fixed Issue 2125514: After layer 2 bridge failover, the logical switch on some NSX Edge VMs might do BUM replication of every single packet until the MAC is relearnt
After layer 2 bridge failover, the logical switch on some NSX Edge VMs might do BUM replication of every single packet for almost 10 minutes until the MAC is relearnt for the endpoint. The system recovers itself after the endpoints generate the next ARP.
- Fixed Issue 2183549: When editing a centralized service port, not able to view a newly created VLAN logical switch
In Manager UI, after you create a centralized service port and a new VLAN logial switch, if you edit the centralized service port, you cannot see the newly created VLAN logical switch.
- Fixed Issue 2186040: If a transport node is not among the top 250 uplink profiles in the system, the physical NICs' uplink drop-down is disabled in the user interface
If a transport node is not among the top 250 uplink profiles in the system, the physical NICs' uplink drop-down is disabled in the user interface. Saving the Transport Node results in the removal of the uplink name from the transport node.
- Fixed Issues 2106635: During the static routes creation, changing the admin distance of the NULL routes causes the next-hop NULL setting to disappear from the user interface
During the static routes creation, when the you set the Next Hop to NULL and change the admin distance of the NULL routes, the next-hop NULL setting disappears from the user interface.
- Fixed Issue 1928376: Controller cluster member node degraded status after restoring NSX Manager
Controller cluster member node might become unstable and report degraded health status if the NSX Manager is restored to a backup image that was taken before this member node was detached from the cluster.
- Fixed Issue 2128361: CLI command to set the log level of the NSX Manager to the debug mode not working properly
Using the CLI command set service manager logging-level debug to set the log level of the NSX Manager to debug mode not collecting debugging log information.
- Fixed Issue 1940046: When the same static route is added and advertised in multiple Tier-1 logical routers, east-west traffic fails
If the same static route is added and advertised in multiple Tier-1 logical routers, east-west traffic fails.
- Fixed Issue 2160634: Changing the IP address on a loopback can change the IP address of the router ID on an uplink
If the IP address on the loopback is changed, the NSX Edge selects the IP address on the uplink as the router ID. The IP address of the uplink which is assigned as the router ID cannot be changed.
- Fixed Issue 2199785: NGINX Core observed when adding health monitor (without port number) to dynamic pool (having port number)
When configuring Load Balancing with server pool having dynamic members (with port number) and then trying to associate a health monitor that does not have any monitoring port configured, nginx may crash.
The known issues are grouped as follows.
- General Known Issues
- Installation Known Issues
- NSX Manager Known Issues
- NSX Edge Known Issues
- Logical Networking Known Issues
- Security Services Known Issues
- KVM Networking Known Issues
- Load Balancer Known Issues
- Solution Interoperability Known Issues
- Operations and Monitoring Services Known Issues
- Upgrade Known Issues
- API Known Issues
- NSX Policy Manager Known Issues
- NSX Cloud Known Issues
- Issue 2239365: "Unauthorized" error is thrown
This error may result because the user attempts to open multiple authentication sessions on the same browser type. As a result, login will fail with above error and cannot authenticate. Log location:
Workaround: Close all open authentication windows/tabs and retry authentication.
- Issue 2287482: Auto-discovered bindings table may include bindings that are not currently discovered
Bindings that are marked "duplicate" in the auto-discovered bindings table might be no longer discovered.
- Issue 2278142: Switch IPFIX global profile is not editable
If Global profiles are available in the system, you cannot either modify or delete them through the interface as there is no workflow for Global profiles.
Workaround: Delete such Global Profile using the API.
- Issue 2292222: On Resolve Error screen, user is not notified if thumbprint is incorrect
If Host Preparation operation fails, the user can resolve the issue by clicking NSX Install Failed, in which case they need to provide username, password and thumbprint of host. If user gives incorrect thumbprint, the systems does not notify the user and the issue remains unresolved.
There is no clear way to know that thumbprint was incorrect. Check log where this ThumbPrintValidationFailedException is logged.
Workaround: Provide the correct thumbprint.
- Issue 2252487: Transport Node Status is not saved for BM edge transport node when multiple TN is added in parallel
The transport node status is not shown correctly in MP UI.
- Reboot the proton, all transport node status can be updated correctly.
- Or, use the API https://<nsx-manager>/api/v1/transport-nodes/<node-id>/status?source=realtime to query the transport node status.
- Issue 2285117: Kernel upgrade on NSX Managed VMs is not supported
On some Linux Ubuntu marketplace images, the kernel automatically upgrades itself on reboot of the VM. As a result, the nsx-agent does not function as expected. Although the NSX agent may appear to be functional, there will be some unrealized networking policies which affect the nsx-agent. The agent retries realizing these policies over and over, causing high CPU usage.
Workaround: If a kernel upgrade is required, the appropriate Linux-headers for that newer kernel have to be downloaded first and the openvswitch data path dkms package needs to be recompiled.
- Issue 2285544: MD5 hashes are no longer supported when invoking NSX APIs that require specifying a ssh_fingerprint value
NSX-T 2.4 no longer supports non-FIPS encryption algorithms, hashes, etc., which includes invoking the backup/restore, file-store and support bundle NSX APIs and specifying a MD5 hash for the ssh_fingerprint value. As a result, MD5 hashes are no longer supported.
Workaround: Specify a different hash computed using a different hashing algorithm, for example, SHA256.
- Issue 2256709: Instant clone VM or VM reverted from a snapshot loses AV protection briefly during vMotion
Snapshot of a VM is reverted and migrates the VM to another host. Partner console doesn't show AV protection for migrated instant clone VM. There is a brief loss of AV protection.
- Issue 2261431: Filtered list of datastores is required depending upon the other deployment parameters
Appropriate error on UI seen if incorrect option was selected. Customer can delete this deployment and create a new one to recover from error.
Workaround: Select shared datastore if you are creating a clustered deployment.
- Issue 2266553: In NSX appliance, a service may fail to initialize at its first boot
The deployed node is unable to serve requests, or unable to form a cluster.
Workaround: Try to restart the failed service.
- Issue 2267632: Loss of GI Protection configuration
Guest protection rule published on Policy UI shows SUCCESS. Corresponding change in the behavior is not reflected on the guest VM. OpsAgent logs at the same time shows restart. Loss of guest VM protection.
Workaround: Replay the configuration change manually.
- Issue 2269901: vmk interface is not included in packet capture CLI
This command cannot be issued.
Workaround: Use packet capture uw to do the same.
- Issue 2274988: Service chains do not support consecutive service profiles from the same service
Traffic does not traverse a service chain and it gets dropped whenever the chain has two consecutive service profiles belonging to the same service.
Workaround: Add a service profile from a different service to make sure that no two consecutive service profiles belong to the same service. Alternatively, define a third service profile which will perform the same operations of the two original ones concatenated, then use this third profile alone in the service chain.
- Issue 2275285: A node makes a second request to join the same cluster before the first request is complete and the cluster stabilized
The cluster may not function properly and the CLI commands get cluster status, get cluster config could return an error.
Workaround: Do not issue any new join command within 10 minutes to join the same cluster after the first join request.
- Issue 2275388: Loopback interface/connected interface routes could get redistributed before filters gets added to deny the routes
Unnecessary routes updates could cause the diversion on traffic for few seconds to min.
- Issue 2275708: Unable to import a certificate with its private key when the private key has a passphrase
The message returned is, "Invalid PEM data received for certificate. (Error code: 2002)". Unable to import a new certificate with private key.
- Create a certificate with private key. Do not enter a new passphrase when prompted; press Enter instead.
- Select "Import Certificate" and select the certificate file and the private key file.
Verify by opening the key-file. If a passphrase was entered when generating the key, the second line in the file will show something like "Proc-Type: 4,ENCRYPTED".
This line is missing if the key-file was generated without passphrase.
- Issue 2275985: Vnics not connected to logical switch are listed as options for NSGroup direct members
A vnic that is not connected to a logical switch is added as direct member of the NSGroup. Operation succeeds but the policies applied on that group do not get enforced on the vnic.
Check if a vnic is connected to a logical switch before adding it as a direct member of an NSGroup.
- Issue 2277742: Invoking PUT https://<MGR_IP>/api/v1/configs/management with a request body that sets publish_fqdns to true can fail if the NSX-T Manager appliance is configured with a fully qualified domain name (FQDN) instead of just a hostname
PUT https://<MGR_IP>/api/v1/configs/management cannot be invoked if a FQDN is configured.
Workaround: Deploy the NSX Manager using a hostname instead of a FQDN.
- Issue 2279249: Instant clone VM loses AV protection briefly during vMotion
Instant clone VM migrated from one host to another. Immediately after migration, eicar file is left behind on the VM. Brief loss of AV protection.
- Issue 2290669: As the number of virtual servers increases, the configuration time for each increases
As the number of virtual servers increases, the configuration time for each increases due to large numbers of validation. For the first 100 virtual servers, the average response time is around 1 second. After 250 virtual servers, the average response time increases to 5-10 seconds. After 450 virtual servers, the response time increases to around 30 seconds.
Workaround: None. You may be able to configure Virtual Servers as multiple LbServices depending on topology, otherwise expect slower response times when configuring large scale setups with virtual servers.
- Issue 2292116: IPFIX L2 applied to with CIDR-based group of IP addresses not listed on UI when group is created via the IPFIX L2 page
If you try to create a group of IP addresses from Applied to dialog and enter wrong IP address or CIDR in the Set Members dialog box, those members are not listed under groups. You have to edit that group again to enter valid IP addresses.
Workaround: Go to the groups listing page and add IP addresses in that group. Then that group can start populating in the Applied to dialog.
- Issue 2294821: NSX appliance information displays in the cluster monitoring dashboard with error "failure to delete node" with no guidance for user to handle the situation.
This issue has been observed after the user has tried to delete the auto-deployed node via the interface, and the powering off of the node has failed. If the cluster loses a node, you must manually add a new node and clean up the configuration states using the workaround below.
Workaround: Once appliance deletion through API/UI failed, delete that appliance manually using force-delete API, as follows:
Afterwards, destroy the VM from vCenter.
- Issue 2281095: When host which has svm deployed was re-added to same cluster, no callback triggered from EAM
All guest VMs could be unprotected. NSX UI will not come out of in-progress state.
Workaround: Remove SVM from host and then add it to cluster.
- Issue 1957072: Uplink profile for bridge node should always use LAG for more than one uplink
When using multiple uplinks that are not formed to a LAG, the traffic is not load balanced and might not work well.
Workaround: Use LAG for multiple uplinks on bridge nodes.
- Issue 1970750: Transport node N-VDS profile using LACP with fast timers are not applied to vSphere ESXi hosts
When an LACP uplink profile with fast rates is configured and applied to a vSphere ESXi transport node on NSX Manager, the NSX Manager shows that the profile is applied successfully, but the vSphere ESXi host is using the default LACP slow timer. On the vSphere hypervisor, you cannot see the effect of lacp-timeout value (SLOW/FAST) when the LACP NSX managed distributed switch (N-VDS) profile is used on the transport node from the NSX manager.
- Issue 2238093: Resolver not supported if NSX packages are forcefully removed
For uninstalling NSX from the host, the NSX packages are forcefully removed. This may result in corrupt state of NSX packages. Resolver for NSX package installation may not work successfully, if prior to resolver the NSX packages are removed forcefully. Log location:
Do not remove NSX packages forcefully. Uninstall the NSX components via standard steps described in NSX documentation.
- Issue 2288872: Install state shown as "Node not ready"
The Edge node is not getting onboarded. The Transport Node configuration state is Pending, and so cannot be added to an Edge cluster. Log location:
Workaround: Retry Edge node registration. Alternatively, power off the Edge node. When it starts it will establish the MP-MPA channel.
- Issue 2290770: In a scale setup with 40-50 hosts in a vCenter cluster, service deployment may take a long time to start
In a scale setup with 40-50 hosts in a vCenter cluster, service deployment is taking a long time to start intermittently, even though service deployment succeeds. If the NXGI service deployment API is used directly, the call takes time to return. The deployment time is usual, however, unaffected by this issue. You will have to wait longer to submit NXGI deploy requests.
Workaround: None. However, deployment is unaffected.
- Issue 2252776: Transport Node Profile fails to be applied on one of the cluster member hosts even if validation error that has occurred previously on the host is now resolved
TNP is applied on the cluster. But TNP cannot be applied on one of the cluster member hosts because one of the validations could not be passed (e.g., VMs are powered on on the host). User resolves the issue, but validation is still shown on UI and TNP is not automatically applied on that host.
Workaround: Move host out of cluster and add it again. This will trigger the activity to apply Transport Node Profile on the host.
- Issue 2284683: Not able to delete auto deployed appliance when a registered compute manager is deleted and added again
Deletion of appliance failed with error, "Failed to power-off" and stating compute manager is not found.
Workaround: Once appliance deletion through API/UI failed, delete that appliance manually using force-delete API, as follows: POST api/v1/cluster/nodes/deployments/<node-id>?action=delete&force_delete=true . Destroy the VM from VC.
- Issue 1957059: Host unprep fails if host with existing vibs added to the cluster when trying to unprep
If vibs are not removed completely before adding the hosts to the cluster, the host unprep operations fails.
Workaround: Make sure that vibs on the hosts are removed completely and restart the host.
- Issue 2296888: The Transport Node (TN)/Transport Node Profile (TNP) configuration cannot have both PNIC Only Migration flag set to true and VMK Mappings for Install populated across host switches
When giving a mismatch of configuration (both PNIC only migration flag set to true and VMK Mappings for Install populated across host switches) during CREATE, the following exception is seen:
VMK migration for host b17afc36-bbdc-491a-b944-21f73cf91585 failed with error [com.vmware.nsx.management.switching.common.exceptions.SwitchingException: TransportNode [TransportNode/b17afc36-bbdc-491a-b944-21f73cf91585] can not be updated or deleted while migrating ESX vmk interface null to [null].]. (Error code: 9418)
When giving a mismatch of configuration during UPDATE, the following exception is seen:
General error (Error code: 400)
An exception is seen when applying the TN/TNP configuration which contains both the PNIC Only Migration flag set to true and a vmk migration mapping.
Workaround: Each configuration sent to the host can either have PNIC only migration flag set to true or VMK Mappings for Install populated, but not both.
- Send the TN configuration with the host switches that require the PNIC Only Migration set to true.
- Update the TN configuration by setting all PNIC Only Migration flags to false and populate the VMK Mappings for Install as desired. In other words, ensure the configuration sent to the TN only has PNIC Only Migration flag set to true or VMK Mappings for Install populated across all host switches. Two separate configuration calls must be made for any configuration which requires both.
- Issue 2285306: Service deployment status for Guest Introspection services may remain in "Unknown" state until service VM gets powered on
After creating a Service Deployment and it is listed in the Service Deployment grid, the status may not immediately show as "In Progress" and may remain "Unknown" until the grid is refreshed.
Workaround: None. Refresh the page after ten seconds. The status should update.
- Issue 2292526: "Host not reachable” message shown when adding host
When adding an ESXi host, the “Host not reachable” message shows but does specify reason. The likely cause is incorrect credentials.
Workaround: Review host configuration, redo the credentials, and retry adding the host.
- Issue 2292701: User unable to update the sequence number in a binding map
The user cannot change the ordering or precedence of the profiles applied to an entity by updating the sequence number.
Workaround: Delete the binding map and recreate it with the new desired sequence number.
- Issue 2294345: Running Application Discovery Classification on a group with both ESXi-hosted and KVM-hosted VMs can fail
Application Discovery feature is only supported on ESXi hypervisors. For groups of VMs that are on mixed hosts that include unsupported hosts, Application Discovery Classification results are not guaranteed.
- Issue 2279326: No error is shown when creating an IPFIX L2 Collector with more than 4 IP:PORT combination
An error message is not shown for max no of IP:Port combinations allowed. There is no harm as the UI restricts tag creation if the maximum limit is exceeded.
- Issue 2248345: After installation of the NSX-T Edge, the machine boots up with blank black screen.
Unable to install NSX-T Edge on HPE ProLiant DL380 Gen9 machine.
Workaround: Use a different machine or deploy NSX-T Edge as VM on a Hypervisor.
- Issue 2252781: CLI returns error "% Command not found"
NSX Edge packet capture CLI using interface and direction as the only arguments result in an error.
Workaround: Provide additional arguments such as file, count and expression, in the packet capture CLI along with the direction. For example:
"start capture interface <interface-name> direction <capture-direction-arg> file <capture-file-arg> count <packet-count-arg> expression <packet-capture-expression-arg>"
Optionally, do not provide any additional arguments except for interface, in which case packets in both directions will be captured. For example:
"start capture interface <interface-name>"
- Issue 2283559: /routing-table and /forwarding-table MP APIs return an error if the edge has 65k+ routes for RIB and 100k+ routes for FIB
If the edge has 65k+ routes for RIB and 100k+ routes for FIB, the request from MP to Edge takes more than 10 seconds and results in a timeout. This is a read-only API and has an impact only if they need to download the 65k+ routes for RIB and 100k+ routes for FIB using API/UI.
Workaround: There are two options to fetch the RIB/FIB.
- These APIs support filtering options based on network prefixes or type of route. Use these options to download the routes of interest.
- CLI support in case the entire RIB/FIB table is needed and there is no timeout for the same.
- Issue 2243415: Customer unable to deploy NXGI service using Logical Switch (as a management network)
On the NXGI deployment screen, the user cannot see a logical switch in the network selection control. If the API is used directly with logical switch mentioned as management network, user will see the following error: "Specified Network not accessible for service deployment."
Workaround: Deploy using other type of switches like local or distributed.
- Issue 2264386: Transport Node deletion takes place even though the Transport Node is a part of NS Group
Transport Node deletion is permitted even when the node is part of an NS Group. Deletion should be prevented. If you encounter this issue, you must recreate the NS Groups and rebuild the relationships with its Transport Nodes.
Workaround: To prevent this issue, manually verify if a Transport Node is associated with any NS Groups. In the Management Plane interface, navigate to Advanced Networking Security > Inventory > Groups or to System > Nodes > Transport Nodes > Related > NSGroup.
- Issue 2292997: Certain logical router interfaces may fail to create for Linux network stack
Certain logical router interfaces may fail to create for Linux network stack, returning the following error:
errorCode="EDG0100002", Operation failed creating sub-interface: max sub-interface exceeded. As a result, traffic forwarded by tier0 service router (T0 SR) may be dropped due to missing routes.
Workaround: Reboot the affected Edge node.
- Issue 228688: BGP neighbor should be deleted first while deleting IPsec Route base session if BPG is configured over VTI
If BGP is configured over VTI and you delete the IPsec session, both SR will be in a down state which in turns blocks the traffic. In order to resume the traffic, the BGP neighbor configured for VTI should be deleted. In this scenario, only the BGP configured is over VTI.
Workaround: Delete the BGP neighbor before deleting the IPsec session.
- Issue 2288509: MTU property is not supported for Tier0/Tier1 service interface (central service port)
MTU property is not supported for Tier0/Tier1 service interface (central service port).
Workaround: Configure MTU using management plane API even though CSP port is created by Policy workflow.
- Issue 2288774: Segment port gives realization error due to tags exceeding 30 (erroneously)
User input incorrectly tries to apply more than 30 tags. However, the Policy workflow does not properly validate/reject the user input and allows the configuration. Then Policy then shows an alarm with the proper error message that the user should not use more than 30 tags. At that point the user can correct this issue.
Workaround: Correct the configuration after the error displays.
- Issue 2275412: Port connection doesn't work across multiple TZs
Port connection can be used only in single TZ.
- Issue 2290083: Validation missing when creating VLAN based segment
When you specify a VLAN transport zone with a VLAN ID property, the system fails to validate and identify the error. As a result, the intent will fail during realization and raise an error.
Workaround: See the Realization alarm error details for instructions to fix the input.
- Issue 2292096: CLI command "get service router config route-maps" returns an empty output
CLI command "get service router config route-maps" returns an empty output even when route-maps are configured. This is a display issue only.
Workaround: Use the CLI command
get service router configcommand, which returns route-map configuration as a subset of entire output.
- Issue 2994002: Tier1 not listed in Tier0/ Tier1 Gateway dropdown list for selection in DNS forwarder creation
On a large scale deployment with thousands of records, Tier1 is not listed in Tier0/ Tier1 Gateway dropdown list for selection in the DNS forwarder creation workflow. As a result, you must use the API to configure DNS forwarder creation.
Workaround: Perform the configuration using the API.
- Issue 2288523: Uploading NSX Guest Introspection driver can lead to security problems
IDFW relies on User identity information from NSX Guest Introspection driver. Unloading the driver can lead to security problems for users logged in from the specific Guest. This presents as the following symptoms:
- Firewall rules not enforced for users logged in from certain Guest VMs where Guest Introspection driver is unloaded.
- IDFW component not logged in user details for users logging in from certain guest VMs where Guest Introspection driver is unloaded.
- MUX logs don’t show any connections from these Guest VMs even though IDFW is enabled on the host.
- MUX logs don’t show any network events from these Guest VMs even though IDFW is enabled on the host.
As a result the default deny all rule can block access to logged in users from guest VMs where Guest Introspection driver is unloaded.
Workaround: None. The IT Administrator should follow security best practices to ensure no users are given privileges to unload Guest Introspection drivers inside Guest VMs.
- Issue 2288773: Old TLS protocol API still available, gets overwritten
NSX-T has new API for setting NSX TLS protocol versions and cipher suites, which updates all nodes in an NSX-T cluster. However, the old API is still available. This can be used but the new settings will be overwritten by the global settings.
Workaround: Use the new API.
- Issue 2291872: Log message shows a warning message when TFTP service is used in firewall rule
Log message shows irrelevant warning message when TFTP service is used in firewall rule.Log location on the ESXi node:
Workaround: Create a new service for TFTP as L4PortSet service and use it in firewall rule.
- Issue 2292995: The realization status is set to error even though all the configured rules are programmed in OVS
The API gives a false negative impression even when the DFW rules are programmed in the data plane.
Workaround: An update to any DFW rule clears this error condition. For example just toggling the rule logging forces the KVM DFW module to clear the error condition.
- Issue 2290899: IPSec VPN does not work, control plane realization for IPSec fails
IPSec VPN (or L2VPN) fails to comes up if more than 62 LbServers are enabled along with IPSec service on Tier-0 on the same Edge node.
Workaround: Reduce the number of LbServers to fewer than 62.
- Issue 2289150: PCM calls to AWS start to fail
If you update the PCG role for an AWS account on CSM from old-pcg-role to new-pcg-role, CSM updates the role for the PCG instance on AWS to new-pcg-role. However, the PCM does not know that the PCG role has been updated and as a result continues to use the old AWS clients it had created using old-pcg-role. This causes the PCM AWS cloud inventory scan and other AWS cloud calls to fail.
Workaround: If you encounter this issue, do not modify/delete the old PCG role immediately after changing to new role for at least 6.5 hours. Restarting the PCG will re-initialize all AWS clients with new role credentials.
- Issue 2275869: cfgAgent log rolling over in <1 minute on ESXi host if rules on the host have tags longer than 31 characters
Frequent log rollings may lead to loss of useful information in cfgAgent.log for debugging and troubleshooting on host. Log location on ESXi host:
- Issue 2287955: Management plane nodes may show high memory usage
In a normal deployed NSX-T 2.4 environment, management plane nodes may show high memory usage due to large amount of memory consumed by various management services. The NSX-T dashboard shows management plane memory usage in yellow.
Workaround: This can be ignored as there is no functional impact.
- Issue 2289984: mux_connectivity_status shows as CONNECTED even after nsx-context-mux service is stopped on host
When nsx-context-mux or nsx-opsagent is not running on the host, the system (NSX interface or service instance API) incorrectly shows Solution status and GI agent status as running with an unchanged timestamp. As a result, the guest VMs may lose AV protection.
Workaround: Try to manually start the mux and opsagent on the host if they are not already running.
- Log in to the host as root and execute following commands:
- After starting the agents, wait for a few minutes and verify that the health status timestamp on UI has updated.
- Log in to the host as root and execute following commands:
- Issue 2241406: A version 2.4 Edge node cannot register with a management plane of an earlier NSX version
This issue only occurs during the window in the upgrade process in which the management plane and the Edge node are in disparity. Logs can be viewed at
/var/log/nsxapi.logon the management place and
/var/log/nvpapi/api_server.logon the Edge node.
Workaround: Register new Edge node of same version as the management plane.
- Issue 2262159: Pre-upgrade check fails to check if a host has vSphere lockdown mode enabled
The pre-upgrade check features for lockdown mode and invalid vSAN group configuration are new and do not apply to the upgrade to 2.4.0.
Workaround: Before upgrading, manually check hosts for vSphere lockdown mode.
- Issue 2273737: After upgrading from NSX-T 2.3 to 2.4, the vIDM server details are missing
If using vIDM, users where the vIDM server is configured only on the NSX Policy appliance, the vIDM server is migrated in the upgrade but the vIDM server will be missing from the converged appliance.
Workaround: There are two options, depending on when the customer encounters this issue:
- Before upgrading from version 2.3 to 2.4:
Configure the same vIDM server details on both NSX Policy appliance and NSX Manager VM.
- After upgrading from version 2.3 to 2.4:
Reconfigure the same vIDM server details on the converged appliance.
- Before upgrading from version 2.3 to 2.4:
- Issue 2288549: RepoSync fails with checksum failure on manifest file
Observed in deployments recently upgraded to 2.4. When an upgraded setup is backed up and restored on a fresh deployed manager, the repository manifest checksum present in the database and the checksum of actual manifest file do not match. This causes the RepoSync to be marked as failed after backup restore.
Workaround: To recover from this failure, perform the following steps:
- Run CLI command
get service install-upgrade
Note the IP of "Enabled on" in the results.
- Log in to the NSX manager IP shown in "Enabled on" return of the above command.
- Navigate to System > Overview, and locate the node with the same IP as "Enabled on" return.
- Click Resolve on that node.
- After the above resolve operation succeeds, click Resolve on all nodes from the same interface.
All three nodes will now show RepoSync status as Complete.
- Run CLI command
- Issue 2279973: If a blank group is created and upgrade proceeds, after MP upgrade, that blank group shows as not started
This occurs If a blank group is created and upgrade proceeds.
Workaround: Do not create blank group.
Do one of the following to proceed:
- Delete the blank group
- Click a resume button to finish the upgrade
- Reset the plan
- Issue 2282389: UC upgrade plan not in sync with VC cluster membership if ESX is moved across clusters
When ESX is moved from one cluster to another in VC, the change is not reflected in UC upgrade plan. This may lead to more than one HOST entering maintenance mode at the same time if user has selected "Parallel Upgrade" across groups.
Workaround: On Host Upgrade page, click the "Reset" option to rebuild the plan so that UC upgrade plan is in sync with VC clusters.
- Issue 2288921: Upgrade status goes out of synch when old version Edge nodes are added
Upgrade status goes out of synch if the user adds Edge nodes of an older version following the Edge upgrade. This causes issues in continuing the upgrade call.
Workaround: First, avoid adding old version Edge nodes. If you do encounter this issue, restart the UC service.
- Issue 2291625: PCG upgrade status changes from SUCCESS to NOT_STARTED after upgrade plan synch
This issue is only encountered if the user upgrades the PCG and then tries to upgrade more Agents/PCG afterward.
In the recommended workflow, after PCG upgrade there are no more cross-cloud components to upgrade via the UC interface.
This is not impacting any functionality. The status of the previously successfully completed PCG upgrade is shown as "None" on the upgrade UI.
Workaround: None. Functionality should not be affected.
- Issue 2293227: After upgrade to 2.4, IDFW rules are not applied for VMs running VMTools 10.3.5
After performing a live NSX-T upgrade, IDFW rules are not applied for VMs running VMTools 10.3.5, resulting in possible loss of AV protection for those VMs.
Workaround: Restart the affected VMs.
- Issue 2295564: Edge node controller connectivity may go down after upgrading from 2.3 to 2.4
This is an intermittent issue that will impact some north-south traffic.
Workaround: Enable and disable maintenance mode on same edge node.
- Issue 2291267: PCM-created default gateway policy section has no sequence number assigned, so policy defaults it to 0
If a user creates gateway policies without sequence numbers or insert_top options, a policy conflict results. Log location:
Workaround: Prevent this issue by always creating policies with appropriate sequence_numbers or using url parameters
- Issue 2286524: Error when updating Intent due to Fabric Changes
System returns an error when updating Intent due to Fabric Changes such as Transport Zones, Edge Nodes, Edge Clusters. This is by design: NSX-T fabric configuration is automatically discovered on Policy periodically. When an Edge node is added or removed on the management plane, a corresponding intent object is created or deleted from Policy automatically.
Workaround: None. This is by design.
- Issue 2289278: Policy API throws error but allows configuration of multiple Virtual Servers with same pool with different persistence profile
The system does not support configuration of conflicting persistence types for the same pool for different LbVirtualServers. However, the Policy fails to properly validate/reject the conflicting input and allows the configuration. Subsequently, the Policy shows an alarm with the error message.
Workaround: If you encounter this issue, you can correct it by changing the group setting on the LbVirtualServer.
- Issue 2287884: Certain Centos marketplace images are not supported for NSX Cloud
Only the Centos marketplace images whose distribution versions match their expected minor kernel versions are supported for NSX Cloud.
For example the distribution versions and their corresponding kernel versions are expected to be as follows:
- RHEL 7.5 3.10.0-862
- RHEL 7.4 3.10.0-693
- RHEL 7.3 3.10.0-514
Workaround: Use only recommended Centos distributions as recommended in the documentation.
- Issue 2275232: DHCP would not work for VMs on cloud if DFWs Connectivity_statregy is changed from BLACKLIST to WHITELIST
All the VMs requesting for new DHCP leases would lose IPs. Need to explicitly allow DHCP for cloud VMs in DFW.
Workaround: Explicitly allow DHCP for cloud VMs in DFW.
- Issue 2277814: VM gets moved to vm-overlay-sg on invalid value for nsx.network tag
VM tagged with invalid nsx.network tag will get moved to vm-overlay-sg.
Workaround: Remove invalid Tag.
- Issue 2280663: Offboarding multiple VPCs in parallel could result in failures in rare cases
Offboarding of one of the compute VPCs would fail.
Workaround: Manually clean up VPC and corresponding groups on Policy.