← Back to branch summary

~ubuntu-branches/ubuntu/karmic/installation-guide/karmic

« back to all changes in this revision

Viewing changes to en/hardware/network-cards.xml

  • Committer: Bazaar Package Importer
  • Author(s): Colin Watson
  • Date: 2007-07-23 15:52:44 UTC
  • mfrom: (2.1.1 etch)
  • Revision ID: james.westby@ubuntu.com-20070723155244-xayq1rzu8rllvngy
Tags: 20070319ubuntu1
https://launchpad.net/bugs/119177
* Resynchronise with Debian. Remaining changes:
  - Build only English (for now, until we figure out how to avoid trashing
    translations quite so badly with Ubuntu branding etc.).
  - Build only Ubuntu architectures (amd64, hppa, i386, ia64, powerpc,
    sparc).
  - Extensive (although possibly incomplete) Ubuntu branding, adjustments
    for our mirror layout, etc.
  - Add "Ubuntu and Debian" and "What is Ubuntu?" section, text borrowed
    from the Ubuntu web site. Disable the "What is Debian GNU/Linux?"
    section.
  - Direct installation reports to ubuntu-users for now.
  - Adjust various memory and disk space requirements. Talk about the
    default Ubuntu desktop and Ubuntu tasks rather than Debian tasks.
  - Document mounting /sys in various places.
  - Unset supports-floppy-boot for all our architectures.
  - Add a few more supports-floppy-boot and bootable-usb conditionals.
  - Document our root password and sudo arrangements.
  - Document netboot-style USB images. Still mention the hd-media images,
    but they're downplayed since many USB sticks are too small for a full
    Ubuntu ISO image.
  - Document Kickstart installations (currently only the basics, a
    reference to Red Hat's documentation, and the differences from
    Anaconda).
  - Note that an empty preseed file is equivalent to a normal manual
    installation.
  - Rename doc-base.TEMPLATE to TEMPLATE.doc-base.
  - Update keyboard preseeding documentation for console-setup.
  - Update chroot-install guide for console-setup and language packs; add
    a bit more advice about installing grub.
  - Remove text talking about devfs-style device names, which are no
    longer supported.
  - Fix links to web copies of installation manual and example preseed
    file.
* Bump kernelversion to 2.6.22.
* Bump x11ver to 7.3.
* Bump GNOME version to 2.20.
* Bump release version and names for Gutsy (LP: #119177).
* Refer to the standard task rather than ubuntu-standard.
* Disable documentation of the GTK frontend.
* Remove latex-hangul-ucs-hlatex build-dependency, as we don't build for
  Korean.

Show diffs side-by-side

added added

removed removed

Lines of Context:
en/hardware/network-cards.xml
1
1
<!-- retain these comments for translator revision tracking -->
2
 
<!-- $Id: network-cards.xml 36732 2006-04-27 09:33:13Z fjp $ -->
 
2
<!-- $Id: network-cards.xml 43693 2006-12-30 23:45:46Z fjp $ -->
3
3
 
4
4
 <sect1 id="network-cards">
5
5
 <title>Network Connectivity Hardware</title>
6
 
 
7
 
<para arch="x86">
8
 
 
9
 
<!-- last updated for kernel-image_2.0.36-2 -->
10
 
 
11
 
Most PCI and many older ISA network cards are supported.
12
 
Some network interface cards are not supported by most Ubuntu
13
 
installation disks, such as AX.25 cards and protocols;
14
 
NI16510 EtherBlaster cards; Schneider &amp; Koch G16 cards;
15
 
and the Zenith Z-Note built-in network card. Microchannel (MCA) network
16
 
cards are not supported by the standard installation system, but see
17
 
<ulink url="&url-linux-mca;">Linux on MCA</ulink> for some (old)
18
 
instructions.
19
 
FDDI networks are also not supported by the installation disks, both
20
 
cards and protocols.
21
 
 
22
 
<!-- missing-doc FIXME You can create a custom kernel which supports an
23
 
otherwise unsupported card and then substitute in the installer (see
24
 
<xref linkend="rescue-replace-kernel"/>). -->
25
 
 
26
 
</para><para arch="x86">
27
 
 
28
 
As for ISDN, the D-channel protocol for the (old) German 1TR6 is not
29
 
supported; Spellcaster BRI ISDN boards are also not supported by the
30
 
&d-i;.
31
 
 
32
 
</para>
33
 
 
34
 
<para arch="m68k">
35
 
 
36
 
Any network interface card (NIC) supported by the Linux kernel should
37
 
also be supported by the boot disks.  You may need to load your
38
 
network driver as a module.  Again, see
39
 
<ulink url="&url-m68k-faq;"></ulink> for complete details.
40
 
 
41
 
</para>
42
 
 
43
 
<para arch="sparc">
44
 
 
45
 
The following network interface cards (NICs) are supported from the bootable
46
 
kernel directly:
 
6
<para>
 
7
 
 
8
Almost any network interface card (NIC) supported by the Linux kernel
 
9
should also be supported by the installation system; modular drivers
 
10
should normally be loaded automatically.
 
11
 
 
12
<phrase arch="x86">This includes most PCI and PCMCIA cards.</phrase>
 
13
<phrase arch="i386">Many older ISA cards are supported as well.</phrase>
 
14
 
 
15
<phrase arch="m68k">Again, see <ulink url="&url-m68k-faq;"></ulink>
 
16
for complete details.</phrase>
 
17
 
 
18
</para><para arch="sparc">
 
19
 
 
20
This includes a lot of generic PCI cards (for systems that have PCI) and
 
21
the following NICs from Sun:
47
22
 
48
23
<itemizedlist>
49
 
 <listitem><para>
 
24
<listitem><para>
50
25
 
51
26
Sun LANCE
52
27
 
53
 
 
54
28
</para></listitem>
55
 
 <listitem><para>
 
29
<listitem><para>
56
30
 
57
31
Sun Happy Meal
58
32
 
59
 
 
60
33
</para></listitem>
61
 
</itemizedlist>
62
 
 
63
 
</para><para arch="sparc">
64
 
 
65
 
The following network interface cards are supported as modules.  They
66
 
can be enabled once the drivers are installed during the setup.
67
 
However, due to the magic of OpenPROM, you still should be able to
68
 
boot from these devices:
69
 
 
70
 
<itemizedlist>
71
 
 <listitem><para>
 
34
<listitem><para>
72
35
 
73
36
Sun BigMAC
74
37
 
75
 
 
76
38
</para></listitem>
77
 
 <listitem><para>
 
39
<listitem><para>
78
40
 
79
41
Sun QuadEthernet
80
42
 
81
43
</para></listitem>
82
 
 <listitem><para>
 
44
<listitem><para>
83
45
 
84
46
MyriCOM Gigabit Ethernet
85
47
 
86
48
</para></listitem>
87
49
</itemizedlist>
88
50
 
89
 
</para><para arch="alpha">
90
 
 
91
 
Any network interface card (NIC) supported by the Linux kernel should
92
 
also be supported by the boot disks.  You may need to load your
93
 
network driver as a module.
94
 
 
95
 
</para><para arch="powerpc">
96
 
 
97
 
Any network interface card (NIC) supported by the Linux kernel should
98
 
also be supported by the boot disks.  You may need to load your
99
 
network driver as a module.
100
 
 
101
 
</para><para arch="hppa">
102
 
 
103
 
Any network interface card (NIC) supported by the Linux kernel should
104
 
also be supported by the boot disks.  You may need to load your
105
 
network driver as a module.
106
 
 
107
 
</para><para arch="ia64">
108
 
 
109
 
Any network interface card (NIC) supported by the Linux kernel should
110
 
also be supported by the boot disks.  You may need to load your
111
 
network driver as a module.
112
 
 
113
 
</para><para arch="mips">
114
 
 
115
 
Any network interface card (NIC) supported by the Linux kernel should
116
 
also be supported by the boot disks.  You may need to load your
117
 
network driver as a module.
118
 
 
119
51
</para><para arch="mipsel">
120
52
 
121
53
Due to kernel limitations only the onboard network interfaces on
124
56
 
125
57
</para><para arch="s390">
126
58
 
127
 
Any network interface card (NIC) supported by the Linux kernel is
128
 
also be supported by the boot disks.  All network drivers are compiled
129
 
as modules so you need to load one first during the initial network
130
 
setup. The list of supported network devices is:
 
59
The list of supported network devices is:
131
60
 
132
61
<itemizedlist>
133
62
 <listitem><para>
142
71
</para></listitem>
143
72
<listitem><para>
144
73
 
145
 
Inter-User Communication Vehicle (IUCV) &mdash; available for VM guests only
146
 
 
147
 
</para></listitem>
148
 
<listitem><para>
149
 
 
150
74
OSA-Express in QDIO mode, HiperSockets and Guest-LANs
151
75
 
152
76
</para></listitem>
156
80
 
157
81
<para arch="arm">
158
82
 
159
 
The following network interface cards are supported directly by the
160
 
boot disks on Netwinder and CATS machines:
161
 
 
162
 
<itemizedlist>
163
 
 <listitem><para>
164
 
 
165
 
    PCI-based NE2000
166
 
 
167
 
 
168
 
</para></listitem>
169
 
 <listitem><para>
170
 
 
171
 
    DECchip Tulip
172
 
 
173
 
</para></listitem>
174
 
</itemizedlist>
175
 
 
176
 
</para><para arch="arm">
177
 
 
178
 
The following network interface cards are supported directly by the
179
 
boot disks on RiscPCs:
180
 
 
181
 
<itemizedlist>
182
 
 <listitem><para>
183
 
 
184
 
    Ether1
185
 
 
186
 
</para></listitem>
187
 
 <listitem><para>
188
 
 
189
 
    Ether3
190
 
 
191
 
</para></listitem>
192
 
 <listitem><para>
193
 
 
194
 
    EtherH
195
 
 
196
 
</para></listitem>
197
 
</itemizedlist>
198
 
 
199
 
</para><para arch="arm">
200
 
 
201
 
If your card is mentioned in the lists above, the complete installation
202
 
can be carried out from the network with no need for CD-ROMs or floppy
203
 
disks.
204
 
 
205
 
</para><para arch="arm">
206
 
 
207
 
Any other network interface card (NIC) supported by the Linux kernel
208
 
should also be supported by the boot disks.  You may need to load your
209
 
network driver as a module; this means that you will have to install
210
 
the operating system kernel and modules using some other media.
211
 
 
212
 
</para>
213
 
 
 
83
On &arch-title;, most built-in Ethernet devices are supported and modules
 
84
for additional PCI and USB devices are provided.  The major exception is
 
85
the IXP4xx platform (featuring devices such as the Linksys NSLU2) which
 
86
needs a proprietary microcode for the operation of its built-in Ethernet
 
87
device.  Unofficial images for Linksys NSLU2 with this proprietary
 
88
microcode can be obtained from the <ulink
 
89
url="&url-slug-firmware;">Slug-Firmware site</ulink>.
 
90
 
 
91
</para><para arch="x86">
 
92
 
 
93
As for ISDN, the D-channel protocol for the (old) German 1TR6 is not
 
94
supported; Spellcaster BRI ISDN boards are also not supported by the
 
95
&d-i;. Using ISDN during the installation is not supported.
 
96
 
 
97
</para>
 
98
 
 
99
  <sect2 arch="not-s390" id="nics-firmware">
 
100
  <title>Drivers Requiring Firmware</title>
 
101
<para>
 
102
 
 
103
The installation system currently does not support retrieving firmware.
 
104
This means that any network cards that use a driver that requires firmware
 
105
to be loaded, is not supported by default.
 
106
 
 
107
</para><para>
 
108
 
 
109
If there is no other NIC you can use during the installation, it is still
 
110
possible to install &debian; using a full CD-ROM or DVD image. Select the
 
111
option to not configure a network and install using only the packages
 
112
available from the CD/DVD. You can then install the driver and firmware you
 
113
need after the installation is completed (after the reboot) and configure
 
114
your network manually. Note that the firmware may be packaged separately
 
115
from the driver and may not be available in the <quote>main</quote> section
 
116
of the &debian; archive.
 
117
 
 
118
</para><para>
 
119
 
 
120
If the driver itself <emphasis>is</emphasis> supported, you may also be
 
121
able to use the NIC during installation by copying the firmware from some
 
122
medium to <filename>/usr/lib/hotplug/firmware</filename>. Don't forget to
 
123
also copy the firmware to that location for the installed system before
 
124
the reboot at the end of the installation.
 
125
 
 
126
</para>
 
127
  </sect2>
 
128
 
 
129
  <sect2 condition="supports-wireless" id="nics-wireless">
 
130
  <title>Wireless Network Cards</title>
 
131
<para>
 
132
 
 
133
Wireless NICs are in general supported as well, with one big proviso.
 
134
A lot of wireless adapters require drivers that are either non-free or have
 
135
not been accepted into the official Linux kernel. These NICs can generally
 
136
be made to work under &debian;, but are not supported during the installation.
 
137
 
 
138
</para><para>
 
139
 
 
140
If there is no other NIC you can use during the installation, it is still
 
141
possible to install &debian; using a full CD-ROM or DVD image. Use the same
 
142
procedure as described above for NICs that require firmware.
 
143
 
 
144
</para><para>
 
145
 
 
146
In some cases the driver you need may not be available as a Debian package.
 
147
You will then have to look if there is source code available in the internet
 
148
and compile the driver yourself. How to do this is outside the scope of this
 
149
manual.
 
150
<phrase arch="x86">If no Linux driver is available, your last resort is to
 
151
use the <classname>ndiswrapper</classname> package, which allows you to use
 
152
a Windows driver.</phrase>
 
153
 
 
154
</para>
 
155
  </sect2>
 
156
 
 
157
  <sect2 arch="sparc" id="nics-sparc-trouble">
 
158
  <title>Known Issues for &arch-title;</title>
 
159
<para>
 
160
 
 
161
There are a couple of issues with specific network cards that are worth
 
162
mentioning here.
 
163
 
 
164
</para>
 
165
 
 
166
   <sect3><title>Conflict between tulip and dfme drivers</title>
 
167
<!-- BTS: #334104; may also affect other arches, but most common on sparc -->
 
168
<para>
 
169
 
 
170
<!-- BTS: #334104; may also affect other arches, but most common on sparc -->
 
171
There are various PCI network cards that have the same PCI identification,
 
172
but are supported by related, but different drivers. Some cards work with
 
173
the <literal>tulip</literal> driver, others with the <literal>dfme</literal>
 
174
driver. Because they have the same identification, the kernel cannot
 
175
distinguish between them and it is not certain which driver will be loaded.
 
176
If this happens to be the wrong one, the NIC may not work, or work badly.
 
177
 
 
178
</para><para>
 
179
 
 
180
This is a common problem on Netra systems with a Davicom (DEC-Tulip
 
181
compatible) NIC. In that case the <literal>tulip</literal> driver is
 
182
probably the correct one.
 
183
 
 
184
During the installation the solution is to switch to a shell and unload the
 
185
wrong driver module using
 
186
<userinput>modprobe -r <replaceable>module</replaceable></userinput> (or
 
187
both, if they are both loaded). After that you can load the correct module
 
188
using <userinput>modprobe <replaceable>module</replaceable></userinput>.
 
189
 
 
190
</para>
 
191
   </sect3>
 
192
 
 
193
   <sect3><title>Sun B100 blade</title>
 
194
<!-- BTS: #384549; should be checked for kernels >2.6.18 -->
 
195
<para>
 
196
 
 
197
The <literal>cassini</literal> network driver does not work with Sun B100
 
198
blade systems.
 
199
 
 
200
</para>
 
201
   </sect3>
 
202
  </sect2>
214
203
 </sect1>