<para>To install the software, simply use the <link linkend="ports">

	  ports collection</link>. Install the

	  <filename role="package">net/pppoa</filename> port and follow the

	  instructions provided with it.</para>

	<sect2>

	  <title>Using pptpclient</title>

	  <para>It is also possible to use FreeBSD to connect to other PPPoA

	  sevices using <filename role="package">net/pptpclient</filename>.</para>

	  <para>To use <filename role="package">net/pptpclient</filename> to

	  connect to a DSL service, install the port or package and edit your

	  <filename>/etc/ppp/ppp.conf</filename>. You will need to be

	  <username>root</username> to perform both of these operations. An

	  example section of <filename>ppp.conf</filename> is given below.</para>

	  <programlisting>adsl:

 set log phase chat lcp ipcp ccp tun command

 set timeout 0

 enable dns

 set authname <replaceable>username</replaceable>

 set authkey <replaceable>password</replaceable>

 set ifaddr 0 0

 add default HISADDR</programlisting>

	  <para>This will open a tunnel for a PPP session to your DSL

	  router. Ethernet DSL modems have a preconfigured LAN IP address

	  which you connect to. In the case of the Alcatel Speedtouch Home

	  this address is <hostid role="ipaddr">10.0.0.138</hostid>. Your

	  routers documentation should tell you which address your device

	  uses. To open the tunnel and start a

	  <application>ppp</application> session execute the following

	  command.</para>

	  <screen>&prompt.root; pptp <replaceable>address</replaceable> <replaceable>isp</replaceable></screen>

	  <tip><para>You may wish to add a &amp; to the end of the previous

	  command because <application>pptp</application> will not return

	  your prompt to you otherwise.</para></tip>

	  <para>A <devicename>tun</devicename> virtual tunnel device will be

	  created for interaction between the <application>pptp</application>

	  and <application>ppp</application> processes. Once you have been

	  returned to your prompt, or the <application>pptp</application>

	  process has confirmed a connection can you examine the tunnel like

	  so.</para>

	  <screen>&prompt.user; ifconfig <replaceable>tun0</replaceable>

tun0: flags=8051<UP,POINTOPOINT,RUNNING,MULTICAST> mtu 1500

        inet 216.136.204.21 --> 204.152.186.171 netmask 0xffffff00 

        Opened by PID 918

	  </screen>

	  <para>If you are unable to connect check that the configurations

	  on your router, which are usually accessible via

	  <application>telnet</application> or with a web browser. If you

	  still cannot connect you should examine the output of the

	  <application>pptp</application> command and the contents of the

	  <application>ppp</application> log file,

	  <filename>/var/log/ppp.log</filename> for clues.</para>

	</sect2>