System Administration Guide: Resource Management and Network Services

How to Define a PPPoE Access Server Peer

You define the access server in the /etc/ppp/peers/peer-name file. Many of the options that are used for the access server are also used to define the dial-in server in a dial-up scenario. For a detailed explanation of /etc/ppp/peers.peer-name, refer to /etc/ppp/peers/peer-name File.

  1. Become superuser on the PPPoE client.

  2. Define the service provider's PPPoE access server in the /etc/ppp/peers/peer-name file.

    For example, the following file, /etc/ppp/peers/dslserve, defines the access server dslserve at FarISP that are introduced in Example—Configuration for a PPPoE Tunnel.

    # cat /etc/ppp/peers/dslserve
    connect "/usr/lib/inet/pppoec hme0"
    user Red
    password redsecret

    For a definition of the options in this file, go to /etc/ppp/peers/peer-name File for Defining an Access Server Peer.

  3. Modify the other PPP configuration files on the PPPoE client.

    1. Configure /etc/ppp/options as described in the instructions for configuring a dial-out machine in Configuring the Dial-out Machine.

    2. Create an /etc/ppp/options.sppptun file to describe PPP options for the serial port to which the interface that is plumbed for PPPoE is attached.

      You can use any options available for the /etc/ppp/options.ttyname file that is described in /etc/ppp/options.ttyname Configuration File. You must name the file /etc/ppp/options.sppptun because sppptun is the specified device name in the pppd configuration.

  4. Ensure that all users can start PPP on the client.

    # touch /etc/ppp/options
  5. Test if PPP can run over the DSL line.

    # pppd debug updetach call dslserve

    dslserve is the name that is given to the access server at the ISP that is shown in Example—Configuration for a PPPoE Tunnel. The debug updetach option causes debugging information to display in a terminal window.

    If PPP is running correctly, the terminal output shows the link coming as it becomes active. If PPP still does not run, try the following command to see if the servers are running correctly:

    # /usr/lib/inet/pppoec -i hme0

Where to Go From Here


For Instructions 

Configure another PPPoE client 

Setting Up the PPPoE Client.

Learn more about PPPoE 

Creating PPPoE Tunnels for DSL Support.

Have users of configured PPPoE clients begin running PPP over the DSL line 

Instruct the users to type pppd call ISP-server-name and then run an application or service.

Troubleshoot PPPoE and PPP problems 

Chapter 35, Fixing Common Problems (Tasks).

Configure a PPPoE access server 

Setting Up a PPPoE Access Server.