Disclaimer: This document is provided “as-is”. We hope you find it useful. Unfortunately, at this time Primus cannot provide telephone support for FreeBSD users. These instructions assume that you are familiar with kernel compilation and basic UNIX commands. If you are not, please read the FreeBSD Handbook that came with your installation.

This procedure was successful with FreeBSD 3.4-RELEASE and should work with more recent versions of the OS as well. If you see something that seems wrong in these instructions, e-mail support-webmaster@primus.ca.

Read Me!

Please, before your start changing anything on your system, make appropriate backups! As well, check out the documentation on Freebsd.org, and appropriate manpages, especially for rc.conf and ppp.conf, and the LINT kernel configuration.

Kernel Configuration

Add the following lines to your kernel configuration and recompile:

# Enables PPPoE
  options NETGRAPH
  options NETGRAPH_SOCKET
  options NETGRAPH_PPPOE

Make sure that you have enabled the proper module for your network card: For example “xl” represents the 3com 3C-90x chipset.

ppp.conf Configuration

Add the following lines to your /etc/ppp.conf files.

primus:                               # Profile Name
    set log Phase Chat LCP IPCP CCP tun command
    set device PPPoE:xl0                # Where xl0 is your NIC code
    set authname XXXXXXXX@Xmm.primus.ca # Your Username
    set authkey XXXXXXXX                # Your Password
    set cd 5
    set timeout 120
    set ifaddr 10.0.0.1/0 10.0.0.2/0 255.255.255.0 0.0.0.0
    add default HISADDR

rc.conf Configuration

Add these lines to your /etc/rc.conf:

gateway_enable="NO"      # Is this machine acting as a gateway?
  network_interfaces="xl0 lo0"
  ifconfig_lo0="inet 127.0.0.1"
  ifconfig_xl0="inet 10.0.0.1 netmask 255.255.255.0"
  firewall_enable="NO"     # Set to "YES" if the machine acts as a gateway
  firewall_type="open"     # set to open to test, then restrict as needed

  ppp_enable="YES"         # Starts ppp daemon on boot up.
  ppp_mode="ddial"         # ddial for "always on", auto for "on demand" connect
  ppp_nat="NO"             # set to "YES" if you want IP masquerading
  ppp_profile="primus"     # ppp.conf profile to use

Top