PPPoE Interfaces

This section shows you how to configure PPPoE Interfaces in the Gaia Portal and Gaia Clish.

The Point-to-Point Protocol over Ethernet (PPPoE) is a network protocol for encapsulating PPP frames inside Ethernet frames.

PPPoE is used mainly with DSL services, where individual users connect to the DSL modem over Ethernet and in plain Ethernet networks.

Notes:

  • The name of a PPPoE interface in Gaia is "pppoe<Tunnel ID>". For example, the name of a PPPoE interface with a Tunnel ID of 5 is "pppoe5".

  • Check Point cluster does not support this interface as a cluster interface.

  • Scalable Platforms (ElasticXL, Maestro, and Chassis) do not support this feature.

Configuring PPPoE Interfaces in Gaia Portal

Step

Instructions

1

In the navigation tree, click Network Management > Network Interfaces.

2

Make sure that the physical interface, on which you add a PPPoE interface, does not have an IP address.

3

Click Add > PPPoE.

4

In the Add PPPoE window, select the Enable option to set the PPPoE interface to UP.

5

On the PPPoE tab:

  • In the PPPoE ID field, enter or select the ID between 0 and 999.

    Note - This ID must be unique for every PPPoE interface.

  • In the Interface field, select the applicable physical interface.

    Gaia uses this interface to forward PPPoE frames.

  • In the User Name field, enter the username needed to connect to the PPPoE server at the Internet Service Provider (ISP). Get it from the ISP.

  • In the Password field, enter the password needed to connect to the PPPoE server at the Internet Service Provider (ISP). Get it from the ISP.

  • Optional: Select Use Peer DNS to allow the ISP to define the IPv4 DNS server for the Gaia. The ISP supplies either one IPv4 DNS server (the Primary) or two (Primary and Secondary).

    Important - If you select this option, the PPPoE Peer DNS servers overwrite the IPv4 DNS servers configured in Network Management > Hosts and DNS.

  • Optional: Select Use Peer as Default Gateway to make the ISP server the Default Gateway for the Gaia.

    Important - If you select this option, Gaia does not use anymore the Default Gateway configured in Network Management > IPv4 Static Routes.

9

Click OK.

Step

Instructions

1

In the navigation tree, click Network Management > Network Interfaces.

2

Select a PPPoE interface and click Edit.

3

Configure the applicable settings.

4

Click OK.

Note - You cannot change the PPPoE ID for an existing PPPoE interface. To change this ID, delete the PPPoE interface and then create a new PPPoE interface.

Step

Instructions

1

In the navigation tree, click Network Management > Network Interfaces.

2

Select a PPPoE interface and click Delete.

3

Click OK, when the confirmation message shows.

Configuring PPPoE Interfaces in Gaia Clish

Important - Make sure that the physical interface, on which you wish to add a VLAN interface, does not have an IP address.

Syntax

add pppoe client id <PPPoE ID> interface <Name of Physical Interface> user-name <PPPoE Username> {password <PPPoE Password> | password_hash <PPPoE Password Hash>} [use-peer-dns {on | off}] [use-peer-as-default-gateway {on | off}] 

set pppoe client id <PPPoE ID>
      fake-peer-address <IPv4 Address>
      interface <Name of Physical Interface>
      password <PPPoE Password>
      use-fake-peer-address {on | off}
      use-peer-as-default-gateway {on | off}
      use-peer-dns {on | off}
      user-name <PPPoE Username>

Note - You cannot change the PPPoE ID for an existing PPPoE interface. To change this parameters, delete the PPPoE interface and then create a new PPPoE interface.

show configuration pppoe

show pppoe client id<SPACE><TAB>

show pppoe client id <PPPoE ID>

delete pppoe client id <PPPoE ID>

Important - After you add, configure, or delete features, run the "save config" command to save the settings permanently. Scalable Platforms save the changes automatically.

Parameters

Parameter

Description

id <PPPoE ID>

Specifies the ID between 0 and 999.

Note - This ID must be unique for every PPPoE interface.

interface <Name of Physical Interface>

Specifies a local physical interface.

Gaia uses this interface to forward PPPoE frames.

user-name <PPPoE Username>

Specifies the username needed to connect to the PPPoE server at the Internet Service Provider (ISP). Get it from the ISP.

password <PPPoE Password>

Specifies the password needed to connect to the PPPoE server at the Internet Service Provider (ISP). Get it from the ISP.

password_hash <PPPoE Password Hash>

Specifies the hash of the password needed to connect to the PPPoE server at the Internet Service Provider (ISP). Get it from the ISP.

use-peer-dns {on | off}

Optional: Specifies whether to allow the ISP to define the IPv4 DNS server for the Gaia. The ISP supplies either one IPv4 DNS server (the Primary) or two (Primary and Secondary).

  • on - Allow

  • off - Do not allow

Important - If you enable this option, the PPPoE Peer DNS servers overwrite the IPv4 DNS servers configured with the "set dns" command.

use-peer-as-default-gateway {on | off}

Optional: Specifies whether to make the ISP server the Default Gateway for the Gaia

  • on - Allow

  • off - Do not allow

Important - If you enable this option, Gaia does not use anymore the Default Gateway configured with the "set static-route default" command.

fake-peer-address <IPv4 Address>

Optional. Configures the fake unicast peer IPv4 address (the default value is 0.0.0.0).

use-fake-peer-address {on | off}

Optional. Configures whether to use the configured fake peer IPv4 address:

  • on - Enabled

  • off - Disabled

 
gaia> add pppoe client id 1 interface eth0 user-name JohnDoe password 123456 use-peer-dns on