From 5c2e3133143212fc017a88330ff3594bfec74770 Mon Sep 17 00:00:00 2001 From: Frans Pop Date: Sun, 18 Feb 2007 19:38:12 +0000 Subject: Document installs over PPPoE; based on a text proposed by Eddy Petrisor --- build/templates/docstruct.ent | 1 + debian/changelog | 4 +- en/appendix/pppoe.xml | 113 +++++++++++++++++++++++++++++++++++++++ en/appendix/random-bits.xml | 1 + en/boot-installer/parameters.xml | 4 +- 5 files changed, 120 insertions(+), 3 deletions(-) create mode 100644 en/appendix/pppoe.xml diff --git a/build/templates/docstruct.ent b/build/templates/docstruct.ent index 010464bb8..b28ca7656 100644 --- a/build/templates/docstruct.ent +++ b/build/templates/docstruct.ent @@ -188,6 +188,7 @@ + diff --git a/debian/changelog b/debian/changelog index 676d82567..fdf4b3901 100644 --- a/debian/changelog +++ b/debian/changelog @@ -18,11 +18,13 @@ installation-guide (2007xxxx) UNRELEASED; urgency=low Thanks to Francesco Poli for suggesting the changes. Closes: #410317. * 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. [ Joey Hess ] * Document debian-installer/allow_unauthenticated. - -- Frans Pop Sun, 18 Feb 2007 19:45:13 +0100 + -- Frans Pop Sun, 18 Feb 2007 20:34:28 +0100 installation-guide (20070122) unstable; urgency=low diff --git a/en/appendix/pppoe.xml b/en/appendix/pppoe.xml new file mode 100644 index 000000000..96dd3bcaa --- /dev/null +++ b/en/appendix/pppoe.xml @@ -0,0 +1,113 @@ + + + + + Installing &debian; using PPP over Ethernet (PPPoE) + + + +In some countries PPP over Ethernet (PPPoE) is a common protocol for +broadband (ADSL or cable) connections to an Internet Service Provider. +Setting up a network connection using PPPoE is not supported by default +in the installer, but can be made to work very simply. This section +explains how. + + + +The PPPoE connection set up during the installation will also be available +after the reboot into the installed system (see ). + + + +To have the option of setting up and using PPPoE during the installation, +you will need to install using one of the CD-ROM/DVD images that are +available. It is not supported for other installation methods (e.g. +netboot or floppy). + + + +Installing over PPPoE is mostly the same as any other installation. The +following steps explain the differences. + + + + + + +Boot the installer with modules=ppp-udeb as boot +parameter. This means that at the boot prompt you should enter: + + +install modules=ppp-udeb + + +or, if you prefer using the graphical installer: + + +installgui modules=ppp-udeb + + +This will ensure the component responsible for the setup of PPPoE +(ppp-udeb) will be loaded and run automatically. + + + + +Follow the regular initial steps of the installation (language, +country and keyboard selection; the loading of additional installer +components + + + +The ppp-udeb component is loaded as one of +the additional components in this step. If you want to install at +medium or low priority (expert mode), you can also manually select +the ppp-udeb instead of entering the +modules parameter at the boot prompt. + + + +). + + + + +The next step is the detection of network hardware, in order to identify +any Ethernet cards present in the system. + + + + +After this the actual setup of PPPoE is started. The installer will probe +all the detected Ethernet interfaces in an attempt to find a PPPoE +concentrator (a type of server which handles PPPoE connections). + + + +It is possible that the concentrator will not to be found at the first +attempt. This can happen occasionally on slow or loaded networks or with +faulty servers. In most cases a second attempt to detect the concentrator +will be successful; to retry, select Configure and start a +PPPoE connection from the main menu of the installer). + + + + +After a concentrator is found, the user will be prompted to type the login +information (the PPPoE username and password). + + + + +At this point the installer will use the provided information to establish +the PPPoE connection. If the correct information was provided, the PPPoE +connection should be configured and the installer should be able to use it +to connect to the Internet and retrieve packages over it (if needed). If +the login information is not correct or some error appears, the installer +will stop, but the configuration can be attempted again by selecting the +menu entry Configure and start PPPoE networking. + + + + + diff --git a/en/appendix/random-bits.xml b/en/appendix/random-bits.xml index e19709b0b..d3aa6bd33 100644 --- a/en/appendix/random-bits.xml +++ b/en/appendix/random-bits.xml @@ -6,6 +6,7 @@ &files.xml; &chroot-install.xml; &plip.xml; +&pppoe.xml; &graphical.xml; diff --git a/en/boot-installer/parameters.xml b/en/boot-installer/parameters.xml index 60a2b7cc7..514521f72 100644 --- a/en/boot-installer/parameters.xml +++ b/en/boot-installer/parameters.xml @@ -451,8 +451,8 @@ Can be used to automatically load installer components that are not loaded by default. Examples of optional components that may be useful are openssh-client-udeb (so you can use -scp during the installation) and -ppp-udeb (which supports PPPoE configuration). +scp during the installation) and +ppp-udeb (see ). -- cgit v1.2.3