PPPoE configuration

PPPoE is configured at the network interface PPPoE level.

To create a PPPoE interface, use the following command:

Admin@nodename# create network interface pppoe

Parameters:

Parameter

Description

enabled

Enable/disable a PPPoE interface:

  • on

  • off

interface-name

Enter a number to include in the interface name (for example, if you enter 1 the interface name will be ppp1).

description

PPPoE interface description.

alias

The interface's alias.

node-name

Cluster node name where the interface is created.

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.

config

Additional PPPoE interface parameters:

  • interface: interface where the PPPoE interface is created.

  • login: login name for PPPoE connection.

  • password: password for PPPoE connection.

  • persist-connection: automatic reconnection in case of connection failure:

    • on

    • off

  • auth-type: authorization type:

    • CHAP.

    • PAP.

  • holdoff: time period (in seconds) to restart the connection after it was broken.

  • default-route: use the PPPoE interface as the default route:

    • on

    • off

  • echo-intervall: interval to check the connection.

  • echo-failure: number of LCP echo failures after which UserGate assumes there is no connection and drops it.

  • providers-dns: use DNS servers provided by the ISP:

    • on

    • off

  • connection-attempts: number of unsuccessful connection attempts, after which auto-connection attempts will stop.

  • service-name: specify the service name if provided by the ISP.

mtu

Specify the MTU size. Set by default to a value of 1492 bytes compatible with the standard Ethernet frame size.

To update an existing PPPoE interface, use the following command:

Admin@nodename# set network interface pppoe <pppoe-name>

The parameters available for setting are the same as those for creating an interface, except for interface-name (you cannot change this parameter's value).

To delete a PPPoE interface, use the following command:

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

To display information about all PPPoE interfaces, use the following command:

Admin@nodename# show network interface pppoe

To display information about a single interface, use the following command:

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