Put in remaining pages and wiki contents.
[ikiwiki.git] / docs / handbook / handbook-ppp-troubleshoot.mdwn
1 \r
2 \r
3 ## 18.4 Troubleshooting PPP Connections \r
4 \r
5 ***Contributed by Tom Rhodes. ***\r
6 \r
7 This section covers a few issues which may arise when using PPP over a modem connection. For instance, perhaps you need to know exactly what prompts the system you are dialing into will present. Some ISPs present the `ssword` prompt, and others will present `password`; if the `ppp` script is not written accordingly, the login attempt will fail. The most common way to debug `ppp` connections is by connecting manually. The following information will walk you through a manual connection step by step.\r
8 \r
9 ### 18.4.1 Check the Device Nodes \r
10 \r
11 If you reconfigured your kernel then you recall the `sio` device. If you did not configure your kernel, there is no reason to worry. Just check the `dmesg` output for the modem device with:\r
12 \r
13     \r
14     #dmesg | grep sio\r
15 \r
16 \r
17 You should get some pertinent output about the `sio` devices. These are the COM ports we need. If your modem acts like a standard serial port then you should see it listed on `sio1`, or COM2. If so, you are not required to rebuild the kernel, you just need to make the serial device. You can do this by changing your directory to `/dev` and running the `MAKEDEV` script like above. Now make the serial devices with:\r
18 \r
19     \r
20     # sh MAKEDEV cuaa0 cuaa1 cuaa2 cuaa3\r
21 \r
22 \r
23 which will create the serial devices for your system. When matching up sio modem is on `sio1` or COM2 if you are in DOS, then your modem device would be `/dev/cuaa1`.\r
24 \r
25 ### 18.4.2 Connecting Manually \r
26 \r
27 Connecting to the Internet by manually controlling `ppp` is quick, easy, and a great way to debug a connection or just get information on how your ISP treats `ppp` client connections. Lets start  **PPP**  from the command line. Note that in all of our examples we will use ***example*** as the hostname of the machine running  **PPP** . You start `ppp` by just typing `ppp`:\r
28 \r
29     \r
30     # ppp\r
31 \r
32 \r
33 We have now started `ppp`.\r
34 \r
35     \r
36     ppp ON example> set device `/dev/cuaa1`\r
37 \r
38 \r
39 We set our modem device, in this case it is `cuaa1`.\r
40 \r
41     \r
42     ppp ON example> set speed 115200\r
43 \r
44 \r
45 Set the connection speed, in this case we are using 115,200 kbps.\r
46 \r
47     \r
48     ppp ON example> enable dns\r
49 \r
50 \r
51 Tell `ppp` to configure our resolver and add the nameserver lines to `/etc/resolv.conf`. If `ppp` cannot determine our hostname, we can set one manually later.\r
52 \r
53     \r
54     ppp ON example> term\r
55 \r
56 \r
57 Switch to ***terminal*** mode so that we can manually control the modem.\r
58 \r
59     \r
60     deflink: Entering terminal mode on `/dev/cuaa1`\r
61     type '~h' for help\r
62 \r
63 \r
64     \r
65     at\r
66         OK\r
67         atdt`***123456789***`\r
68 \r
69 \r
70 Use `at` to initialize the modem, then use `atdt` and the number for your ISP to begin the dial in process.\r
71 \r
72     \r
73     CONNECT\r
74 \r
75 \r
76 Confirmation of the connection, if we are going to have any connection problems, unrelated to hardware, here is where we will attempt to resolve them.\r
77 \r
78     \r
79     ISP Login:myusername\r
80 \r
81 \r
82 Here you are prompted for a username, return the prompt with the username that was provided by the ISP.\r
83 \r
84     \r
85     ISP Pass:mypassword\r
86 \r
87 \r
88 This time we are prompted for a password, just reply with the password that was provided by the ISP. Just like logging into DragonFly, the password will not echo.\r
89 \r
90     \r
91     Shell or PPP:ppp\r
92 \r
93 \r
94 Depending on your ISP this prompt may never appear. Here we are being asked if we wish to use a shell on the provider, or to start `ppp`. In this example, we have chosen to use `ppp` as we want an Internet connection.\r
95 \r
96     \r
97     Ppp ON example>\r
98 \r
99 \r
100 Notice that in this example the first `p` has been capitalized. This shows that we have successfully connected to the ISP.\r
101 \r
102     \r
103     PPp ON example>\r
104 \r
105 \r
106 We have successfully authenticated with our ISP and are waiting for the assigned IP address.\r
107 \r
108     \r
109     PPP ON example>\r
110 \r
111 \r
112 We have made an agreement on an IP address and successfully completed our connection.\r
113 \r
114     \r
115     PPP ON example>add default HISADDR\r
116 \r
117 \r
118 Here we add our default route, we need to do this before we can talk to the outside world as currently the only established connection is with the peer. If this fails due to existing routes you can put a bang character `!` in front of the `add`. Alternatively, you can set this before making the actual connection and it will negotiate a new route accordingly.\r
119 \r
120 If everything went good we should now have an active connection to the Internet, which could be thrown into the background using  **CTRL** + **z**  If you notice the `PPP` return to `ppp` then we have lost our connection. This is good to know because it shows our connection status. Capital P's show that we have a connection to the ISP and lowercase p's show that the connection has been lost for whatever reason. `ppp` only has these 2 states.\r
121 \r
122 #### Debugging \r
123 \r
124 If you have a direct line and cannot seem to make a connection, then turn hardware flow CTS/RTS to off with the `set ctsrts off`. This is mainly the case if you are connected to some  **PPP**  capable terminal servers, where  **PPP**  hangs when it tries to write data to your communication link, so it would be waiting for a CTS, or Clear To Send signal which may never come. If you use this option however, you should also use the `set accmap` option, which may be required to defeat hardware dependent on passing certain characters from end to end, most of the time XON/XOFF. See the [ppp(8)](http://leaf.dragonflybsd.org/cgi/web-man?command#ppp&section8) manual page for more information on this option, and how it is used.\r
125 \r
126 If you have an older modem, you may need to use the `set parity even`. Parity is set at none be default, but is used for error checking (with a large increase in traffic) on older modems and some ISPs. You may need this option for the Compuserve ISP.\r
127 \r
128  **PPP**  may not return to the command mode, which is usually a negotiation error where the ISP is waiting for your side to start negotiating. At this point, using the `~p` command will force ppp to start sending the configuration information.\r
129 \r
130 If you never obtain a login prompt, then most likely you need to use PAP or CHAP authentication instead of the UNIX┬« style in the example above. To use PAP or CHAP just add the following options to  **PPP**  before going into terminal mode:\r
131 \r
132     \r
133     ppp ON example> set authname `***myusername***`\r
134 \r
135 \r
136 Where `***myusername***` should be replaced with the username that was assigned by the ISP.\r
137 \r
138     \r
139     ppp ON example> set authkey `***mypassword***`\r
140 \r
141 \r
142 Where `***mypassword***` should be replaced with the password that was assigned by the ISP.\r
143 \r
144 If you connect fine, but cannot seem to find any domain name, try to use [ping(8)](http://leaf.dragonflybsd.org/cgi/web-man?command#ping&section8) with an IP address and see if you can get any return information. If you experience 100 percent (100%) packet loss, then it is most likely that you were not assigned a default route. Double check that the option `add default HISADDR` was set during the connection. If you can connect to a remote IP address then it is possible that a resolver address has not been added to the `/etc/resolv.conf`. This file should look like:\r
145 \r
146     \r
147     domain `***example.com***`\r
148     nameserver `***x.x.x.x***`\r
149     nameserver `***y.y.y.y***`\r
150 \r
151 \r
152 Where `***x.x.x.x***` and `***y.y.y.y***` should be replaced with the IP address of your ISP's DNS servers. This information may or may not have been provided when you signed up, but a quick call to your ISP should remedy that.\r
153 \r
154 You could also have [syslog(3)](http://leaf.dragonflybsd.org/cgi/web-man?command#syslog&section3) provide a logging function for your  **PPP**  connection. Just add:\r
155 \r
156     \r
157     !ppp\r
159 *.*     /var/log/ppp.log\r
160 \r
161 \r
162 to `/etc/syslog.conf`. In most cases, this functionality already exists.\r
163 \r
164 \r
165 \r
166 CategoryHandbook\r
167 CategoryHandbook-pppandslip\r