PPPoE Client

From ImageStream Router Documentation

Jump to: navigation, search

Contents

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
Personal tools
Router software releases