Skip to main content

Configure Network Interfaces in Local UI

If your Edge host is deployed in an environment with custom networking requirements, such as segmented networks or shared physical interfaces, you can configure network settings directly from Local UI. Network configuration defines how the Edge host connects to physical and logical networks and can be adjusted both before and after the host joins a cluster. Local UI allows you to configure network interface controllers (NICs), virtual local area network (VLAN) interfaces, bonds, and bridges.

warning

Avoid modifying any settings associated with a NIC that is already in use within a cluster, as this can lead to irrecoverable failures.

Limitations​

  • In Agent mode, configuring network interfaces using Local UI is allowed only if the interfaces were created via Local UI or via the TUI. Pre-existing settings are read-only. If you attempt to update pre-existing network interfaces via Local UI, a new configuration is created alongside the existing one. To manage pre-existing configurations, use the original configuration method, such as systemd-networkd, Netplan, or NetworkManager.

Prerequisites​

  • An Edge host installed with Edge Installer 4.3 or later.

  • Network access to the Edge host's port where Local UI is exposed. The default port is 5080.

  • Credentials to log in to Local UI. You can log in with any OS user's credentials.

Configure the Management Interface​

The management interface handles Edge host management traffic, including Local UI access, communication between Edge hosts, and content synchronization. If no management interface is selected, the Edge host uses the network interface associated with the default route.

You can configure the management interface in the Edge Installer user-data file. A selection made in the TUI overrides the value from user-data. After initial setup, a selection made in Local UI overrides the value from the TUI.

  1. Log in to Local UI.

  2. From the Edge Host page, locate the Management Interface field.

  3. Select the interface to use for management traffic. Valid candidates include:

    • Physical NICs
    • Bonds, when not enslaved to another bond or a bridge
    • VLAN child interfaces
    • Bridges, with or without an IP address

    A NIC or bond that is enslaved to a bond or bridge, or that has VLAN children, is not a valid candidate.

  4. Click Confirm to save the change.

warning

Selecting a management interface does not change how the host routes network traffic. If multiple adapters use the same subnet and each adapter has a default route, traffic may leave through a different adapter than expected. For best results, place management and cluster traffic on separate subnets.

Configure NICs​

  1. Log in to Local UI.

  2. The Network Interfaces table on the Edge Host page displays NIC information, including the number of NICs and their status. Hover over the NIC count or status to display the list of NICs.

  3. Click Edit to display the detailed NICs information.

    info

    The interface currently used for Edge host management is not editable. This interface is locked by design to avoid breaking connectivity. The active management interface can be configured through user-data, the TUI, or Local UI. For more information, refer to Initial Edge Host Configuration with Palette TUI.

  4. Click the pencil icon next to the NIC you want to configure.

  5. Provide the following information.

    FieldDescription
    Config typeConfiguration type. The following options are available:
    - DHCP - automatically obtains Internet Protocol (IP) settings from a Dynamic Host Configuration Protocol (DHCP) server.
    - Static - uses manually configured IP settings.
    MTUMaximum transmission unit (MTU) defines the maximum packet size in bytes that can be transmitted on the interface without fragmentation. The default value is 1500.
    IP AddressThe unique Internet Protocol version 4 (IPv4) address used to identify the interface on the network. Only applicable for the Static configuration type.
    Subnet maskThe IPv4 subnet mask that defines the network and host portions of the IP address. Only applicable for the Static configuration type.
    GatewayThe IPv4 address of the router used to reach networks outside the local subnet. Only applicable for the Static configuration type.
    DNSOne or more IPv4 Domain Name System (DNS) server addresses used to translate hostnames into IP addresses.

  6. Click Confirm to save the changes.

Configure VLAN Interfaces​

  1. Log in to Local UI.

  2. Click the Create button in the VLAN Interfaces row of the Network Interfaces table.

  3. Provide the following information.

    FieldDescription
    Parent typeSpecifies the member interface type. The following options are available:
    - NIC - create the VLAN on a physical network interface .
    - Bond - create the VLAN on a bonded interface.
    Member interfaceSpecifies the parent interface (NIC or bond) on which the VLAN is created.
    VLAN IDThe numeric identifier used to tag traffic for the VLAN. Must be a number between 1 and 4094.
    Config typeConfiguration type. The following options are available:
    - DHCP - automatically obtains IP settings from a DHCP server.
    - Static - uses manually configured IP settings.
    MTUDefines the maximum packet size in bytes that can be transmitted on the VLAN interface without fragmentation. The default value is 1500.
    IP AddressThe unique IPv4 address used to identify the VLAN interface on the network. Only applicable for the Static configuration type.
    Subnet maskThe IPv4 subnet mask that defines the network and host portions of the IP address. Only applicable for the Static configuration type.
    GatewayThe IPv4 address of the router used to reach networks outside the local subnet. Only applicable for the Static configuration type.
    DNSOne or more IPv4 DNS server addresses used to translate hostnames into IP addresses.

  4. Click Confirm to save the changes. Local UI assigns the VLAN Name value automatically.

Configure Bonds​

  1. Log in to Local UI.

  2. Click the Create button in the Bonds row of the Network Interfaces table.

  3. Provide the following information.

    FieldDescription
    NameUnique bond name.
    Bond typeConfiguration type. The following options are available:
    - DHCP - automatically obtains IP settings from a DHCP server.
    - Static - uses manually configured IP settings.
    - None - creates an L2-only bond with no IP configuration. Use this option when the bond is enslaved to a bridge or carries only VLAN sub-interfaces that hold the L3 addressing. The IP Address, Subnet mask, Gateway, and DNS fields do not apply.
    Member interfaceSpecifies the physical NICs that are grouped together to form the bond. All selected member interfaces participate in the bonded interface according to the selected bonding mode.
    Bonding modeDefines how traffic is distributed across the member interfaces and how failover is handled. Review Bonding modes to learn more about the available options.
    Link monitoring interval (MIIMonitorSec)Specifies the interval, in seconds, at which the system checks the link status of each member interface. This value is used to detect link failures and trigger failover when supported by the bonding mode.
    MTUDefines the maximum packet size in bytes that can be transmitted on the interface without fragmentation. The default value is 1500.
    DNSOne or more IPv4 DNS server addresses used to translate hostnames into IP addresses.
    IP AddressThe unique IPv4 address used to identify the bridge interface on the network. Only applicable for the Static bond type.
    Subnet maskThe IPv4 subnet mask that defines the network and host portions of the IP address. Only applicable for the Static bond type.
    GatewayThe IPv4 address of the router used to reach networks outside the local subnet. Only applicable for the Static bond type.

  4. Click Confirm to save the changes.

Configure Bridges​

  1. Log in to Local UI.

  2. Click the Create button in the Bridges row of the Network Interfaces table.

  3. Provide the following information.

    FieldDescription
    NameUnique bridge name.
    Member interfaceSpecifies the interfaces that are attached to the bridge.
    Config typeConfiguration type. The following options are available:
    - DHCP - automatically obtains IP settings from a DHCP server.
    - Static - uses manually configured IP settings.
    - None - creates an L2-only bridge with no IP configuration. Use this option when the bridge carries only VM tenant traffic or VLAN sub-interfaces that hold the L3 addressing. The IP Address, Subnet mask, Gateway, and DNS fields do not apply.
    MTUDefines the maximum packet size in bytes that can be transmitted on the interface without fragmentation. The default value is 1500.
    DNSOne or more IPv4 DNS server addresses used to translate hostnames into IP addresses.
    IP AddressThe unique IPv4 address used to identify the interface on the network. Only applicable for the Static bond type.
    Subnet maskThe IPv4 subnet mask that defines the network and host portions of the IP address. Only applicable for the Static bond type.
    GatewayThe IPv4 address of the router used to reach networks outside the local subnet. Only applicable for the Static bond type.

  4. Click Confirm to save the changes.

Validate​

  1. Log in to your Edge Host via Secure Shell (SSH).

  2. Use the following command to validate the configuration type, MTU, IP address, and subnet mask of an interface (NIC, VLAN, Bond, or Bridge). Replace ens192 with the required interface name.

    ip addr show ens192
    Example output
    2: ens192: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000
     link/ether 00:50:56:b8:3d:21 brd ff:ff:ff:ff:ff:ff
     altname enp11s0
     inet 10.10.145.100/18 metric 100 brd 10.10.191.255 scope global dynamic ens192
    ...

    Review the output to verify the following:

    • The mtu value matches the MTU value configured in Local UI.
    • The inet value matches the IP Address and Subnet mask values configured in Local UI. Only applicable if the Config type (or Bond type for bonds) is set to Static.
    • The dynamic keyword is present if the Config type (or Bond type for bonds) value configured in Local UI is DHCP.

  3. Validate the gateway value only when the configuration type is set to Static. Use the following command.

    ip route show
    Example output
    default via 10.10.128.1 dev ens192 proto dhcp src 10.10.145.100 metric 100
    ...

    Verify that a default via <gateway-ip> route exists and matches the Gateway value configured in Local UI.

  4. Validate DNS only when you explicitly configured it in Local UI. For DHCP configurations, DNS values may be inherited automatically and you can ignore them. Use the following command. Replace ens192 with the required interface name.

    resolvectl dns ens192
    Example output
    Link 2 (ens192): 10.10.128.8
    ...

    Verify that the IP addresses listed after the interface name match the DNS values configured in Local UI.

  5. If you configured bonds, validate their member interfaces and bonding mode. Use the following command. Replace bond0 with the required bond name.

    cat /proc/net/bonding/bond0
    Example output
    ...
    Bonding Mode: IEEE 802.3ad Dynamic link aggregation
    ...
    Slave Interface: ens192
    ...
    Slave Interface: ens224
    ...

    Verify the following:

    • The Bonding Mode matches the value configured in Local UI.
    • The Slave Interface values match the Member interface values configured in Local UI.

  6. If you configured bridges, validate their member interfaces. Use the following command.

    bridge link show
    Example output
    3: bond0 state UP master br0
    5: ens192.100 state UP master br0

    Verify that each interface configured as a bridge member appears in the output with master <bridge-name>.

info

VLAN member interfaces do not require separate validation. A VLAN is always created on exactly one parent interface (NIC or bond), and this relationship is encoded in the VLAN interface name, for example, ens192.100 or bond0.200.