<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<?xml-stylesheet href="docbook.xsl" type="text/xsl"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<article lang="pt_BR">
  <articleinfo>
    <title>Configurando PPPoE no <glossterm baseform="Debian GNU/Linux">Debian GNU/Linux</glossterm></title>
    <authorgroup>
      <author>
        <firstname>Leonardo</firstname>
        <othername>Serra Maciel de</othername>
        <surname>Campos</surname>
        <affiliation>
          <address>
            <email>linuxbh@brfree.com.br</email>
          </address>
        </affiliation>
      </author>
    </authorgroup>
    <revhistory>
      <revision>
        <revnumber>0.7</revnumber>
        <date>2005-05-23 22:44:15 -0300</date>
        <authorinitials>Leonardo Serra Maciel de Campos</authorinitials>
      </revision>
      <revision>
        <revnumber>0.8</revnumber>
        <date>2005-07-12 11:14:37 -0300</date>
        <authorinitials>Leonardo Serra Maciel de Campos</authorinitials>
      </revision>
    </revhistory>
    <copyright>
      <year>2004-2005</year>
      <holder>Leonardo Serra Maciel de Campos</holder>
    </copyright>
    <legalnotice>
      <para>Este documento é licenciado sobre a licença de Atribuição-Compartilhamento da Creative Commons. Para ver uma cópia desta licença, visite <ulink url="http://creativecommons.org/licenses/by-sa/2.0/"/> ou envie uma carta para Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA.</para>
    </legalnotice>
    <abstract>
      <para>Este documento visa ensinar como configurar o PPPoE no <glossterm baseform="Debian GNU/Linux">Debian GNU/Linux</glossterm>.</para>
    </abstract>
  </articleinfo>
  <sect1>
    <title>Introdução</title>
    <sect2>
      <title>O que é PPPoE?</title>
      <para>PPPoE é a sigla para <userinput>PPP over Ethernet</userinput>. PPP é a sigla para <userinput>Point-to-Point Protocol</userinput>. Traduzindo poderia ser interpretado como <userinput>Protocolo ponto a ponto sobre placa de rede</userinput>.</para>
      <para>Em termos genéricos, trata-se de uma ligação de alta velocidade que envolve dispositivos fisicos como, por exemplo, modem por cabo ou DSL.</para>
      <para>Atualmente varios provedores de banda larga utilizam ligações PPPoE, entre eles esta o Velox e o Speedy.</para>
    </sect2>
  </sect1>
  <sect1>
    <title>Ambiente</title>
    <para>Será presumido que o seu sistema <glossterm baseform="Debian GNU/Linux">Debian GNU/Linux</glossterm> e o aptitude estão corretamente configurados. Também estaremos acreditando que sua placa de rede esta conectada ao seu serviço de PPPoE e configurada. Caso tenha duvidas de como configurar sua placa de rede, recomendo a leitura da pagina de manual <userinput>interfaces</userinput>. Para isso, execute:</para>
    <screen><prompt>#</prompt> <userinput>man interfaces</userinput></screen>
    <warning>
      <para>É necessário que seu kernel Linux esteja compilado com suporte a ppp, você pode ter mais informações sobre isto no <userinput>ppp-howto</userinput>, em <ulink url="http://www.tldp.org/docs.html#howto"/>. O kernel Linux instalado pelo <glossterm baseform="Debian GNU/Linux">Debian GNU/Linux</glossterm> versão Sarge possue suporte a ppp.</para>
    </warning>
    <warning>
      <para>Todos os comandos deverão ser executados pelo usuário root!</para>
    </warning>
    <para>A tabelo abaixo mostra as versões de cada <glossterm baseform="Logicial">logicial</glossterm> usado.</para>
    <table>
      <title>Versão dos logiciais</title>
      <tgroup cols="2">
        <thead>
          <row>
            <entry>
              <glossterm baseform="Logicial">Logicial</glossterm>
            </entry>
            <entry>Versão</entry>
          </row>
        </thead>
        <tbody>
          <row>
            <entry>Debian GNU/Linux</entry>
            <entry>Sarge</entry>
          </row>
          <row>
            <entry>ppp</entry>
            <entry>2.4.3-20050321+2</entry>
          </row>
          <row>
            <entry>Kernel Linux</entry>
            <entry>2.6.8-2-386</entry>
          </row>
        </tbody>
      </tgroup>
    </table>
    <para>A tabelo abaixo mostra as principais características do ambiente onde foi feito esta documentação.</para>
    <table>
      <title>Ambiente</title>
      <tgroup cols="2">
        <tbody>
          <row>
            <entry>Usuário PPPoE</entry>
            <entry>
              <replaceable>usuario</replaceable>
            </entry>
          </row>
          <row>
            <entry>Senha PPPoE</entry>
            <entry>
              <replaceable>senha</replaceable>
            </entry>
          </row>
          <row>
            <entry>Sistema PPPoE</entry>
            <entry>
              <replaceable>provedor</replaceable>
            </entry>
          </row>
          <row>
            <entry>Placa de rede conectada ao serviço PPPoE</entry>
            <entry>
              <replaceable>eth0</replaceable>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </table>
    <note>
      <para>Usaremos palavras <replaceable>desta maneira</replaceable> para indicar substituição.</para>
    </note>
    <note>
      <para>Estou utilizando o Velox, sistema de banda larga da Telemar, aqui o meu <replaceable>usuario</replaceable> e <replaceable>senha</replaceable> são o meu numero de telefone.</para>
    </note>
  </sect1>
  <sect1>
    <title>Configuração</title>
    <orderedlist numeration="arabic">
      <listitem>
        <para>Edite o arquivo <filename>/etc/ppp/pap-secrets</filename>. Ao fim inclua a seguinte linha:</para>
        <screen><replaceable>usuario</replaceable> <replaceable>provedor</replaceable> <replaceable>senha</replaceable></screen>
      </listitem>
      <listitem>
        <para>Precisamos criar o arquivo <filename>/etc/ppp/peers/<replaceable>provedor</replaceable></filename> com o seguinte conteudo:</para>
        <screen>
user <replaceable>usuario</replaceable>
plugin rp-pppoe.so <replaceable>eth0</replaceable>
noipdefault
defaultroute
hide-password
lcp-echo-interval 20
lcp-echo-failure 3
noauth
persist
maxfail 0
mtu 1492
usepeerdns
</screen>
        <note>
          <itemizedlist>
            <listitem>
              <para>A linha contendo:</para>
              <screen>user <replaceable>usuario</replaceable></screen>
              <para>É onde fica o nome do usuário PPPoE.</para>
            </listitem>
            <listitem>
              <para>A linha contendo:</para>
              <screen>plugin rp-pppoe.so <replaceable>eth0</replaceable></screen>
              <para>É onde fica a placa de rede conectada ao serviço PPPoE.</para>
            </listitem>
            <listitem>
              <para>As linhas contendo:</para>
              <screen>
persist
maxfail 0
</screen>
              <para>Fazem com que em caso do pppd não conseguir conectar, ele tente infinitas vezes se conectar, assim garantindo uma maior probabilidade de você conseguir conexão em casos de erro.</para>
            </listitem>
            <listitem>
              <para>A linha contendo:</para>
              <screen>defaultroute</screen>
              <para>Faz com que o pppd coloque a inteface do serviço PPPoE como rota padrão para sua rede.</para>
            </listitem>
            <listitem>
              <para>A linha contendo:</para>
              <screen>usepeerdns</screen>
              <para>Faz com que o pppd escreva os endereços dos servidores de DNS fornecidos pelo serviço PPPoE no arquivo <filename>/etc/resolv.conf</filename>.</para>
            </listitem>
          </itemizedlist>
        </note>
      </listitem>
      <listitem>
        <para>Edite o arquivo <filename>/etc/network/interfaces</filename>. Este arquivo informa as configurações de cada interface de rede de nosso sistema.</para>
        <itemizedlist>
          <listitem>
            <para>Caso queira que sua interface ppp0 (que corresponde ao seu serviço de PPPoE) conecte automaticamente ao ligar o computador acrescente ao fim do arquivo o seguinte:</para>
            <screen>auto ppp0</screen>
          </listitem>
          <listitem>
            <para>Acrescente ao fim do arquivo o seguinte:</para>
            <screen>
iface ppp0 inet ppp
   provider <replaceable>provedor</replaceable>
</screen>
          </listitem>
        </itemizedlist>
      </listitem>
      <listitem>
        <para>Precisamos iniciar nossa conexão, para isto execute:</para>
        <screen><prompt>#</prompt> <userinput>ifup ppp0</userinput></screen>
      </listitem>
      <listitem>
        <para>Podemos acompanhar o andamento da conexão lendo o arquivo <filename>/var/log/syslog</filename>, para isto execute:</para>
        <screen><prompt>#</prompt> <userinput>tail -f <filename>/var/log/syslog</filename></userinput></screen>
      </listitem>
    </orderedlist>
  </sect1>
  <sect1>
    <title>Dicas</title>
    <orderedlist>
      <listitem>
        <para>O sistema PPPoE da Telemar, o Velox, exige que o cliente identifique qual provedor de serviço ele utiliza. Esta identificação é realizada através de um sítio acessivel em <ulink url="http://www.veloxzone.com.br"/>. Mas para a felicidade dos clientes, esta identificação pode ser realizada de maneira automatica. Para isto siga os passos abaixo.</para>
        <itemizedlist>
          <listitem>
            <para>Baixe o arquivo <filename>id-velox.pl</filename> em <ulink url="http://www.isec.com.br/velox/id-velox.pl"/>.</para>
          </listitem>
          <listitem>
            <para>Copie o arquivo <filename>id-velox.pl</filename> para a pasta <filename>/etc/ppp/ip-up.d/</filename>.</para>
          </listitem>
          <listitem>
            <para>Dentro do arquivo <filename>/etc/ppp/ip-up.d/id-velox.pl</filename> ficara o nome do seu usuario e sua senha do provedor de conteudo. Para garantir segurança iremos permitir que apenas o root possa acessar este arquivo. Também iremos permitir sua execução, pois o pppd irá executar ele automaticamente apos concluir a conexão. Para isto execute:</para>
            <screen>
<prompt>#</prompt> <userinput>chown root:root /etc/ppp/ip-up.d/id-velox.pl</userinput>
<prompt>#</prompt> <userinput>chmod 0700 /etc/ppp/ip-up.d/id-velox.pl</userinput>
</screen>
          </listitem>
          <listitem>
            <para>Edite o arquivo <filename>/etc/ppp/ip-up.d/id-velox.pl</filename> para configurar os dados do seu provedor de serviço. A configuração é simples e basta ler o arquivo para entender o que deve ser feito.</para>
          </listitem>
          <listitem>
            <para>Pronto! Após estes passos, toda vez que a conexão com o serviço PPPoE for iniciada a autenticação ira acontecer automaticamente.</para>
          </listitem>
        </itemizedlist>
      </listitem>
    </orderedlist>
  </sect1>
  <sect1>
    <title>Comandos úteis</title>
    <itemizedlist>
      <listitem>
        <para>Iniciar a conexão com o serviço PPPoE</para>
        <screen><prompt>#</prompt> <userinput>ifup ppp0</userinput></screen>
      </listitem>
      <listitem>
        <para>Parar a conexão com o serviço PPPoE</para>
        <screen><prompt>#</prompt> <userinput>ifdown ppp0</userinput></screen>
      </listitem>
      <listitem>
        <para>Monitorar o andamento da conexão</para>
        <screen><prompt>#</prompt> <userinput>tail -f <filename>/var/log/syslog</filename></userinput></screen>
      </listitem>
    </itemizedlist>
  </sect1>
  <bibliography>
    <title>Bibliografia</title>
    <para>Os seguintes sítios foram usados como base para a criação desta documentação</para>
    <biblioentry>
      <title>Scripts e Informacoes Velox</title>
      <releaseinfo><ulink url="http://www.isec.com.br/velox/"/></releaseinfo>
    </biblioentry>
    <biblioentry>
      <title>ABUSAR - Associação Brasileira dos Usuários de Acesso Rápido</title>
      <releaseinfo><ulink url="http://www.abusar.org/"/></releaseinfo>
    </biblioentry>
  </bibliography>
  <glossary>
    <title>Glossário</title>
    <glossentry>
      <glossterm>Debian GNU/Linux</glossterm>
      <glossdef>
        <para>O <ulink url="http://www.debian.org">Debian</ulink> é um sistema operacional (SO) livre para seu computador. Um sistema operacional é um conjunto de programas básicos e utilitários que fazem seu computador funcionar. O Debian usa o kernel (núcleo de um sistema operacional), <ulink url="http://www.kernel.org">Linux</ulink>, mas a maior parte das ferramentas do SO vêm do projeto <ulink url="http://www.gnu.org">GNU</ulink>; daí o nome GNU/Linux.</para>
      </glossdef>
    </glossentry>
    <glossentry>
      <glossterm>Logicial</glossterm>
      <glossdef>
        <para>Conjunto de instruções lógicas. Na informática designa um conjunto de instruções lógicas e suas dependências, também conhecido como programa ou sistema de computador.</para>
        <para>Esta palavra é pouco usada no Brasil, onde se usa muito a expressão "Software".</para>
        <para>Origem: <ulink url="http://pt.wikipedia.org/wiki/Logicial">Wikipédia, a enciclopédia livre.</ulink></para>
      </glossdef>
    </glossentry>
  </glossary>
</article>
