JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Managing Serial Networks Using UUCP and PPP in Oracle Solaris 11.1     Oracle Solaris 11.1 Information Library
search filter icon
search icon

Document Information

Preface

1.  Solaris PPP 4.0 (Overview)

2.  Planning for the PPP Link (Tasks)

3.  Setting Up a Dial-up PPP Link (Tasks)

4.  Setting Up a Leased-Line PPP Link (Tasks)

5.  Setting Up PPP Authentication (Tasks)

6.  Setting Up a PPPoE Tunnel (Tasks)

Major Tasks for Setting Up a PPPoE Tunnel (Task Maps)

Setting Up the PPPoE Client

Prerequisites for Setting Up the PPPoE Client

How to Configure an Interface for a PPPoE Client

How to Define a PPPoE Access Server Peer

Setting Up a PPPoE Access Server

How to Set Up a PPPoE Access Server

How to Modify an Existing /etc/ppp/pppoe File

How to Restrict the Use of an Interface to Particular Clients

7.  Fixing Common PPP Problems (Tasks)

8.  Solaris PPP 4.0 (Reference)

9.  Migrating From Asynchronous Solaris PPP to Solaris PPP 4.0 (Tasks)

10.  UUCP (Overview)

11.  Administering UUCP (Tasks)

12.  UUCP (Reference)

Index

Setting Up the PPPoE Client

To provide PPP to client systems over DSL, you must first configure PPPoE on the interface that is connected to the modem or hub. Then you need to change the PPP configuration files to define the access server on the opposite end of the PPPoE.

Prerequisites for Setting Up the PPPoE Client

Before you set up the PPPoE client, you must have done the following:

How to Configure an Interface for a PPPoE Client

Use this procedure to define the Ethernet interface to be used for the PPPoE tunnel.

  1. Become an administrator on the PPPoE client.

    For more information, see How to Use Your Assigned Administrative Rights in Oracle Solaris 11.1 Administration: Security Services.

  2. Add the name of the Ethernet interface with the DSL connection to the /etc/ppp/pppoe.if file.

    For example, you add the following entry to /etc/ppp/pppoe.if for a PPPoE client that uses hme0 as the network interface that is connected to the DSL modem.

    hme0

    For more information about /etc/ppp/pppoe.if, go to /etc/ppp/pppoe.if File.

  3. Configure the interface for PPPoE use.
    # /etc/init.d/pppd start
  4. (Optional) Verify that the interface is now plumbed for PPPoE.
    # /usr/sbin/sppptun query
    hme0:pppoe
    hme0:pppoed

    You can also use the /usr/sbin/sppptun command to manually plumb interfaces for PPPoE. For instructions, refer to /usr/sbin/sppptun Command.

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 an administrator on the PPPoE client.

    For more information, see How to Use Your Assigned Administrative Rights in Oracle Solaris 11.1 Administration: Security Services.

  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 Far ISP that is introduced in Example of a Configuration for a PPPoE Tunnel.

    # cat /etc/ppp/peers/dslserve
    sppptun
    plugin pppoe.so
    connect "/usr/lib/inet/pppoec hme0"
    noccp
    noauth
    user Red
    password redsecret
    noipdefault
    defaultroute

    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. /etc/ppp/options.sppptun defines PPP options for the serial port to which the interface that is plumbed for PPPoE is attached.

      You can use any options that are 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 of a Configuration for a PPPoE Tunnel. The debug updetach option causes debugging information to be displayed in a terminal window.

    If PPP is running correctly, the terminal output shows the link becoming 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

    Note - Users of configured PPPoE clients can begin running PPP over a DSL line by typing the following:

    % pppd call ISP-server-name

    Then the users can run an application or a service.


See Also

The following list provides references to related information.