Unable to change the management IP address of an NSX Edge node via the NSX Manager GUI

Products

• VMware NSX

Issue/Introduction

In VMware NSX, users may find that they are unable to modify the management IP address of an existing Edge node directly through the NSX Manager Graphical User Interface (GUI). This limitation requires the configuration to be performed manually via the command-line interface (CLI).

• The option to edit the management IP is unavailable or grayed out in the NSX GUI.
• Attempts to change the IP do not persist or are not reflected in the management plane.
• Errors may occur when trying to update node network settings through the web portal.

Environment

VMware NSX

Cause

The NSX Manager GUI does not support direct modification of the eth0 management interface for an Edge node after it has been deployed. The management IP is a foundational setting for the node's connectivity to the management plane, and changes must be executed locally on the node to ensure the management plane is correctly updated.

Resolution

To change the management IP, you must access the Edge node via the VM console and use the CLI.

CAUTION: Restarting the NSX Edge dataplane service causes a momentary disruption to all traffic passing through that specific node. This action should only be performed during a planned maintenance window or while the node is in Maintenance Mode. Ensure High Availability (HA) is healthy and configured before starting to allow traffic to failover if necessary.

1. Log in to the Edge node VM console as the admin user.
2. Stop the dataplane service:

   stop service dataplane

3. Update the management interface (eth0) configuration using one of the following commands:
   • For a Static IP: set interface eth0 ip <x.x.x.x/24> gateway <x.x.x.x> plane mgmt
   • For DHCP: set interface eth0 dhcp plane mgmt
4. Start the dataplane service:

   start service dataplane