← Back to branch summary

~ubuntu-branches/ubuntu/vivid/installation-guide/vivid-proposed

« back to all changes in this revision

Viewing changes to fi/boot-new/modules/ppp.xml

  • Committer: Bazaar Package Importer
  • Author(s): Frans Pop
  • Date: 2005-10-25 17:37:25 UTC
  • Revision ID: james.westby@ubuntu.com-20051025173725-aq0bm11be7bfd7rw
Tags: 20051025
http://bugs.debian.org/334925
* Mention in copyright that full GPL is included in the manual.
  Closes: #334925
* Register installed documents with doc-base.
* Minor updates in English text and translations.

Show diffs side-by-side

added added

removed removed

Lines of Context:
fi/boot-new/modules/ppp.xml
 
1
<!-- retain these comments for translator revision tracking -->
 
2
<!-- original version: 23660 untranslated -->
 
3
 
 
4
 <sect2 arch="not-s390" id="PPP">
 
5
 <title>Setting Up PPP</title>
 
6
 
 
7
<para>
 
8
 
 
9
If no network was configured during the first stage of the installation,
 
10
you will next be asked whether you wish to install the rest of the system
 
11
using PPP. PPP is a protocol used to establish dialup connections with modems.
 
12
If you configure the modem at this point, the installation system will be able
 
13
to download additional packages or security updates from the Internet during
 
14
the next steps of the installation.
 
15
If you don't have a modem in your computer or if you prefer to configure
 
16
your modem after the installation, you can skip this step.
 
17
 
 
18
</para><para>
 
19
 
 
20
In order to configure your PPP connection, you will need some information
 
21
from your  Internet Service Provider (ISP), including phone number, username,
 
22
password and DNS servers (optional). Some ISPs provide installation guidelines
 
23
for Linux distributions. You can use that information even if they don't
 
24
specifically target Debian since most of the configuration parameters
 
25
(and software) is similar amongst Linux distributions.
 
26
 
 
27
</para><para>
 
28
 
 
29
If you do choose to configure PPP at this point, a program named
 
30
<command>pppconfig</command> will be run.  This program helps you
 
31
configure your PPP connection.  <emphasis>Make sure, when it asks you
 
32
for the name of your dialup connection, that you name it
 
33
<userinput>provider</userinput>.</emphasis>
 
34
 
 
35
</para><para>
 
36
 
 
37
Hopefully, the <command>pppconfig</command> program will walk you
 
38
through a trouble-free PPP connection setup.  However, if it does not
 
39
work for you, see below for detailed instructions.
 
40
 
 
41
</para><para>
 
42
 
 
43
In order to setup PPP, you'll need to know the basics of file viewing
 
44
and editing in GNU/Linux.  To view files, you should use
 
45
<command>more</command>, and <command>zmore</command> for compressed
 
46
files with a <userinput>.gz</userinput> extension.  For example, to
 
47
view <filename>README.debian.gz</filename>, type <userinput>zmore
 
48
README.debian.gz</userinput>.  The base system comes with an editor
 
49
named <command>nano</command>, which is very simple to use, but does
 
50
not have a lot of features. You will probably want to install more
 
51
full-featured editors and viewers later, such as
 
52
<command>jed</command>, <command>nvi</command>,
 
53
<command>less</command>, and <command>emacs</command>.
 
54
 
 
55
</para><para>
 
56
 
 
57
Edit <filename>/etc/ppp/peers/provider</filename> and replace
 
58
<userinput>/dev/modem</userinput> with
 
59
<userinput>/dev/ttyS<replaceable>&num;</replaceable></userinput> where
 
60
<replaceable>&num;</replaceable> stands for the number of your serial
 
61
port. In Linux, serial ports are counted from 0; your first serial
 
62
port <phrase arch="i386">(i.e., <userinput>COM1</userinput>)</phrase>
 
63
is <filename>/dev/ttyS0</filename> under Linux.
 
64
 
 
65
<phrase arch="powerpc;m68k">On Macintoshes with serial ports, the
 
66
modem port is <filename>/dev/ttyS0</filename> and the printer port is
 
67
<filename>/dev/ttyS1</filename>.</phrase>
 
68
 
 
69
The next step is to edit
 
70
<filename>/etc/chatscripts/provider</filename> and insert your
 
71
provider's phone number, your user-name and password. Please do not
 
72
delete the <quote>\q</quote> that precedes the password. It hides the
 
73
password from appearing in your log files.
 
74
 
 
75
</para><para>
 
76
 
 
77
Many providers use PAP or CHAP for login sequence instead of text mode
 
78
authentication.  Others use both.  If your provider requires PAP or
 
79
CHAP, you'll need to follow a different procedure.  Comment out
 
80
everything below the dialing string (the one that starts with
 
81
<quote>ATDT</quote>) in
 
82
<filename>/etc/chatscripts/provider</filename>, modify
 
83
<filename>/etc/ppp/peers/provider</filename> as described above, and
 
84
add <userinput>user <replaceable>name</replaceable></userinput> where
 
85
<replaceable>name</replaceable> stands for your user-name for the
 
86
provider you are trying to connect to.  Next, edit
 
87
<filename>/etc/ppp/pap-secrets</filename> or
 
88
<filename>/etc/ppp/chap-secrets</filename> and enter your password
 
89
there.
 
90
 
 
91
</para><para>
 
92
 
 
93
You will also need to edit <filename>/etc/resolv.conf</filename> and
 
94
add your provider's name server (DNS) IP addresses.  The lines in
 
95
<filename>/etc/resolv.conf</filename> are in the following format:
 
96
<userinput>nameserver
 
97
<replaceable>xxx.xxx.xxx.xxx</replaceable></userinput> where the
 
98
<replaceable>x</replaceable>s stand for numbers in your IP
 
99
address. Optionally, you could add the
 
100
<userinput>usepeerdns</userinput> option to the
 
101
<filename>/etc/ppp/peers/provider</filename> file, which will enable
 
102
automatic choosing of appropriate DNS servers, using settings the
 
103
remote host usually provides.
 
104
 
 
105
</para><para>
 
106
 
 
107
Unless your provider has a login sequence different from the majority
 
108
of ISPs, you are done! Start the PPP connection by typing
 
109
<command>pon</command> as root, and monitor the process using
 
110
<command>plog</command> command. To disconnect, use
 
111
<command>poff</command>, again, as root.
 
112
 
 
113
</para><para>
 
114
 
 
115
Read <filename>/usr/share/doc/ppp/README.Debian.gz</filename> file for
 
116
more information on using PPP on Debian.
 
117
 
 
118
</para><para>
 
119
 
 
120
For static SLIP connections, you will need to add the
 
121
<userinput>slattach</userinput> command (from the
 
122
<classname>net-tools</classname> package) into
 
123
<filename>/etc/init.d/network</filename>. Dynamic SLIP will require
 
124
the <classname>gnudip</classname> package.
 
125
 
 
126
</para>
 
127
 
 
128
  <sect3 id="PPPOE">
 
129
  <title>Setting Up PPP over Ethernet (PPPOE)</title>
 
130
 
 
131
<para>
 
132
 
 
133
PPPOE is a protocol related to PPP used for some broadband connections.
 
134
There is currently no support in base configuration to help you set
 
135
this up. However, the necessary software has been installed, which means
 
136
you can configure PPPOE manually at this stage of the installation by
 
137
switching to VT2 and running <command>pppoeconf</command>.
 
138
 
 
139
</para>
 
140
 
 
141
  </sect3>
 
142
 </sect2>