~ubuntu-branches/debian/sid/installation-guide/sid

« back to all changes in this revision

Viewing changes to en/appendix/pppoe.xml

  • Committer: Bazaar Package Importer
  • Author(s): Frans Pop, Frans Pop, Joey Hess, Wouter Verhelst
  • Date: 2007-03-19 15:00:12 UTC
  • Revision ID: james.westby@ubuntu.com-20070319150012-gt27pr4xu0ts4cps
Tags: 20070319
[ Frans Pop ]
* Cleaned up definitions of some entities and removed unused ones.
* Implement infrastructure that allows entities to be translated.
  Thanks to Miroslav Kure for providing the patch. Closes: #344048, #406515.
* Disable Korean PDF/PS formats for builds for the website.
* appendix/files: update information about mouse configuration, based on a
  patch from Peter Samuelson (for which thanks). Closes: #406290.
* boot-installer, appendix/preseed: document preseed/interactive parameter.

[ Joey Hess ]
* Fix package name for installation-reports, and manual unfuzzy of all
  translations. Closes: #408408

[ Frans Pop ]
* welcome:
  - make links to FSF and GNU more consistent (closes: #410317)
  - we do not necessarily share the ideals of the FSF (closes: #410129)
  Thanks to Francesco Poli for suggesting these changes.
* using-d-i: guided partitioning now creates swap inside LVM.
  Thanks to Francesco Poli. Closes: #411399.
* Document installs over PPPoE. Based on a text proposed by Eddy Petrisor.
  Closes: #408340.
* installation-howto: update for the integration of base-config into D-I.
* appendix/preseed:
  - as exim no longer asks any questions during installations, there is no
    real need to document it anymore
  - add link to Philip Hand's website as it contains many creative examples
  - document how to select the ftp protocol during mirror selection
  - document how to install from CD/DVD only (and not use a network mirror)
* Update base/standard system and task sizes.

[ Joey Hess ]
* Document debian-installer/allow_unauthenticated.

[ Wouter Verhelst ]
* Update mac68k installation after notes from Finn Thain, upstream mac68k
  kernel hacker.

[ Frans Pop ]
* Replace entity in example-preseed.txt file. Thanks to Geert Stappers for
  spotting the error. Closes: #413257.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!-- retain these comments for translator revision tracking -->
 
2
<!-- $Id: pppoe.xml 45405 2007-02-24 16:34:41Z fjp $ -->
 
3
 
 
4
 <sect1 id="pppoe" arch="not-s390">
 
5
 <title>Installing &debian; using PPP over Ethernet (PPPoE)</title>
 
6
 
 
7
<para>
 
8
 
 
9
In some countries PPP over Ethernet (PPPoE) is a common protocol for
 
10
broadband (ADSL or cable) connections to an Internet Service Provider.
 
11
Setting up a network connection using PPPoE is not supported by default
 
12
in the installer, but can be made to work very simply. This section
 
13
explains how.
 
14
 
 
15
</para><para>
 
16
 
 
17
The PPPoE connection set up during the installation will also be available
 
18
after the reboot into the installed system (see <xref linkend="boot-new"/>).
 
19
 
 
20
</para><para>
 
21
 
 
22
To have the option of setting up and using PPPoE during the installation,
 
23
you will need to install using one of the CD-ROM/DVD images that are
 
24
available. It is not supported for other installation methods (e.g.
 
25
netboot<phrase condition="supports-floppy-boot"> or floppy</phrase>).
 
26
 
 
27
</para><para>
 
28
 
 
29
Installing over PPPoE is mostly the same as any other installation. The
 
30
following steps explain the differences.
 
31
 
 
32
</para>
 
33
 
 
34
<itemizedlist>
 
35
<listitem><para>
 
36
 
 
37
Boot the installer with <userinput>modules=ppp-udeb</userinput> as boot
 
38
parameter. This means that at the boot prompt you should enter:
 
39
 
 
40
<informalexample><screen>
 
41
install modules=ppp-udeb
 
42
</screen></informalexample>
 
43
 
 
44
or, if you prefer using the graphical installer:
 
45
 
 
46
<informalexample><screen>
 
47
installgui modules=ppp-udeb
 
48
</screen></informalexample>
 
49
 
 
50
This will ensure the component responsible for the setup of PPPoE
 
51
(<classname>ppp-udeb</classname>) will be loaded and run automatically.
 
52
 
 
53
</para></listitem>
 
54
<listitem><para>
 
55
 
 
56
Follow the regular initial steps of the installation (language,
 
57
country and keyboard selection; the loading of additional installer
 
58
components<footnote>
 
59
 
 
60
<para>
 
61
 
 
62
The <classname>ppp-udeb</classname> component is loaded as one of
 
63
the additional components in this step. If you want to install at
 
64
medium or low priority (expert mode), you can also manually select
 
65
the <classname>ppp-udeb</classname> instead of entering the
 
66
<quote>modules</quote> parameter at the boot prompt.
 
67
 
 
68
</para>
 
69
 
 
70
</footnote>).
 
71
 
 
72
</para></listitem>
 
73
<listitem><para>
 
74
 
 
75
The next step is the detection of network hardware, in order to identify
 
76
any Ethernet cards present in the system.
 
77
 
 
78
</para></listitem>
 
79
<listitem><para>
 
80
 
 
81
After this the actual setup of PPPoE is started. The installer will probe
 
82
all the detected Ethernet interfaces in an attempt to find a PPPoE
 
83
concentrator (a type of server which handles PPPoE connections).
 
84
 
 
85
</para><para>
 
86
 
 
87
It is possible that the concentrator will not to be found at the first
 
88
attempt. This can happen occasionally on slow or loaded networks or with
 
89
faulty servers. In most cases a second attempt to detect the concentrator
 
90
will be successful; to retry, select <guimenuitem>Configure and start a
 
91
PPPoE connection</guimenuitem> from the main menu of the installer.
 
92
 
 
93
</para></listitem>
 
94
<listitem><para>
 
95
 
 
96
After a concentrator is found, the user will be prompted to type the login
 
97
information (the PPPoE username and password).
 
98
 
 
99
</para></listitem>
 
100
<listitem><para>
 
101
 
 
102
At this point the installer will use the provided information to establish
 
103
the PPPoE connection. If the correct information was provided, the PPPoE
 
104
connection should be configured and the installer should be able to use it
 
105
to connect to the Internet and retrieve packages over it (if needed). If
 
106
the login information is not correct or some error appears, the installer
 
107
will stop, but the configuration can be attempted again by selecting the
 
108
menu entry <guimenuitem>Configure and start a PPPoE connection</guimenuitem>.
 
109
 
 
110
</para></listitem>
 
111
</itemizedlist>
 
112
 
 
113
 </sect1>