11
11
<!ENTITY ubuntu '<phrase>Ubuntu</phrase>'>
14
<article id="troubleshooting" status="review">
16
<title>Wireless networks</title>
20
<sect1 id="network-troubleshooting" status="review">
21
<title>Tools to help with network connection problems</title>
22
<para>If you have a network connection which is not working properly, you can use a few tools to help diagnose what the problem is.</para>
23
<para>Most of the tools in this section require use of the Terminal, which you can open by pressing &terminal;.</para>
25
<sect2 id="network-troubleshooting-iwconfig" status="review">
26
<title>Identify the wireless connections</title>
27
<para><application>iwconfig</application> allows you to change certain settings on your wireless hardware. However, it is also very useful for identifying wireless connections.</para>
28
<para>To identify a wireless connection:</para>
30
<listitem><para>Press &terminal; to open a Terminal</para></listitem>
31
<listitem><para>Type <userinput>iwconfig</userinput> in the Terminal and press <keycap>Enter</keycap></para></listitem>
33
<para>You should get output similar to the following:</para>
34
<screen>lo no wireless extensions.
36
eth0 no wireless extensions.
38
eth1 IEEE 802.11g ESSID:"WLAN Name"
39
Mode:Managed Frequency:2.432 GHz Access Point: 00:12:CF:02:6F:EC
40
Bit Rate:54 Mb/s Tx-Power=20 dBm Sensitivity=8/0
41
Retry limit:7 RTS thr:off Fragment thr:off
43
Link Quality=75/100 Signal level=-54 dBm Noise level=-89 dBm
44
Rx invalid nwid:0 Rx invalid crypt:0 Rx invalid frag:0
45
Tx excessive retries:0 Invalid misc:0 Missed beacon:1</screen>
47
<listitem><para>The column on the left gives the name of the connection, such as <quote>eth0</quote> or <quote>wlan0</quote></para></listitem>
48
<listitem><para>If the column on the right says <quote>no wireless extensions</quote>, that connection has not been recognized as a wireless connection and is probably a wired network connection</para></listitem>
49
<listitem><para>If the connection <emphasis>has</emphasis> been recognized as a wireless connection, details of the wireless connection will be shown in the column on the right</para>
51
<listitem><para><emphasis>ESSID</emphasis> gives the name of the wireless network that you are connected to, if any</para></listitem>
52
<listitem><para><emphasis>Link Quality</emphasis> gives a measure of the strength of the wireless signal</para></listitem>
58
<sect2 id="network-troubleshooting-iwlist" status="review">
59
<title>Find information about the wireless connections</title>
60
<para><application>iwlist</application> is able to display information about your wireless connection.</para>
62
<listitem><para>Press &terminal; to open a Terminal</para></listitem>
64
<para>Type the following commands in the Terminal and press <keycap>Enter</keycap> to run them. Make sure that you replace <emphasis>eth1</emphasis> with the name of your wireless interface, if it is different.</para>
66
<listitem><para><userinput>iwlist eth1 accesspoints</userinput> - Show a list of available wireless access points</para></listitem>
67
<listitem><para><userinput>iwlist eth1 rate</userinput> - Show a list of all possible transmission rates for your wireless connection, including the current rate</para></listitem>
68
<listitem><para><userinput>iwlist eth1 key</userinput> - Show information about wireless encryption</para></listitem>
74
<sect2 id="network-troubleshooting-ifconfig" status="review">
75
<title>Get information about the current connection</title>
76
<para><application>ifconfig</application> is intended to allow you to change the settings of your
77
network connections, but it can also be used to list information about the current connection.</para>
79
<listitem><para>Press &terminal; to open a Terminal</para></listitem>
81
<para>Type <userinput>ifconfig eth1</userinput> in the Terminal and press <keycap>Enter</keycap>, replacing <emphasis>eth1</emphasis> with the name of your network interface if it is different.</para>
83
<listitem><para><emphasis>inet addr</emphasis> gives the current <emphasis>IP address</emphasis> of the connection</para></listitem>
84
<listitem><para><emphasis>HWaddr</emphasis> gives the <emphasis>MAC address</emphasis> of your network device</para></listitem>
90
<sect2 id="network-troubleshooting-ping" status="review">
91
<title>Check if a connection is working properly</title>
92
<para>A good way of checking if a connection is working properly is to <emphasis>ping</emphasis> another computer on the network or the Internet.</para>
93
<para>To check if you are connected to the Internet:</para>
95
<listitem><para>Press &network-tools;</para></listitem>
96
<listitem><para>Select the <guilabel>Ping</guilabel> tab</para></listitem>
97
<listitem><para>Type <userinput>ubuntu.com</userinput> into the <guilabel>Network address</guilabel> box and then press <guibutton>Ping</guibutton></para></listitem>
99
<para>After a while, a graph should appear. Look at the number for <guilabel>Successful packets</guilabel> under <guilabel>Transmission Statistics</guilabel></para>
101
<listitem><para><emphasis>100% successful packets</emphasis> - Your computer should have a good connection to the Internet</para></listitem>
102
<listitem><para><emphasis>Less than 100% successful</emphasis> - Your computer probably has a poor connection to the Internet or a poor wireless signal</para></listitem>
103
<listitem><para><emphasis>0% successful packets</emphasis> - Your computer has a very bad connection, or is connected to an access point or router which is not connected to the Internet</para></listitem>
107
<para>If you get an error message which says <emphasis>The address 'ubuntu.com' cannot be found</emphasis>, then your computer is probably not connected to the Internet or cannot reach a <emphasis>DNS server</emphasis>.</para>
14
<chapter id="troubleshooting" status="review">
15
<title>Troubleshooting</title>
16
<para>Since the introduction of NetworkManager, connections can be enabled and disabled from the NetworkManager
17
icon in the <guilabel>System Notification Area</guilabel>.</para>
19
<para>Before attempting any troubleshooting, ensure that the connection is enabled:</para>
21
<listitem><para>Right click the <guiicon>NetworkManager</guiicon> icon in the notification area.</para></listitem>
22
<listitem><para>Check <guilabel>Enable Networking</guilabel>.</para></listitem>
23
<listitem><para>Check <guilabel>Enable Wireless</guilabel>.</para></listitem>
26
<sect1 id="troubleshooting-lan" status="review">
27
<title>Wired troubleshooting</title>
28
<para>If you have a network connection which is not working properly, you can use a few tools to help
29
diagnose what the problem is.</para>
30
<para>Most of the tools in this section require use of the Terminal, which you can open by pressing
33
<sect2 id="network-troubleshooting-ifconfig" status="review">
34
<title>Get information about the current connection</title>
35
<para><application>ifconfig</application> is intended to allow you to change the settings of your
36
network connections, but it can also be used to list information about the current connection.</para>
38
<listitem><para>Press &terminal; to open a Terminal</para></listitem>
40
<para>Type <userinput>ifconfig eth1</userinput> in the Terminal and press <keycap>Enter</keycap>, replacing <emphasis>eth1</emphasis> with the name of your network interface if it is different.</para>
42
<listitem><para><emphasis>inet addr</emphasis> gives the current <emphasis>IP address</emphasis> of the connection</para></listitem>
43
<listitem><para><emphasis>HWaddr</emphasis> gives the <emphasis>MAC address</emphasis> of your network device</para></listitem>
49
<sect2 id="network-troubleshooting-ping" status="review">
50
<title>Check if a connection is working properly</title>
51
<para>A good way of checking if a connection is working properly is to <emphasis>ping</emphasis> another computer on the network or the Internet.</para>
52
<para>To check if you are connected to the Internet:</para>
54
<listitem><para>Press &network-tools;</para></listitem>
55
<listitem><para>Select the <guilabel>Ping</guilabel> tab</para></listitem>
56
<listitem><para>Type <userinput>ubuntu.com</userinput> into the <guilabel>Network address</guilabel> box and then press <guibutton>Ping</guibutton></para></listitem>
58
<para>After a while, a graph should appear. Look at the number for <guilabel>Successful packets</guilabel> under <guilabel>Transmission Statistics</guilabel></para>
60
<listitem><para><emphasis>100% successful packets</emphasis> - Your computer should have a good connection to the Internet</para></listitem>
61
<listitem><para><emphasis>Less than 100% successful</emphasis> - Your computer probably has a poor connection to the Internet or a poor wireless signal</para></listitem>
62
<listitem><para><emphasis>0% successful packets</emphasis> - Your computer has a very bad connection, or is connected to an access point or router which is not connected to the Internet</para></listitem>
66
<para>If you get an error message which says <emphasis>The address 'ubuntu.com' cannot be found</emphasis>, then your computer is probably not connected to the Internet or cannot reach a <emphasis>DNS server</emphasis>.</para>
70
<sect1 id="troubleshooting-wireless" status="review">
71
<title>Wireless troubleshooting</title>
72
<para>While not exhaustive, this section covers some common problems faced with wireless support.</para>
73
<para>There is much more information available from the <ulink url="https://help.ubuntu.com/community/WifiDocs">Community Documentation</ulink>.</para>
74
<note><para>This troubleshooting guide is designed to be carried out in order. If you reach the end of a section
75
and are not directed to another - then try <xref linkend="connecting-wireless"/> and should it fail begin at the start again.</para></note>
76
<sect2 id="troubleshooting-wireless-disabled" status="review">
77
<title>Check that the device is on</title>
79
<listitem><para>Many wireless network devices can be turned on or off. Check to see if there is a hardware switch, some devices can be switched off from Windows and may need to be turned back on from Windows.</para></listitem>
80
<listitem><para>If it is turned on then see <xref linkend="troubleshooting-wireless-device"/>.</para></listitem>
83
<sect2 id="troubleshooting-wireless-device" status="review">
84
<title>Check for device recognition</title>
86
<listitem><para>Open a <application>Terminal</application> (&terminal;) and type the command: <code>sudo lshw -C network</code></para></listitem>
88
<para>You should see an output, along with the words "CLAIMED, UNCLAIMED, ENABLED or DISABLED"</para>
90
<listitem><para>Claimed - this indicates a driver is loaded but not functioning, see <xref linkend="troubleshooting-wireless-ndiswrapper"/></para></listitem>
91
<listitem><para>Unclaimed - there is no driver loaded, see <xref linkend="troubleshooting-wireless-ndiswrapper"/>.</para></listitem>
92
<listitem><para>Enabled - move on to If there is a driver listed then see <xref linkend="troubleshooting-wireless-connection" />.</para></listitem>
93
<listitem><para>Disabled - see <xref linkend="troubleshooting-wireless-disabled"/>.</para></listitem>
96
<sect2 id="troubleshooting-wireless-ndiswrapper" status="review">
97
<title>Using Windows Wireless Drivers</title>
98
<para>Ubuntu supports a system known as NDISWrapper. This allows you to use a Windows wireless device driver under Ubuntu.</para>
100
<listitem><para>Obtain the Windows Driver for your system and locate the file that ends with <code>.inf</code>.</para></listitem>
101
<listitem><para><ulink url="apt:ndisgtk">Install the <application>ndisgtk</application> package</ulink>.</para></listitem>
102
<listitem><para>Open <application>ndisgtk</application> (&ndisgtk;).</para></listitem>
103
<listitem><para>Select <guilabel>Install new driver</guilabel>.</para></listitem>
104
<listitem><para>Choose the location of your Windows .inf file and click <guibutton>Install</guibutton>.</para></listitem>
105
<listitem><para>Click <guibutton>OK</guibutton>.</para></listitem>
108
<sect2 id="troubleshooting-wireless-connection" status="review">
109
<title>Check for a connection to the router</title>
111
<listitem><para>Open a <application>Terminal</application> (&terminal;) and type the command: <code>iwconfig</code>.</para></listitem>
112
<listitem><para>If the ESSID for our router is shown there may be a problem with ACPI support. Boot the kernel with the <code>pci=noacpi</code> option.</para></listitem>
115
<sect2 id="troubleshooting-wireless-ip" status="review">
116
<title>Check IP assignment</title>
118
<listitem><para>Open a <application>Terminal</application> (&terminal;) and type the command: <code>ifconfig</code>.</para></listitem>
119
<listitem><para>If there is an IP address shown see <xref linkend="troubleshooting-wireless-dns"/>.</para></listitem>
120
<listitem><para>From the <application>Terminal</application> enter the command: <code>sudo dhclient if_name</code> where if_name is the connection listed earlier.</para></listitem>
121
<listitem><para>If you receive a message that says <code>bound to xxx.xxx.xxx.xxx</code> then see <xref linkend="troubleshooting-wireless-dns"/></para></listitem>
122
<listitem><para>If not then reboot the system.</para></listitem>
125
<sect2 id="troubleshooting-wireless-dns" status="review">
126
<title>Check DNS</title>
128
<listitem><para>Open a <application>Terminal</application> (&terminal;) and type the command: <code>ping -c3 85.190.27.2</code>.</para></listitem>
129
<listitem><para>Now type the command: <code>ping www.ubuntu.com</code>. If you get a response from the both then see <xref linkend="troubleshooting-wireless-ipv6"/>.</para></listitem>
130
<listitem><para>Type the command: <code>cat /etc/resolv.conf</code>. If there is no nameserver listed then contact your ISP and find out your primary and secondary domain name servers. Once you have this information see <xref linkend="connecting-wireless"/>.</para></listitem>
133
<sect2 id="troubleshooting-wireless-ipv6" status="review">
134
<title>IPv6 Not Supported</title>
136
<listitem><para>IPv6 is supported by default in Ubuntu and can sometimes cause problems.</para></listitem>
137
<listitem><para>To disable it, open a <application>Terminal</application> (&terminal;) and type the command: <code>gksudo gedit /etc/modprobe.d/aliases</code>.</para></listitem>
138
<listitem><para>Find the line <code>alias net-pf-10 ipv6</code> and change it to read <code>alias net-pf-10 off</code>.</para></listitem>
139
<listitem><para>Reboot Ubuntu.</para></listitem>