← Back to branch summary

~qbalazs/installation-guide/lp1030336

« back to all changes in this revision

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

  • Committer: joeyh
  • Date: 2005-10-07 19:51:38 UTC
  • Revision ID: vcs-imports@canonical.com-20051007195138-c3d57b2617a79a4f
move manual to top-level directory, split out of debian-installer package

Show diffs side-by-side

added added

removed removed

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