← Back to branch summary

~ubuntu-branches/ubuntu/raring/xubuntu-docs/raring

« back to all changes in this revision

Viewing changes to desktop-guide/internet/C/troubleshooting.xml

  • Committer: Package Import Robot
  • Author(s): Matthew East, Matthew East, Jeremy Bicha
  • Date: 2012-09-19 20:38:04 UTC
  • Revision ID: package-import@ubuntu.com-20120919203804-1t50gcb1xi8xbyzo
Tags: 12.10.1
[ Matthew East ]
* Complete rewrite of desktop-guide by Pasi Lallinaho
* Change to folder structure of desktop-guide to allow translations

[ Jeremy Bicha ]
* debian/control:
  - Bump Standards-Version to 3.9.3 and debhelper to 8
  - Don't build-depend on ubuntu-docs
* debian/preinst: Dropped, not needed after 12.04 LTS

Show diffs side-by-side

added added

removed removed

Lines of Context:
desktop-guide/internet/C/troubleshooting.xml
1
 
<?xml version="1.0" encoding="UTF-8"?>
2
 
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" 
3
 
        "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
4
 
<!ENTITY % globalent SYSTEM "../../libs/global.ent">
5
 
%globalent;
6
 
<!ENTITY % xubuntu-ent SYSTEM "../../libs/xubuntu.ent">
7
 
%xubuntu-ent;
8
 
<!ENTITY % xinclude SYSTEM "../../libs/xinclude.mod">
9
 
%xinclude;
10
 
<!ENTITY language "en">
11
 
<!ENTITY ubuntu '<phrase>Xubuntu</phrase>'>
12
 
]>
13
 
 
14
 
<section id="troubleshooting" status="review">
15
 
<title>Troubleshooting</title>
16
 
<para>Since the introduction of <application>NetworkManager</application>, connections can be enabled 
17
 
and disabled from the <application>NetworkManager</application>
18
 
icon in the <guilabel>System Notification Area</guilabel>.</para>
19
 
<important>
20
 
        <para>Before attempting any troubleshooting, ensure that the connection is enabled:</para>
21
 
        <orderedlist>
22
 
                <listitem><para>Right click the <application>NetworkManager</application> icon in the notification 
23
 
                area.</para></listitem>
24
 
                <listitem><para>Check <guilabel>Enable Networking</guilabel>.</para></listitem>
25
 
                <listitem><para>Check <guilabel>Enable Wireless</guilabel>.</para></listitem>
26
 
        </orderedlist>
27
 
</important>
28
 
        <section id="troubleshooting-lan" status="review">
29
 
                <title>Wired troubleshooting</title>
30
 
                <para>If you have a network connection that is not working properly, you can use a few tools to help 
31
 
                diagnose what the problem is.</para>
32
 
                <para>Most of the tools in this section require use of the <application>Terminal</application>, which 
33
 
                you can open by pressing &terminal;.</para>
34
 
 
35
 
                <section id="network-troubleshooting-ifconfig" status="review">
36
 
                        <title>Get Information About the Current Connection</title>
37
 
                        <para><application>ifconfig</application> is intended to allow you to change the settings of 
38
 
                        your network connections, but it can also be used to list information about the current 
39
 
                        connection.</para>
40
 
                        <orderedlist>
41
 
                                <listitem><para>Press &terminal; to open a Terminal</para></listitem>
42
 
                                <listitem>
43
 
                                        <para>Type the following in the Terminal and press <keycap>Enter</keycap>:</para>
44
 
                                                <screen><command>ifconfig</command></screen> 
45
 
                                         <para>
46
 
                                        The following information is a portion of the computer output of the command:
47
 
                                        </para>
48
 
                                        <itemizedlist>
49
 
                                                <listitem><para><emphasis role="strong">logical</emphasis> or 
50
 
                                                connection name(s) of the various wired or wireless network devices 
51
 
                                                your computer may have is located in the left column (i.e. 
52
 
                                                <computeroutput>eth1</computeroutput>)</para></listitem>
53
 
                                                <listitem><para>in the right column, <emphasis 
54
 
                                                role="strong">inet addr</emphasis> gives the current <emphasis>IP 
55
 
                                                address</emphasis> (i.e. 192.168.0.100) of the corresponding network 
56
 
                                                device</para></listitem>
57
 
                                                <listitem><para><emphasis role="strong">HWaddr</emphasis> gives the 
58
 
                                                <emphasis>MAC address</emphasis> of your network device</para>
59
 
                                                </listitem>
60
 
                                        </itemizedlist>
61
 
                                </listitem>
62
 
                        </orderedlist>
63
 
                </section>
64
 
                
65
 
                <section id="network-troubleshooting-ping" status="review">
66
 
                        <title>Check If a Connection Is Working Properly</title>
67
 
                        <para>A good way of checking if a connection is working properly is to <emphasis>ping
68
 
                        </emphasis> another computer on the network or the Internet.</para>
69
 
                        <para>To check if you are connected to the Internet:</para>
70
 
                        <orderedlist>
71
 
                                <listitem><para>Open a <application>Terminal</application> (&terminal;) and type the 
72
 
                                command:</para>
73
 
                                                <screen><command>ping -c 3 www.xubuntu.org</command></screen>
74
 
                                </listitem>
75
 
                                <listitem>
76
 
                                        <para>The terminal will display three instances of your computer attempting to 
77
 
                                        ping <emphasis><ulink url="www.xubuntu.org"></ulink></emphasis>. Look at the 
78
 
                                        <emphasis>ping statistics</emphasis> section that displays how many packets 
79
 
                                        were transmitted, how many were receieved, the percentage of packet loss and 
80
 
                                        the total time that transpired to send the 3 packets to <emphasis>
81
 
                                        <ulink url="www.xubuntu.org"></ulink></emphasis>.</para>
82
 
                                        <itemizedlist>
83
 
                                                <listitem><para><emphasis>0% packet loss</emphasis> - Your computer 
84
 
                                                should have a good connection to the Internet</para></listitem>
85
 
                                                <listitem><para><emphasis>Greater than 0% but less than 100% packet 
86
 
                                                loss</emphasis> - Your computer probably has a poor connection to the 
87
 
                                                Internet or a poor wireless signal</para></listitem>
88
 
                                                <listitem><para><emphasis>100% packet loss</emphasis> - Your computer 
89
 
                                                has a very bad connection, or is connected to an access point or router 
90
 
                                                that is not connected to the Internet</para></listitem>
91
 
                                        </itemizedlist>
92
 
                                </listitem>
93
 
                        </orderedlist>
94
 
                        <para>If you get an error message that says <quote><ulink url="www.xubuntu.org"></ulink>
95
 
                        can not be found</quote> or <quote>unknown host</quote>, then your computer is probably not 
96
 
                        connected to the Internet or can not reach a <emphasis>Domain Name System (<acronym>DNS</acronym>) server</emphasis>.</para>
97
 
                </section>
98
 
        </section>
99
 
        
100
 
        <section id="troubleshooting-wireless" status="review">
101
 
                <title>Wireless Troubleshooting</title>
102
 
                <para>While not exhaustive, this section covers some common problems faced with wireless support.</para>
103
 
                <para>There is much more information available from the <ulink url="https://help.ubuntu.com/community/WifiDocs">
104
 
                Community Documentation</ulink>.</para>
105
 
                <note><para>This troubleshooting guide is designed to be carried out in order. If you reach the end of 
106
 
                a section and are not directed to another - then try <xref linkend="connecting-wireless"/> and should 
107
 
                it fail begin at the start again.</para></note>
108
 
                <section id="troubleshooting-wireless-disabled" status="review">
109
 
                        <title>Check That the Device Is On</title>
110
 
                        <orderedlist>
111
 
                                <listitem><para>Many wireless network devices can be turned on or off. Check to see if 
112
 
                                there is a hardware switch, some devices can be switched off from Windows and may need 
113
 
                                to be turned back on from Windows.</para></listitem>
114
 
                                <listitem><para>If it is turned on then see <xref linkend="troubleshooting-wireless-device"/>.</para></listitem>
115
 
                        </orderedlist>
116
 
                </section>
117
 
                <section id="troubleshooting-wireless-device" status="review">
118
 
                        <title>Check for Device Recognition</title>
119
 
                        <para>Open a <application>Terminal</application> (&terminal;) and type the command:</para> 
120
 
                                <screen><command>sudo lshw -C network</command></screen>                        
121
 
                        <para>You should see an output, along with the words <computeroutput>CLAIMED, UNCLAIMED, 
122
 
                        ENABLED or DISABLED</computeroutput></para>
123
 
                        <orderedlist>                           
124
 
                                <listitem><para>CLAIMED - this indicates a driver is loaded but not functioning, see 
125
 
                                <xref linkend="troubleshooting-wireless-ndiswrapper"/></para></listitem>
126
 
                                <listitem><para>UNCLAIMED - there is no driver loaded, see 
127
 
                                <xref linkend="troubleshooting-wireless-ndiswrapper"/>.</para></listitem>
128
 
                                <listitem><para>ENABLED - move on to see if there is a driver listed then see 
129
 
                                <xref linkend="troubleshooting-wireless-connection" />.</para></listitem>
130
 
                                <listitem><para>DISABLED - see <xref linkend="troubleshooting-wireless-disabled"/>.
131
 
                                </para></listitem>
132
 
                        </orderedlist>
133
 
                </section>
134
 
                <section id="troubleshooting-wireless-ndiswrapper" status="review">
135
 
                        <title>Using Windows Wireless Drivers</title>
136
 
                        <para>Xubuntu supports a system known as <application>NDISWrapper</application>. This allows 
137
 
                        you to use a Windows wireless device driver under Xubuntu.</para>
138
 
                        <orderedlist>
139
 
                                <listitem><para>Obtain the Windows driver for your system and locate the file that ends 
140
 
                                with <filename class="extension">.inf</filename>.</para></listitem>
141
 
                                <listitem><para><ulink url="apt:ndisgtk">Install the <application>ndisgtk</application> 
142
 
                                package</ulink>.</para></listitem>
143
 
                                <listitem><para>Open <application>ndisgtk</application> (&ndisgtk;).</para></listitem>
144
 
                                <listitem><para>Select <guilabel>Install new driver</guilabel>.</para></listitem>
145
 
                                <listitem><para>Choose the location of your Windows <filename class="extension">.inf
146
 
                                </filename> file and click <guibutton>Install</guibutton>.</para></listitem>
147
 
                                <listitem><para>Click <guibutton>OK</guibutton>.</para></listitem>
148
 
                        </orderedlist>
149
 
                </section>
150
 
                <section id="troubleshooting-wireless-connection" status="review">
151
 
                        <title>Check for a Connection to the Router</title>
152
 
                        <orderedlist>
153
 
                                <listitem><para>Open a <application>Terminal</application> (&terminal;) and type the 
154
 
                                command: 
155
 
                                        <screen><command>iwconfig</command></screen>
156
 
                                </para></listitem>
157
 
                                <listitem><para>If the ESSID for your router is shown there may be a problem with ACPI 
158
 
                                support. Boot the kernel with the <userinput>pci=noacpi</userinput> option.</para></listitem>
159
 
                        </orderedlist>
160
 
                </section>      
161
 
                <section id="troubleshooting-wireless-ip" status="review">
162
 
                        <title>Check IP Assignment</title>
163
 
                        <orderedlist>
164
 
                                <listitem><para>Open a <application>Terminal</application> (&terminal;) and type the 
165
 
                                command: 
166
 
                                        <screen><command>ifconfig</command></screen>
167
 
                                </para></listitem>
168
 
                                <listitem><para>If there is an IP address, shown see <xref linkend="troubleshooting-wireless-dns"/>.</para></listitem>
169
 
                                <listitem><para>From the <application>Terminal</application> enter the command:</para> 
170
 
                                        <screen><command>sudo dhclient <replaceable>eth1</replaceable></command></screen> 
171
 
                                <para>replace <replaceable>eth1</replaceable> with the name of the connection 
172
 
                                outputted from the <command>ifconfig</command> command.</para></listitem>
173
 
                                <listitem><para>If you receive a message that says <command>bound to xxx.xxx.xxx.xxx
174
 
                                </command> then see <xref linkend="troubleshooting-wireless-dns"/></para></listitem>
175
 
                                <listitem><para>If not, then reboot the system.</para></listitem>
176
 
                        </orderedlist>
177
 
                </section>
178
 
                <section id="troubleshooting-wireless-dns" status="review">
179
 
                        <title>Check DNS</title>
180
 
                        <orderedlist>
181
 
                                <listitem><para>Open a <application>Terminal</application> (&terminal;) and type the 
182
 
                                command:
183
 
                                        <screen><command>ping -c 3 91.189.94.141</command></screen>
184
 
                                </para></listitem>
185
 
                                <listitem><para>Now type the command:</para>
186
 
                                        <screen><command>ping -c 3 www.xubuntu.org</command></screen> 
187
 
                                <para>If you get a response from both commands, then see 
188
 
                                <xref linkend="troubleshooting-wireless-ipv6"/>.</para></listitem>
189
 
                                <listitem><para>Type the command:</para>
190
 
                                        <screen><command>cat /etc/resolv.conf</command></screen>
191
 
                                <para>If there is no nameserver listed, then contact your Internet Service Provider 
192
 
                                (<acronym>ISP</acronym>), and find out your primary and secondary domain name servers. 
193
 
                                Once you have this information see <xref linkend="connecting-wireless"/>.
194
 
                                </para></listitem>
195
 
                        </orderedlist>
196
 
                </section>
197
 
                <section id="troubleshooting-wireless-ipv6" status="review">
198
 
                        <title>Issues With <acronym>IPv6</acronym></title>
199
 
                        <para>Internet Protocol version 6 (<acronym>IPv6</acronym>) is supported by default in Xubuntu. 
200
 
                        If you believe you are experiencing issues using <acronym>IPv6</acronym>, then you can disable 
201
 
                        it by following these steps:</para>                             
202
 
                        <orderedlist><!--> /etc/modprobe.d/aliases is not present in Lucid and beyond</!-->
203
 
                                <listitem><para>Open a <application>Terminal</application> (&terminal;) 
204
 
                                and type the following commands:</para>
205
 
                                        <screen><command>sudo nano /etc/default/grub</command></screen>
206
 
                                <para>and press <keycap>Enter</keycap>.</para></listitem>
207
 
                                <listitem><para>Locate the line that contains <computeroutput>GRUB_CMDLINE_LINUX=
208
 
                                </computeroutput></para></listitem>
209
 
                                <listitem><para>Input <userinput>ipv6.disable=1</userinput> in between the quotes, i.e. 
210
 
                                <userinput>GRUB_CMDLINE_LINUX="ipv6.disable=1"</userinput></para></listitem>
211
 
                                <listitem><para>Press <keycombo><keycap>Ctrl</keycap><keycap>X</keycap></keycombo> to 
212
 
                                exit the <application>nano</application> program.</para></listitem>
213
 
                                <listitem><para>Press <keycap>Y</keycap> and then <keycap>Enter</keycap> to save the 
214
 
                                changes to <filename>/etc/default/grub</filename>.</para></listitem>
215
 
                                <listitem><para>Type in the <application>Terminal</application>:</para>
216
 
                                        <screen><command>sudo update-grub</command></screen> 
217
 
                                <para>and press <keycap>Enter</keycap>.</para></listitem>
218
 
                                <listitem><para>Reboot Xubuntu.</para></listitem>
219
 
                                <listitem><para>To verify that <acronym>IPv6</acronym> has been disabled, open 
220
 
                                a <application>Terminal</application> (&terminal;) and type the command:
221
 
                                        <screen><command>cat /proc/sys/net/ipv6/conf/all/disable_ipv6</command></screen>
222
 
                                </para></listitem>
223
 
                                <listitem><para>The output or response from the computer will either be 
224
 
                                <computeroutput>0</computeroutput> which means that <acronym>IPv6</acronym> <emphasis 
225
 
                                role="strong">is not</emphasis> disabled or <computeroutput>1</computeroutput> which 
226
 
                                means <acronym>IPv6</acronym> <emphasis role="strong">is</emphasis> disabled. After 
227
 
                                following these steps, the output should be <computeroutput>1</computeroutput>.</para>
228
 
                                </listitem>
229
 
                        </orderedlist>
230
 
                </section>      
231
 
        </section>
232
 
</section>