Adapter settings

Network adapters are configured at the network interface adapter level.

You cannot create a network adapter. To update an existing network adapter, use the command:

Admin@nodename# set network interface adapter <adapter_name>

Provide the following network adapter parameters:

Parameter

Description

enabled

Enable/disable a network interface:

  • on

  • off

description

Network interface description.

alias

The interface's alias.

iface-type

Interface type:

  • l3: interface works in Layer 3 mode (you can assign an IP address and use it in firewall, content filtering, and other rules; this is the standard interface operation mode).

  • mirror: interface works in Mirror mode (it can receive traffic from the network equipment SPAN port to analyze it).

iface-mode

IP address assignment mode:

  • dhcp: obtain a dynamic IP address via DHCP.

  • manual: no address.

Static mode is set automatically when an IP address is assigned to the interface.

zone

Zone to which the interface belongs.

link-info

Settings for network interface parameters:

  • bc_forwarding: control forwarding the directed broadcast packets arriving at the specified interface.

  • proxy_arp, proxy_arp_vlan: Proxy ARP mechanism. With proxy_arp, UserGate will respond to ARP requests for addresses outside the interface's network; with proxy_arp_vlan, UserGate will respond to ARP requests for addresses that belong to the interface's network.

To specify them, use the following format:

Admin@nodename# create network interface <iface-type> ... link-info [ key/value ]

where key is the parameter name. which can include lowercase Latin letters (a-z) and underscore (_), and

value is the parameter value. Parameter values can only be integers.

For example, use proxy_arp/1 to enable the Proxy ARP mechanism and proxy_arp/0 to disable it.

The link-info field is displayed only when adding parameters.

Important! You cannot delete the specified parameters.

netflow-profile

The Netflow profile to send statistical data to the Netflow collector. For more details on Netflow profile settings, see Configuring Netflow Profiles.

lldp-profile

Profile to send data using Link Layer Discovery Protocol (LLDP). For more details on configuring profiles, see Configuring LLDP Profiles.

ip-addresses

Assign an IP address to the interface.

The IP addresses are specified as [ <ip_address/mask> ] or [ <ip_address/mask> <ip_address/mask> ]. In case of several IP addresses (with space used as the separator), the subnet mask is entered in the decimal format.

Important! Make sure to separate the square brackets with spaces on both sides.

mac

Interface MAC address.

mtu

Specify the MTU size.

rx-ring

Buffer size of the RX ring interface of the adapter type.

tx-ring

Buffer size of the TX ring interface of the adapter type.

dhcp-relay

Settings for the DHCP relay on the interface. You need to specify the following:

  • enabled: enable/disable the relay:

    • on

    • off

  • utm-address: IP address of the UserGate interface on which the relay function is added (possible values: <ip | none>).

  • server-address: addresses of DHCP servers where DHCP requests from clients should be redirected.

To delete an adapter or its parameters, use the following command:

Admin@nodename# delete network interface adapter <adapter-name>

You can delete the following parameters:

Parameter

Description

ip-addresses

Specified IP address.

dhcp-relay server-address

DHCP server IP address.

To display information about all network adapters, use the following command:

Admin@nodename# show network interface adapter

To display the adapter information, use the following command:

Admin@nodename# show network interface adapter <adapter-name>