PPPoE Client

From ImageStream Router Documentation

Contents 1 Introduction 2 Requirements 3 Sample Configurations 3.1 Basic configuration 4 Configuration Option Reference 4.1 protocol pppoe 4.1.1 Description 4.1.2 Parameters 4.1.3 Examples 4.2 adsl device interface 4.2.1 Description 4.2.2 Parameters 4.2.3 Examples 4.3 ppp {pap|chap) (sent-username|hostname) user password password 4.3.1 Description 4.3.2 Parameters 4.3.3 Examples 4.4 ip address {negotiated|IPv4_Address} 4.4.1 Description 4.4.2 Parameters 4.4.3 Examples 4.5 ppp multilink 4.5.1 Description 4.5.2 Examples

Introduction

As of version 4.2.2, Imagestream routers support client side Point-to-Point Protocol over Ethernet (PPPoE). Client side PPPoE support allows the router to establish a PPP session with a PPPoE server over an Ethernet connection. It is mainly used with ADSL services where individual users connect to the ADSL transceiver (modem) over Ethernet.

Requirements

You must have a router with at least Imagestream Linux 4.2.2

A valid Username/Password in order to authenticate with PPPoE server.

Sample Configurations

Basic configuration

In this example, we are going to assume the following:

• The Ethernet1 interface is connected to a network that the PPP session is being established over. For DSL application this interface would typically be directly connection to a DSL/ADSL modem.
• Your username is "joe" and password is "mypass123"

.

!
interface Ethernet1
!
interface ADSL0
 protocol pppoe
 adsl device Ethernet1
 ppp pap sent-username joe password mypass123
 ip address negotiated
!
ip route 0.0.0.0 0.0.0.0 ADSL0
!

Configuration Option Reference

protocol pppoe

Description

Set the protocol used on this interface. Currently only the pppoe protocol is supported.

Parameters

pppoe - Set the interface to use the PPPoE protocol.

Examples

protocol pppoe

adsl device interface

Description

Set the interface used to connect to the PPPoE network.

Parameters

interface- Name of the interface connected to the PPPoE network.

Examples

adsl device Ethernet1

ppp {pap|chap) (sent-username|hostname) user password password

Description

Sets the username/hostname and password to be used to authenticate the PPPoE session with the PPPoE server.

Parameters

pap- Sets the interface to use the Password Authentication Protocol for authentication.

chap- Sets the interface to use the Challenge Handshake Authentication Protocol for authentication.

sent-username user - Used for PAP authentication to set the username for this PPPoE client session.

hostname user - Used for CHAP authentication to set the username for this PPPoE client session.

password - Sets the password for this PPPoE client session.

Examples

ppp pap sent-username joe password mypass123

ppp chap hostname joe password mypass123

ip address {negotiated|IPv4_Address}

Description

Sets the IP address of the interface or sets the interface to negotiate the IP address when establishing the PPPoE session.

Parameters

negotiated- Negotiate the IP address to be assigned to this interface with the PPPoE when establishing the PPPoE session.

IPv4_Address - Series of four numbers, 0 to 255, separated by periods. For more information see the Wikipedia

Examples

ip address negotiated

ppp multilink

Description

Enable the PPP Multilink protocol option for this interface.

Examples

ppp multilink