/[ddp]/manuals/trunk/release-notes/es/upgrading.po
ViewVC logotype

Contents of /manuals/trunk/release-notes/es/upgrading.po

Parent Directory Parent Directory | Revision Log Revision Log


Revision 5427 - (hide annotations) (download)
Tue Oct 21 17:28:37 2008 UTC (4 years, 6 months ago) by debacle
Original Path: manuals/branches/release-notes/lenny/es/upgrading.po
File size: 107846 byte(s)
Update of po files.
1 debacle 5329 # SOME DESCRIPTIVE TITLE
2     # Copyright (C) YEAR Free Software Foundation, Inc.
3     # This file is distributed under the same license as the PACKAGE package.
4     # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
5     #
6     #, fuzzy
7     msgid ""
8     msgstr ""
9     "Project-Id-Version: release-notes 5.0\n"
10 debacle 5427 "POT-Creation-Date: 2008-10-21 16:11+0300\n"
11 debacle 5329 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
12     "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
13     "Language-Team: LANGUAGE <LL@li.org>\n"
14     "MIME-Version: 1.0\n"
15 debacle 5419 "Content-Type: text/plain; charset=UTF-8\n"
16     "Content-Transfer-Encoding: ENCODING\n"
17 debacle 5329
18 debacle 5419 # type: Attribute 'lang' of: <chapter>
19     #: en/upgrading.dbk:7
20     msgid "en"
21     msgstr ""
22    
23 debacle 5329 # type: Content of: <chapter><title>
24 debacle 5419 #: en/upgrading.dbk:8
25 debacle 5329 msgid "Upgrades from previous releases"
26     msgstr ""
27    
28     # type: Content of: <chapter><section><title>
29 debacle 5419 #: en/upgrading.dbk:10
30 debacle 5329 msgid "Preparing for the upgrade"
31     msgstr ""
32    
33     # type: Content of: <chapter><section><para>
34 debacle 5419 #: en/upgrading.dbk:12
35 debacle 5329 msgid ""
36     "We suggest that before upgrading you also read the information in <xref "
37 debacle 5419 "linkend=\"ch-information\"/> . That chapter covers potential issues not "
38 debacle 5329 "directly related to the upgrade process but which could still be important "
39     "to know about before you begin."
40     msgstr ""
41    
42     # type: Content of: <chapter><section><section><title>
43 debacle 5419 #: en/upgrading.dbk:18
44 debacle 5329 msgid "Back up any data or configuration information"
45     msgstr ""
46    
47     # type: Content of: <chapter><section><section><para>
48 debacle 5419 #: en/upgrading.dbk:20
49 debacle 5329 msgid ""
50     "Before upgrading your system, it is strongly recommended that you make a "
51     "full backup, or at least back up any data or configuration information you "
52     "can't afford to lose. The upgrade tools and process are quite reliable, but "
53     "a hardware failure in the middle of an upgrade could result in a severely "
54     "damaged system."
55     msgstr ""
56    
57     # type: Content of: <chapter><section><section><para>
58 debacle 5419 #: en/upgrading.dbk:27
59 debacle 5329 msgid ""
60 debacle 5419 "The main things you'll want to back up are the contents of <filename>/etc</"
61     "filename>, <filename>/var/lib/dpkg</filename>, <filename>/var/lib/aptitude/"
62     "pkgstates</filename> and the output of <literal>dpkg --get-selections *</"
63     "literal> (the quotes are important)."
64 debacle 5329 msgstr ""
65    
66     # type: Content of: <chapter><section><section><para>
67 debacle 5419 #: en/upgrading.dbk:33
68 debacle 5329 msgid ""
69 debacle 5419 "The upgrade process itself does not modify anything in the <filename>/home</"
70     "filename> directory. However, some applications (e.g. parts of the Mozilla "
71     "suite, and the GNOME and KDE desktop environments) are known to overwrite "
72     "existing user settings with new defaults when a new version of the "
73     "application is first started by a user. As a precaution, you may want to "
74     "make a backup of the hidden files and directories (dotfiles) in users' home "
75     "directories. This backup may help to restore or recreate the old settings. "
76     "You may also want to inform users about this."
77 debacle 5329 msgstr ""
78    
79     # type: Content of: <chapter><section><section><para>
80 debacle 5419 #: en/upgrading.dbk:43
81 debacle 5329 msgid ""
82     "Any package installation operation must be run with superuser privileges, so "
83     "either login as root or use <command>su</command> or <command>sudo</command> "
84     "to gain the necessary access rights."
85     msgstr ""
86    
87     # type: Content of: <chapter><section><section><para>
88 debacle 5419 #: en/upgrading.dbk:48
89 debacle 5329 msgid ""
90     "The upgrade has a few preconditions; you should check them before actually "
91     "executing the upgrade."
92     msgstr ""
93    
94     # type: Content of: <chapter><section><section><title>
95 debacle 5419 #: en/upgrading.dbk:54
96 debacle 5329 msgid "Inform users in advance"
97     msgstr ""
98    
99     # type: Content of: <chapter><section><section><para>
100 debacle 5419 #: en/upgrading.dbk:56
101 debacle 5329 msgid ""
102     "It's wise to inform all users in advance of any upgrades you're planning, "
103     "although users accessing your system via an <command>ssh</command> "
104     "connection should notice little during the upgrade, and should be able to "
105     "continue working."
106     msgstr ""
107    
108     # type: Content of: <chapter><section><section><para>
109 debacle 5419 #: en/upgrading.dbk:62
110 debacle 5329 msgid ""
111     "If you wish to take extra precautions, back up or unmount users' partitions "
112     "(<filename>/home</filename>) before upgrading."
113     msgstr ""
114    
115     # type: Content of: <chapter><section><section><para>
116 debacle 5419 #: en/upgrading.dbk:66
117 debacle 5329 msgid ""
118     "You will probably have to do a kernel upgrade when upgrading to "
119     "&releasename;, so a reboot will normally be necessary. Typically, this will "
120     "be done after the upgrade is finished."
121     msgstr ""
122    
123     # type: Content of: <chapter><section><section><title>
124 debacle 5419 #: en/upgrading.dbk:73
125 debacle 5329 msgid "Prepare for recovery"
126     msgstr ""
127    
128     # type: Content of: <chapter><section><section><para>
129 debacle 5419 #: en/upgrading.dbk:75
130 debacle 5329 msgid ""
131     "Because of the many changes in the kernel between &oldreleasename; and "
132     "&releasename; regarding drivers, hardware discovery and the naming and "
133     "ordering of device files, there is a real risk that you may experience "
134     "problems rebooting your system after the upgrade. A lot of known potential "
135     "issues are documented in this and the next chapters of these Release Notes."
136     msgstr ""
137    
138     # type: Content of: <chapter><section><section><para>
139 debacle 5419 #: en/upgrading.dbk:82
140 debacle 5329 msgid ""
141     "For that reason it makes sense to ensure that you will be able to recover if "
142     "your system should fail to reboot or, for remotely managed systems, fail to "
143     "bring up networking."
144     msgstr ""
145    
146     # type: Content of: <chapter><section><section><para>
147 debacle 5419 #: en/upgrading.dbk:87
148 debacle 5329 msgid ""
149     "If you are upgrading remotely via an <command>ssh</command> link it is "
150     "highly recommended that you take the necessary precautions to be able to "
151     "access the server through a remote serial terminal. There is a chance that, "
152     "after upgrading the kernel and rebooting, some devices will be renamed (as "
153     "described in <xref linkend=\"device-reorder\"/> ) and you will have to fix "
154     "the system configuration through a local console. Also, if the system is "
155     "rebooted accidentally in the middle of an upgrade there is a chance you will "
156     "need to recover using a local console."
157     msgstr ""
158    
159     # type: Content of: <chapter><section><section><para>
160 debacle 5419 #: en/upgrading.dbk:97
161 debacle 5329 msgid ""
162     "The most obvious thing to try first is to reboot with your old kernel. "
163     "However, for various reasons documented elsewhere in this document, this is "
164     "not guaranteed to work."
165     msgstr ""
166    
167     # type: Content of: <chapter><section><section><para>
168 debacle 5419 #: en/upgrading.dbk:102
169 debacle 5329 msgid ""
170     "If that fails, you will need an alternative way to boot your system so you "
171     "can access and repair it. One option is to use a special rescue image or a "
172     "Linux live CD. After booting from that, you should be able to mount your "
173     "root file system and <literal>chroot</literal> into it to investigate and "
174     "fix the problem."
175     msgstr ""
176    
177     # type: Content of: <chapter><section><section><para>
178 debacle 5419 #: en/upgrading.dbk:109
179 debacle 5329 msgid ""
180 debacle 5419 "Another option we'd like to recommend is to use the <emphasis>rescue mode</"
181     "emphasis> of the &releasename; Debian Installer. The advantage of using the "
182     "installer is that you can choose between its many installation methods for "
183     "one that best suits your situation. For more information, please consult "
184     "the section Recovering a Broken System in chapter 8 of the <ulink url=\"&url-"
185     "install-manual;\">Installation Guide</ulink> and the <ulink url=\"&url-wiki;"
186     "DebianInstaller/FAQ\">Debian Installer FAQ</ulink>."
187 debacle 5329 msgstr ""
188    
189     # type: Content of: <chapter><section><section><section><title>
190 debacle 5419 #: en/upgrading.dbk:119
191 debacle 5329 msgid "Debug shell during boot using initrd"
192     msgstr ""
193    
194     # type: Content of: <chapter><section><section><section><para><footnote>
195 debacle 5419 #: en/upgrading.dbk:121
196 debacle 5329 msgid ""
197     "The <systemitem role=\"package\">initramfs-tools</systemitem> includes a "
198     "debug shell<footnote>"
199     msgstr ""
200    
201     # type: Content of: <chapter><section><section><section><para><footnote><para>
202 debacle 5419 #: en/upgrading.dbk:122
203 debacle 5329 msgid ""
204 debacle 5419 "This feature can be disabled by adding the parameter <literal>panic=0</"
205     "literal> to your boot parameters."
206 debacle 5329 msgstr ""
207    
208     # type: Content of: <chapter><section><section><section><para>
209 debacle 5419 #: en/upgrading.dbk:123
210 debacle 5329 msgid ""
211     "</footnote> in the initrds it generates. If for example the initrd is "
212     "unable to mount your root file system, you will be dropped into this debug "
213     "shell which has basic commands available to help trace the problem and "
214     "possibly fix it."
215     msgstr ""
216    
217     # type: Content of: <chapter><section><section><section><para>
218 debacle 5419 #: en/upgrading.dbk:129
219 debacle 5329 msgid ""
220 debacle 5419 "Basic things to check are: presence of correct device files in <filename>/"
221     "dev</filename>; what modules are loaded (<literal>cat /proc/modules</"
222     "literal>); output of <command>dmesg</command> for errors loading drivers. "
223     "The output of <command>dmesg</command> will also show what device files have "
224     "been assigned to which disks; you should check that against the output of "
225     "<literal>echo $ROOT</literal> to make sure that the root file system is on "
226     "the expected device."
227 debacle 5329 msgstr ""
228    
229     # type: Content of: <chapter><section><section><section><para>
230 debacle 5419 #: en/upgrading.dbk:138
231 debacle 5329 msgid ""
232     "If you do manage to fix the problem, typing <literal>exit</literal> will "
233     "quit the debug shell and continue the boot process at the point it failed. "
234     "Of course you will also need to fix the underlying problem and regenerate "
235     "the initrd so the next boot won't fail again."
236     msgstr ""
237    
238     # type: Content of: <chapter><section><section><title>
239 debacle 5419 #: en/upgrading.dbk:148
240 debacle 5329 msgid "Prepare a safe environment for the upgrade"
241     msgstr ""
242    
243     # type: Content of: <chapter><section><section><para>
244 debacle 5419 #: en/upgrading.dbk:150
245 debacle 5329 msgid ""
246     "The distribution upgrade should be done either locally from a textmode "
247     "virtual console (or a directly connected serial terminal), or remotely via "
248     "an <command>ssh</command> link."
249     msgstr ""
250    
251     # type: Content of: <chapter><section><section><para>
252 debacle 5419 #: en/upgrading.dbk:155
253 debacle 5329 msgid ""
254     "In order to gain extra safety margin when upgrading remotely, we suggest "
255     "that you run upgrade processes in the virtual console provided by the "
256     "<command>screen</command> program, which enables safe reconnection and "
257     "ensures the upgrade process is not interrupted even if the remote connection "
258     "process fails."
259     msgstr ""
260    
261     # type: Content of: <chapter><section><section><para>
262 debacle 5419 #: en/upgrading.dbk:162
263 debacle 5329 msgid ""
264 debacle 5419 "<emphasis role=\"strong\">Important!</emphasis> You should <emphasis>not</"
265     "emphasis> upgrade using <command>telnet</command>, <command>rlogin</"
266     "command>, <command>rsh</command>, or from an X session managed by "
267     "<command>xdm</command>, <command>gdm</command> or <command>kdm</command> etc "
268     "on the machine you are upgrading. That is because each of those services "
269     "may well be terminated during the upgrade, which can result in an "
270     "<emphasis>inaccessible</emphasis> system that is only half-upgraded."
271 debacle 5329 msgstr ""
272    
273 debacle 5419 # type: Content of: <chapter><section><section><programlisting>
274     #: en/upgrading.dbk:171
275     #, no-wrap
276     msgid ""
277     "\n"
278     "TODO: surely gdm/kdm are sane?\n"
279     "(vorlon) haha, no, gdm is not; I had that thought, and tested a gdm\n"
280     " restart on my live session ;)\n"
281     msgstr ""
282    
283 debacle 5329 # type: Content of: <chapter><section><section><title>
284 debacle 5419 #: en/upgrading.dbk:180
285 debacle 5427 msgid "Prepare initramfs for"
286 debacle 5329 msgstr ""
287    
288 debacle 5427 # type: Content of: <chapter><section><section><para><acronym>
289     #: en/upgrading.dbk:180 en/upgrading.dbk:182 en/upgrading.dbk:185
290     #: en/upgrading.dbk:200
291     msgid "LILO"
292     msgstr ""
293    
294     # type: Content of: <chapter><section><section><title><indexterm>
295     #: en/upgrading.dbk:180
296     msgid "<indexterm>"
297     msgstr ""
298    
299     # type: Content of: <chapter><section><section><title>
300     #: en/upgrading.dbk:180
301     msgid "</indexterm>"
302     msgstr ""
303    
304 debacle 5329 # type: Content of: <chapter><section><section><para>
305 debacle 5419 #: en/upgrading.dbk:182
306 debacle 5427 msgid "Users using the"
307     msgstr ""
308    
309     # type: Content of: <chapter><section><section><para>
310     #: en/upgrading.dbk:182
311 debacle 5329 msgid ""
312 debacle 5427 "bootloader should note that the default settings for <systemitem role="
313     "\"package\">initramfs-tools</systemitem> now generate an initramfs that is "
314     "too large for"
315 debacle 5329 msgstr ""
316    
317 debacle 5427 # type: Content of: <chapter><section><section><para>
318     #: en/upgrading.dbk:185
319     msgid ""
320     "to load. Such users should either switch to <systemitem role=\"package"
321     "\">grub</systemitem>, or edit the file <filename>/etc/initramfs-tools/"
322     "initramfs.conf</filename>, changing the line"
323     msgstr ""
324    
325 debacle 5419 # type: Content of: <chapter><section><section><para><programlisting>
326     #: en/upgrading.dbk:189 en/upgrading.dbk:199
327     #, no-wrap
328     msgid "MODULES=most"
329     msgstr ""
330    
331     # type: Content of: <chapter><section><section><para>
332     #: en/upgrading.dbk:189
333     msgid "to read"
334     msgstr ""
335    
336     # type: Content of: <chapter><section><section><para><programlisting>
337     #: en/upgrading.dbk:190
338     #, no-wrap
339     msgid "MODULES=dep"
340     msgstr ""
341    
342     # type: Content of: <chapter><section><section><para>
343     #: en/upgrading.dbk:193
344     msgid ""
345     "Note, however, that doing this will cause <systemitem role=\"package"
346     "\">initramfs-tools</systemitem> to install only those modules that are "
347     "required for the particular hardware that it is run on, onto the initramfs; "
348     "as such, if you want to generate a boot medium that will work on more "
349     "hardware than just the one you're generating it on, you should leave the "
350     "setting to"
351     msgstr ""
352    
353     # type: Content of: <chapter><section><section><para>
354     #: en/upgrading.dbk:199
355 debacle 5427 msgid "and make sure you do not use"
356 debacle 5419 msgstr ""
357    
358 debacle 5427 # type: Content of: <chapter><section><section><para>
359     #: en/upgrading.dbk:200
360     msgid "."
361     msgstr ""
362    
363 debacle 5329 # type: Content of: <chapter><section><title>
364 debacle 5419 #: en/upgrading.dbk:207
365 debacle 5329 msgid "Checking system status"
366     msgstr ""
367    
368     # type: Content of: <chapter><section><para>
369 debacle 5419 #: en/upgrading.dbk:209
370 debacle 5329 msgid ""
371     "The upgrade process described in this chapter has been designed for upgrades "
372     "from pure &oldreleasename; systems without third-party packages. In "
373     "particular, there are known problems with third-party packages which install "
374     "programs under <filename>/usr/X11R6/bin/</filename> causing problems with "
375 debacle 5427 "upgrades due to the X.Org transition (<xref linkend=\"xorg\"/>). For "
376 debacle 5419 "greatest reliability of the upgrade process, you may wish to remove third-"
377     "party packages from your system before you begin upgrading."
378 debacle 5329 msgstr ""
379    
380     # type: Content of: <chapter><section><para>
381 debacle 5419 #: en/upgrading.dbk:218
382 debacle 5329 msgid ""
383     "This procedure also assumes your system has been updated to the latest point "
384     "release of &oldreleasename;. If you have not done this or are unsure, "
385     "follow the instructions in <xref linkend=\"old-upgrade\"/> ."
386     msgstr ""
387    
388     # type: Content of: <chapter><section><section><title>
389 debacle 5419 #: en/upgrading.dbk:223
390 debacle 5329 msgid "Review actions pending in package manager"
391     msgstr ""
392    
393     # type: Content of: <chapter><section><section><para>
394 debacle 5419 #: en/upgrading.dbk:225
395 debacle 5329 msgid ""
396     "In some cases, the use of <command>apt-get</command> for installing packages "
397 debacle 5419 "instead of <command>aptitude</command> might make <command>aptitude</"
398     "command> consider a package as unused and schedule it for removal. In "
399     "general, you should make sure the system is fully up-to-date and clean "
400     "before proceeding with the upgrade."
401 debacle 5329 msgstr ""
402    
403     # type: Content of: <chapter><section><section><para>
404 debacle 5419 #: en/upgrading.dbk:232
405 debacle 5329 msgid ""
406     "Because of this you should review if there are any pending actions in the "
407     "package manager <command>aptitude</command>. If a package is scheduled for "
408     "removal or update in the package manager, it might negatively impact the "
409     "upgrade procedure. Note that correcting this is only possible if your "
410 debacle 5419 "<filename>sources.list</filename> still points to <emphasis>&oldreleasename;"
411     "</emphasis>; and not to <emphasis>stable</emphasis> or "
412     "<emphasis>&releasename;</emphasis>; see <xref linkend=\"old-sources\"/> ."
413 debacle 5329 msgstr ""
414    
415     # type: Content of: <chapter><section><section><para>
416 debacle 5419 #: en/upgrading.dbk:241
417 debacle 5329 msgid ""
418     "To do this, you have to run <command>aptitude</command>'s user interface and "
419 debacle 5419 "press <keycap>g</keycap> (Go). If it shows any actions, you should review "
420     "them and either fix them or implement the suggested actions. If no actions "
421     "are suggested you will be presented with a message saying No packages are "
422     "scheduled to be installed, removed, or upgraded."
423 debacle 5329 msgstr ""
424    
425     # type: Content of: <chapter><section><section><title>
426 debacle 5419 #: en/upgrading.dbk:250
427 debacle 5329 msgid "Disabling APT pinning"
428     msgstr ""
429    
430     # type: Content of: <chapter><section><section><para>
431 debacle 5419 #: en/upgrading.dbk:252
432 debacle 5329 msgid ""
433     "If you have configured APT to install certain packages from a distribution "
434     "other than stable (e.g. from testing), you may have to change your APT "
435     "pinning configuration (stored in <filename>/etc/apt/preferences</filename>) "
436     "to allow the upgrade of packages to the versions in the new stable release. "
437     "Further information on APT pinning can be found in <citerefentry> "
438 debacle 5419 "<refentrytitle>apt_preferences</refentrytitle> <manvolnum>5</manvolnum> </"
439     "citerefentry>."
440 debacle 5329 msgstr ""
441    
442     # type: Content of: <chapter><section><section><title>
443 debacle 5419 #: en/upgrading.dbk:263
444 debacle 5329 msgid "Checking packages status"
445     msgstr ""
446    
447     # type: Content of: <chapter><section><section><para>
448 debacle 5419 #: en/upgrading.dbk:265
449 debacle 5329 msgid ""
450     "Regardless of the method used for upgrading, it is recommended that you "
451     "check the status of all packages first, and verify that all packages are in "
452     "an upgradable state. The following command will show any packages which "
453     "have a status of Half-Installed or Failed-Config, and those with any error "
454     "status."
455     msgstr ""
456    
457     # type: Content of: <chapter><section><section><screen>
458 debacle 5419 #: en/upgrading.dbk:270
459 debacle 5329 #, no-wrap
460     msgid ""
461     "\n"
462     "# dpkg --audit\n"
463     msgstr ""
464    
465     # type: Content of: <chapter><section><section><para>
466 debacle 5419 #: en/upgrading.dbk:274
467 debacle 5329 msgid ""
468     "You could also inspect the state of all packages on your system using "
469     "<command>dselect</command>, <command>aptitude</command>, or with commands "
470     "such as"
471     msgstr ""
472    
473     # type: Content of: <chapter><section><section><screen>
474 debacle 5419 #: en/upgrading.dbk:278
475 debacle 5329 #, no-wrap
476     msgid ""
477     "\n"
478     "# dpkg -l | pager\n"
479     msgstr ""
480    
481     # type: Content of: <chapter><section><section><para>
482 debacle 5419 #: en/upgrading.dbk:282
483 debacle 5329 msgid "or"
484     msgstr ""
485    
486     # type: Content of: <chapter><section><section><screen>
487 debacle 5419 #: en/upgrading.dbk:284
488 debacle 5329 #, no-wrap
489     msgid ""
490     "\n"
491     "# dpkg --get-selections * &gt; ~/curr-pkgs.txt\n"
492     msgstr ""
493    
494     # type: Content of: <chapter><section><section><para>
495 debacle 5419 #: en/upgrading.dbk:288
496 debacle 5329 msgid ""
497     "It is desirable to remove any holds before upgrading. If any package that "
498     "is essential for the upgrade is on hold, the upgrade will fail."
499     msgstr ""
500    
501     # type: Content of: <chapter><section><section><para>
502 debacle 5419 #: en/upgrading.dbk:292
503 debacle 5329 msgid ""
504     "Note that <command>aptitude</command> uses a different method for "
505     "registering packages that are on hold than <command>apt-get</command> and "
506     "<command>dselect</command>. You can identify packages on hold for "
507     "<command>aptitude</command> with"
508     msgstr ""
509    
510     # type: Content of: <chapter><section><section><screen>
511 debacle 5419 #: en/upgrading.dbk:297
512 debacle 5329 #, no-wrap
513     msgid ""
514     "\n"
515     "# aptitude search ~ahold | grep ^.h\n"
516     msgstr ""
517    
518     # type: Content of: <chapter><section><section><para>
519 debacle 5419 #: en/upgrading.dbk:301
520 debacle 5329 msgid ""
521 debacle 5419 "If you want to check which packages you had on hold for <command>apt-get</"
522     "command>, you should use"
523 debacle 5329 msgstr ""
524    
525     # type: Content of: <chapter><section><section><screen>
526 debacle 5419 #: en/upgrading.dbk:304
527 debacle 5329 #, no-wrap
528     msgid ""
529     "\n"
530     "# dpkg --get-selections | grep hold\n"
531     msgstr ""
532    
533     # type: Content of: <chapter><section><section><para>
534 debacle 5419 #: en/upgrading.dbk:308
535 debacle 5329 msgid ""
536     "If you changed and recompiled a package locally, and didn't rename it or put "
537     "an epoch in the version, you must put it on hold to prevent it from being "
538     "upgraded."
539     msgstr ""
540    
541     # type: Content of: <chapter><section><section><para>
542 debacle 5419 #: en/upgrading.dbk:313
543     msgid ""
544     "The hold package state for <command>aptitude</command> can be changed using:"
545 debacle 5329 msgstr ""
546    
547     # type: Content of: <chapter><section><section><screen>
548 debacle 5419 #: en/upgrading.dbk:315
549 debacle 5329 #, no-wrap
550     msgid ""
551     "\n"
552     "# aptitude hold <replaceable>package_name</replaceable>\n"
553     msgstr ""
554    
555     # type: Content of: <chapter><section><section><para>
556 debacle 5419 #: en/upgrading.dbk:319
557 debacle 5329 msgid ""
558     "Replace <literal>hold</literal> with <literal>unhold</literal> to unset the "
559     "hold state."
560     msgstr ""
561    
562     # type: Content of: <chapter><section><section><para>
563 debacle 5419 #: en/upgrading.dbk:323
564 debacle 5329 msgid ""
565     "If there is anything you need to fix, it is best to make sure your "
566     "<filename>sources.list</filename> still refers to &oldreleasename; as "
567     "explained in <xref linkend=\"old-sources\"/> ."
568     msgstr ""
569    
570     # type: Content of: <chapter><section><section><title>
571 debacle 5419 #: en/upgrading.dbk:330
572 debacle 5329 msgid "Unofficial sources and backports"
573     msgstr ""
574    
575     # type: Content of: <chapter><section><section><para>
576 debacle 5419 #: en/upgrading.dbk:332
577 debacle 5329 msgid ""
578     "If you have any non-Debian packages on your system, you should be aware that "
579     "these may be removed during the upgrade because of conflicting "
580     "dependencies. If these packages were installed by adding an extra package "
581     "archive in your <filename>/etc/apt/sources.list</filename>, you should check "
582     "if that archive also offers packages compiled for &releasename; and change "
583     "the source line accordingly at the same time as your source lines for Debian "
584     "packages."
585     msgstr ""
586    
587     # type: Content of: <chapter><section><section><para><footnote>
588 debacle 5419 #: en/upgrading.dbk:340
589 debacle 5329 msgid ""
590     "Some users may have unofficial backported newer versions of packages that "
591     "<emphasis>are</emphasis> in Debian installed on their &oldreleasename; "
592     "system. Such packages are most likely to cause problems during an upgrade "
593     "as they may result in file conflicts<footnote>"
594     msgstr ""
595    
596     # type: Content of: <chapter><section><section><para><footnote><para>
597 debacle 5419 #: en/upgrading.dbk:343
598 debacle 5329 msgid ""
599     "Debian's package management system normally does not allow a package to "
600     "remove or replace a file owned by another package unless it has been defined "
601     "to replace that package."
602     msgstr ""
603    
604     # type: Content of: <chapter><section><section><para>
605 debacle 5419 #: en/upgrading.dbk:345
606 debacle 5329 msgid ""
607 debacle 5427 "</footnote>. <xref linkend=\"trouble\"/> has some information on how to "
608     "deal with file conflicts if they should occur."
609 debacle 5329 msgstr ""
610    
611     # type: Content of: <chapter><section><title>
612 debacle 5419 #: en/upgrading.dbk:354
613 debacle 5329 msgid "Manually unmarking packages"
614     msgstr ""
615    
616     # type: Content of: <chapter><section><para>
617 debacle 5419 #: en/upgrading.dbk:356
618 debacle 5329 msgid ""
619     "To prevent <command>aptitude</command> from removing some packages that were "
620     "pulled in through dependencies, you need to manually unmark them as "
621     "<emphasis>auto</emphasis> packages. This includes OpenOffice and Vim for "
622     "desktop installs:"
623     msgstr ""
624    
625     # type: Content of: <chapter><section><screen>
626 debacle 5419 #: en/upgrading.dbk:361
627 debacle 5329 #, no-wrap
628     msgid ""
629     "\n"
630     "# aptitude unmarkauto openoffice.org vim\n"
631     msgstr ""
632    
633     # type: Content of: <chapter><section><para>
634 debacle 5419 #: en/upgrading.dbk:365
635     msgid ""
636     "And 2.6 kernel images if you have installed them using a kernel metapackage:"
637 debacle 5329 msgstr ""
638    
639     # type: Content of: <chapter><section><screen>
640 debacle 5419 #: en/upgrading.dbk:367
641 debacle 5329 #, no-wrap
642     msgid ""
643     "\n"
644     "# aptitude unmarkauto $(dpkg-query -W 'kernel-image-2.6.*' | cut -f1)\n"
645     msgstr ""
646    
647 debacle 5419 # type: Content of: <chapter><section><note><para>
648     #: en/upgrading.dbk:372
649 debacle 5329 msgid ""
650 debacle 5419 "You can review which packages are marked as <emphasis>auto</emphasis> in "
651     "aptitude by running:"
652 debacle 5329 msgstr ""
653    
654 debacle 5419 # type: Content of: <chapter><section><note><screen>
655     #: en/upgrading.dbk:375
656 debacle 5329 #, no-wrap
657     msgid ""
658     "\n"
659 debacle 5427 "# aptitude search 'i~M &lt;package name&gt;'\n"
660 debacle 5419 " "
661 debacle 5329 msgstr ""
662    
663     # type: Content of: <chapter><section><title>
664 debacle 5419 #: en/upgrading.dbk:382
665 debacle 5329 msgid "Preparing sources for APT"
666     msgstr ""
667    
668     # type: Content of: <chapter><section><para>
669 debacle 5419 #: en/upgrading.dbk:384
670 debacle 5329 msgid ""
671 debacle 5419 "Before starting the upgrade you must set up <systemitem role=\"package"
672     "\">apt</systemitem>'s configuration file for package lists, <filename>/etc/"
673     "apt/sources.list</filename>."
674 debacle 5329 msgstr ""
675    
676     # type: Content of: <chapter><section><para>
677 debacle 5419 #: en/upgrading.dbk:389
678 debacle 5329 msgid ""
679     "<systemitem role=\"package\">apt</systemitem> will consider all packages "
680     "that can be found via any <literal>deb</literal> line, and install the "
681     "package with the highest version number, giving priority to the first "
682     "mentioned lines (that way, in case of multiple mirror locations, you'd "
683     "typically first name a local harddisk, then CD-ROMs, and then HTTP/FTP "
684     "mirrors)."
685     msgstr ""
686    
687     # type: Content of: <chapter><section><para>
688 debacle 5419 #: en/upgrading.dbk:396
689 debacle 5329 msgid ""
690     "A release can often be referred to by both its codename (e.g. "
691     "&oldreleasename;, &releasename;) and by its status name (i.e. oldstable, "
692     "stable, testing, unstable). Referring to a release by its codename has the "
693     "advantage that you will never be surprised by a new release and for this "
694     "reason is the approach taken here. It does of course mean that you will "
695     "have to watch out for release announcements yourself. If you use the status "
696     "name instead, you will just see loads of updates for packages available as "
697     "soon as a release has happened."
698     msgstr ""
699    
700     # type: Content of: <chapter><section><section><title>
701 debacle 5419 #: en/upgrading.dbk:405
702 debacle 5329 msgid "Adding APT Internet sources"
703     msgstr ""
704    
705     # type: Content of: <chapter><section><section><para>
706 debacle 5419 #: en/upgrading.dbk:407
707 debacle 5329 msgid ""
708     "The default configuration is set up for installation from main Debian "
709 debacle 5419 "Internet servers, but you may wish to modify <filename>/etc/apt/sources."
710     "list</filename> to use other mirrors, preferably a mirror that is network-"
711     "wise closest to you."
712 debacle 5329 msgstr ""
713    
714     # type: Content of: <chapter><section><section><para>
715 debacle 5419 #: en/upgrading.dbk:412
716 debacle 5329 msgid ""
717 debacle 5419 "Debian HTTP or FTP mirror addresses can be found at <ulink url=\"&url-debian-"
718     "mirrors;\"></ulink> (look at the Full list of mirrors section). HTTP "
719     "mirrors are generally speedier than FTP mirrors."
720 debacle 5329 msgstr ""
721    
722     # type: Content of: <chapter><section><section><para>
723 debacle 5419 #: en/upgrading.dbk:417
724 debacle 5329 msgid ""
725 debacle 5419 "For example, suppose your closest Debian mirror is <literal>&url-debian-"
726     "mirror-eg;</literal>. When inspecting that mirror with a web browser or FTP "
727     "program, you will notice that the main directories are organized like this:"
728 debacle 5329 msgstr ""
729    
730     # type: Content of: <chapter><section><section><screen>
731 debacle 5419 #: en/upgrading.dbk:422
732 debacle 5329 #, no-wrap
733     msgid ""
734     "\n"
735 debacle 5419 "&url-debian-mirror-eg;/dists/&releasename;/main/binary-i386/...\n"
736     "&url-debian-mirror-eg;/dists/&releasename;/contrib/binary-i386/...\n"
737 debacle 5329 msgstr ""
738    
739     # type: Content of: <chapter><section><section><para>
740 debacle 5419 #: en/upgrading.dbk:427
741 debacle 5329 msgid ""
742     "To use this mirror with <command>apt</command>, you add this line to your "
743     "<filename>sources.list</filename> file:"
744     msgstr ""
745    
746     # type: Content of: <chapter><section><section><screen>
747 debacle 5419 #: en/upgrading.dbk:430
748 debacle 5329 #, no-wrap
749     msgid ""
750     "\n"
751 debacle 5419 "deb &url-debian-mirror-eg;/debian &releasename; main contrib\n"
752 debacle 5329 msgstr ""
753    
754     # type: Content of: <chapter><section><section><para>
755 debacle 5419 #: en/upgrading.dbk:434 en/upgrading.dbk:467
756 debacle 5329 msgid ""
757     "Note that the `<literal>dists</literal>' is added implicitly, and the "
758     "arguments after the release name are used to expand the path into multiple "
759     "directories."
760     msgstr ""
761    
762     # type: Content of: <chapter><section><section><para>
763 debacle 5419 #: en/upgrading.dbk:438 en/upgrading.dbk:471
764 debacle 5329 msgid ""
765 debacle 5419 "After adding your new sources, disable the previously existing <literal>deb</"
766     "literal> lines in <filename>sources.list</filename> by placing a hash sign "
767     "(<literal>#</literal>) in front of them."
768 debacle 5329 msgstr ""
769    
770     # type: Content of: <chapter><section><section><title>
771 debacle 5419 #: en/upgrading.dbk:445
772 debacle 5329 msgid "Adding APT sources for a local mirror"
773     msgstr ""
774    
775     # type: Content of: <chapter><section><section><para>
776 debacle 5419 #: en/upgrading.dbk:447
777 debacle 5329 msgid ""
778     "Instead of using HTTP or FTP packages mirrors, you may wish to modify "
779     "<filename>/etc/apt/sources.list</filename> to use a mirror on a local disk "
780 debacle 5419 "(possibly mounted over"
781 debacle 5329 msgstr ""
782    
783 debacle 5419 # type: Content of: <chapter><section><section><para><acronym>
784     #: en/upgrading.dbk:449
785     msgid "NFS"
786     msgstr ""
787    
788 debacle 5329 # type: Content of: <chapter><section><section><para>
789 debacle 5419 #: en/upgrading.dbk:449
790     msgid ")."
791     msgstr ""
792    
793     # type: Content of: <chapter><section><section><para>
794     #: en/upgrading.dbk:452
795 debacle 5329 msgid ""
796 debacle 5419 "For example, your packages mirror may be under <filename>/var/ftp/debian/</"
797     "filename>, and have main directories like this:"
798 debacle 5329 msgstr ""
799    
800     # type: Content of: <chapter><section><section><screen>
801 debacle 5419 #: en/upgrading.dbk:455
802 debacle 5329 #, no-wrap
803     msgid ""
804     "\n"
805     "/var/ftp/debian/dists/&releasename;/main/binary-i386/...\n"
806     "/var/ftp/debian/dists/&releasename;/contrib/binary-i386/...\n"
807     msgstr ""
808    
809     # type: Content of: <chapter><section><section><para>
810 debacle 5419 #: en/upgrading.dbk:460
811 debacle 5329 msgid ""
812     "To use this with <command>apt</command>, add this line to your "
813     "<filename>sources.list</filename> file:"
814     msgstr ""
815    
816     # type: Content of: <chapter><section><section><screen>
817 debacle 5419 #: en/upgrading.dbk:463
818 debacle 5329 #, no-wrap
819     msgid ""
820     "\n"
821     "deb file:/var/ftp/debian &releasename; main contrib\n"
822     msgstr ""
823    
824     # type: Content of: <chapter><section><section><title>
825 debacle 5419 #: en/upgrading.dbk:478
826 debacle 5329 msgid "Adding APT source from CD-ROM or DVD"
827     msgstr ""
828    
829     # type: Content of: <chapter><section><section><para>
830 debacle 5419 #: en/upgrading.dbk:480
831 debacle 5329 msgid ""
832     "If you want to use CDs <emphasis>only</emphasis>, comment out the existing "
833     "<literal>deb</literal> lines in <filename>/etc/apt/sources.list</filename> "
834     "by placing a hash sign (<literal>#</literal>) in front of them."
835     msgstr ""
836    
837     # type: Content of: <chapter><section><section><para>
838 debacle 5419 #: en/upgrading.dbk:485
839 debacle 5329 msgid ""
840     "Make sure there is a line in <filename>/etc/fstab</filename> that enables "
841     "mounting your CD-ROM drive at the <filename>/cdrom</filename> mount point "
842     "(the exact <filename>/cdrom</filename> mount point is required for "
843 debacle 5419 "<command>apt-cdrom</command>). For example, if <filename>/dev/hdc</"
844     "filename> is your CD-ROM drive, <filename>/etc/fstab</filename> should "
845     "contain a line like:"
846 debacle 5329 msgstr ""
847    
848     # type: Content of: <chapter><section><section><screen>
849 debacle 5419 #: en/upgrading.dbk:492
850 debacle 5329 #, no-wrap
851     msgid ""
852     "\n"
853     "/dev/hdc /cdrom auto defaults,noauto,ro 0 0\n"
854     msgstr ""
855    
856     # type: Content of: <chapter><section><section><para>
857 debacle 5419 #: en/upgrading.dbk:496
858 debacle 5329 msgid ""
859     "Note that there must be <emphasis>no spaces</emphasis> between the words "
860     "<literal>defaults,noauto,ro</literal> in the fourth field."
861     msgstr ""
862    
863     # type: Content of: <chapter><section><section><para>
864 debacle 5419 #: en/upgrading.dbk:500
865 debacle 5329 msgid "To verify it works, insert a CD and try running"
866     msgstr ""
867    
868     # type: Content of: <chapter><section><section><screen>
869 debacle 5419 #: en/upgrading.dbk:502
870 debacle 5329 #, no-wrap
871     msgid ""
872     "\n"
873     "# mount /cdrom # this will mount the CD to the mount point\n"
874     "# ls -alF /cdrom # this should show the CD's root directory\n"
875     "# umount /cdrom # this will unmount the CD\n"
876     msgstr ""
877    
878     # type: Content of: <chapter><section><section><para>
879 debacle 5419 #: en/upgrading.dbk:508
880 debacle 5329 msgid "Next, run:"
881     msgstr ""
882    
883     # type: Content of: <chapter><section><section><screen>
884 debacle 5419 #: en/upgrading.dbk:510
885 debacle 5329 #, no-wrap
886     msgid ""
887     "\n"
888     "# apt-cdrom add\n"
889     msgstr ""
890    
891     # type: Content of: <chapter><section><section><para>
892 debacle 5419 #: en/upgrading.dbk:514
893 debacle 5329 msgid ""
894     "for each Debian Binary CD-ROM you have, to add the data about each CD to "
895     "APT's database."
896     msgstr ""
897    
898     # type: Content of: <chapter><section><title>
899 debacle 5419 #: en/upgrading.dbk:522
900 debacle 5329 msgid "Upgrading packages"
901     msgstr ""
902    
903     # type: Content of: <chapter><section><para>
904 debacle 5419 #: en/upgrading.dbk:524
905 debacle 5329 msgid ""
906     "The recommended way to upgrade from previous &debian; releases is to use the "
907     "package management tool <command>aptitude</command>. This program makes "
908 debacle 5419 "safer decisions about package installations than running <command>apt-get</"
909     "command> directly."
910 debacle 5329 msgstr ""
911    
912     # type: Content of: <chapter><section><para>
913 debacle 5419 #: en/upgrading.dbk:530
914 debacle 5329 msgid ""
915 debacle 5419 "Don't forget to mount all needed partitions (notably the root and <filename>/"
916     "usr</filename> partitions) read-write, with a command like:"
917 debacle 5329 msgstr ""
918    
919     # type: Content of: <chapter><section><screen>
920 debacle 5419 #: en/upgrading.dbk:533
921 debacle 5329 #, no-wrap
922     msgid ""
923     "\n"
924     "# mount -o remount,rw /<replaceable>mountpoint</replaceable>\n"
925     msgstr ""
926    
927     # type: Content of: <chapter><section><para>
928 debacle 5419 #: en/upgrading.dbk:537
929 debacle 5329 msgid ""
930 debacle 5419 "Next you should double-check that the APT source entries (in <filename>/etc/"
931     "apt/sources.list</filename>) refer either to <literal>&releasename;</"
932     "literal> or to <literal>stable</literal>. There should not be any sources "
933     "entries pointing to &oldreleasename;."
934     msgstr ""
935    
936     # type: Content of: <chapter><section><para><note><para>
937     #: en/upgrading.dbk:543
938     msgid ""
939     "Source lines for a CD-ROM will often refer to <literal>unstable</literal>; "
940 debacle 5329 "although this may be confusing, you should <emphasis>not</emphasis> change "
941     "it."
942     msgstr ""
943    
944     # type: Content of: <chapter><section><section><title>
945 debacle 5419 #: en/upgrading.dbk:550
946 debacle 5329 msgid "Recording the session"
947     msgstr ""
948    
949     # type: Content of: <chapter><section><section><para>
950 debacle 5419 #: en/upgrading.dbk:552
951 debacle 5329 msgid ""
952 debacle 5419 "It is strongly recommended that you use the <command>/usr/bin/script</"
953     "command> program to record a transcript of the upgrade session. Then if a "
954     "problem occurs, you will have a log of what happened, and if needed, can "
955     "provide exact information in a bug report. To start the recording, type:"
956 debacle 5329 msgstr ""
957    
958     # type: Content of: <chapter><section><section><screen>
959 debacle 5419 #: en/upgrading.dbk:557
960 debacle 5329 #, no-wrap
961     msgid ""
962     "\n"
963 debacle 5419 "# script -t 2&gt;~/upgrade-&releasename;.time -a ~/upgrade-&releasename;.script\n"
964 debacle 5329 msgstr ""
965    
966     # type: Content of: <chapter><section><section><para>
967 debacle 5419 #: en/upgrading.dbk:561
968 debacle 5329 msgid ""
969     "or similar. Do not put the typescript file in a temporary directory such as "
970     "<filename>/tmp</filename> or <filename>/var/tmp</filename> (files in those "
971     "directories may be deleted during the upgrade or during any restart)."
972     msgstr ""
973    
974     # type: Content of: <chapter><section><section><para>
975 debacle 5419 #: en/upgrading.dbk:566
976 debacle 5329 msgid ""
977     "The typescript will also allow you to review information that has scrolled "
978     "off-screen. Just switch to VT2 (using <literal>Alt-F2</literal>) and, after "
979 debacle 5419 "logging in, use <literal>less -R ~root/upgrade-&releasename;.script</"
980     "literal> to view the file."
981 debacle 5329 msgstr ""
982    
983     # type: Content of: <chapter><section><section><para>
984 debacle 5419 #: en/upgrading.dbk:572
985 debacle 5329 msgid ""
986     "After you have completed the upgrade, you can stop <command>script</command> "
987     "by typing <literal>exit</literal> at the prompt."
988     msgstr ""
989    
990 debacle 5419 # type: Content of: <chapter><section><section><programlisting>
991     #: en/upgrading.dbk:576
992     #, no-wrap
993     msgid ""
994     "\n"
995     "TODO: Could mention the script I provided in 400725 which is useful if you \n"
996     "have not dumped the timing file\n"
997     msgstr ""
998    
999 debacle 5329 # type: Content of: <chapter><section><section><para>
1000 debacle 5419 #: en/upgrading.dbk:582
1001 debacle 5329 msgid ""
1002 debacle 5419 "If you have used the <emphasis>-t</emphasis> switch for <command>script</"
1003     "command> you can use the <command>scriptreplay</command> program to replay "
1004     "the whole session:"
1005 debacle 5329 msgstr ""
1006    
1007     # type: Content of: <chapter><section><section><screen>
1008 debacle 5419 #: en/upgrading.dbk:586
1009 debacle 5329 #, no-wrap
1010     msgid ""
1011     "\n"
1012     "# scriptreplay ~/upgrade-&releasename;.time ~/upgrade-&releasename;.script\n"
1013     msgstr ""
1014    
1015     # type: Content of: <chapter><section><section><title>
1016 debacle 5419 #: en/upgrading.dbk:592
1017 debacle 5329 msgid "Updating the package list"
1018     msgstr ""
1019    
1020     # type: Content of: <chapter><section><section><para>
1021 debacle 5419 #: en/upgrading.dbk:594
1022 debacle 5329 msgid ""
1023     "First the list of available packages for the new release needs to be "
1024     "fetched. This is done by executing:"
1025     msgstr ""
1026    
1027     # type: Content of: <chapter><section><section><screen>
1028 debacle 5419 #: en/upgrading.dbk:597 en/upgrading.dbk:924
1029 debacle 5329 #, no-wrap
1030     msgid ""
1031     "\n"
1032     "# aptitude update\n"
1033     msgstr ""
1034    
1035     # type: Content of: <chapter><section><section><para>
1036 debacle 5419 #: en/upgrading.dbk:601
1037 debacle 5329 msgid ""
1038     "Running this the first time new sources are updated will print out some "
1039     "warnings related to the availability of the sources. These warnings are "
1040     "harmless and will not appear if you rerun the command again."
1041     msgstr ""
1042    
1043     # type: Content of: <chapter><section><section><title>
1044 debacle 5419 #: en/upgrading.dbk:608
1045 debacle 5329 msgid "Make sure you have sufficient space for the upgrade"
1046     msgstr ""
1047    
1048     # type: Content of: <chapter><section><section><para>
1049 debacle 5419 #: en/upgrading.dbk:610
1050 debacle 5329 msgid ""
1051     "You have to make sure before upgrading your system that you have sufficient "
1052     "hard disk space when you start the full system upgrade described in <xref "
1053     "linkend=\"upgrading-other\"/> . First, any package needed for installation "
1054 debacle 5419 "that is fetched from the network is stored in <filename>/var/cache/apt/"
1055     "archives</filename> (and the <filename>partial/</filename> subdirectory, "
1056     "during download), so you must make sure you have enough space on the file "
1057     "system partition that holds <filename>/var/</filename> to temporarily "
1058     "download the packages that will be installed in your system. After the "
1059     "download, you will probably need more space in other file system partitions "
1060     "in order to both install upgraded packages (which might contain bigger "
1061     "binaries or more data) and new packages that will be pulled in for the "
1062     "upgrade. If your system does not have sufficient space you might end up "
1063     "with an incomplete upgrade that might be difficult to recover from."
1064 debacle 5329 msgstr ""
1065    
1066     # type: Content of: <chapter><section><section><para>
1067 debacle 5419 #: en/upgrading.dbk:626
1068 debacle 5329 msgid ""
1069     "Both <command>aptitude</command> and <command>apt</command> will show you "
1070     "detailed information of the disk space needed for the installation. Before "
1071     "executing the upgrade, you can see this estimate by running:"
1072     msgstr ""
1073    
1074     # type: Content of: <chapter><section><section><screen>
1075 debacle 5419 #: en/upgrading.dbk:630
1076 debacle 5329 #, no-wrap
1077     msgid ""
1078     "\n"
1079     "# aptitude -y -s -f --with-recommends dist-upgrade\n"
1080     "[ ... ]\n"
1081     "XXX upgraded, XXX newly installed, XXX to remove and XXX not upgraded.\n"
1082     "Need to get xx.xMB/yyyMB of archives. After unpacking AAAMB will be used.\n"
1083     "Would download/install/remove packages.\n"
1084     msgstr ""
1085    
1086     # type: Content of: <chapter><section><section><para><footnote>
1087 debacle 5419 #: en/upgrading.dbk:638
1088 debacle 5329 msgid "<footnote>"
1089     msgstr ""
1090    
1091     # type: Content of: <chapter><section><section><para><footnote><para>
1092 debacle 5419 #: en/upgrading.dbk:638
1093 debacle 5329 msgid ""
1094     "Running this command at the beginning of the upgrade process may give an "
1095     "error, for the reasons described in the next sections. In that case you "
1096     "will need to wait until you've done the minimal system upgrade as in <xref "
1097 debacle 5419 "linkend=\"minimal-upgrade\"/> and upgraded your kernel as in <xref linkend="
1098     "\"upgrading-kernel\"/> before running this command to estimate the disk "
1099     "space."
1100 debacle 5329 msgstr ""
1101    
1102     # type: Content of: <chapter><section><section><section><para>
1103 debacle 5419 #: en/upgrading.dbk:643 en/upgrading.dbk:815
1104 debacle 5329 msgid "</footnote>"
1105     msgstr ""
1106    
1107     # type: Content of: <chapter><section><section><para>
1108 debacle 5419 #: en/upgrading.dbk:646
1109 debacle 5329 msgid ""
1110     "If you do not have enough space for the upgrade, make sure you free up space "
1111     "beforehand. You can:"
1112     msgstr ""
1113    
1114     # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1115 debacle 5419 #: en/upgrading.dbk:652
1116 debacle 5329 msgid ""
1117     "Remove packages that have been previously downloaded for installation (at "
1118     "<filename>/var/cache/apt/archive</filename>). Cleaning up the package cache "
1119 debacle 5419 "by running <command>apt-get clean</command> or <command>aptitude clean</"
1120     "command> will remove all previously downloaded package files."
1121 debacle 5329 msgstr ""
1122    
1123     # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1124 debacle 5419 #: en/upgrading.dbk:660
1125 debacle 5329 msgid ""
1126 debacle 5419 "Remove old packages you no longer use. If you have <command>popularity-"
1127     "contest</command> installed, you can use <command>popcon-largest-unused</"
1128     "command> to list the packages you do not use in the system that occupy the "
1129     "most space. You can also use <command>deborphan</command> or "
1130     "<command>debfoster</command> to find obsolete packages (see <xref linkend="
1131     "\"obsolete\"/> ). Alternatively you can start <command>aptitude</command> "
1132     "in visual mode and find obsolete packages under Obsolete and Locally Created "
1133     "Packages."
1134 debacle 5329 msgstr ""
1135    
1136     # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1137 debacle 5419 #: en/upgrading.dbk:672
1138 debacle 5329 msgid ""
1139     "Remove packages taking up too much space, which are not currently needed "
1140     "(you can always reinstall them after the upgrade). You can list the "
1141     "packages that take up most of the disk space with <command>dpigs</command> "
1142     "(available in the <systemitem role=\"package\">debian-goodies</systemitem> "
1143 debacle 5419 "package) or with <command>wajig</command> (running <literal>wajig size</"
1144     "literal>)."
1145 debacle 5329 msgstr ""
1146    
1147 debacle 5419 # type: Content of: <chapter><section><section><itemizedlist><listitem><programlisting>
1148     #: en/upgrading.dbk:678
1149     #, no-wrap
1150     msgid ""
1151     "\n"
1152     "TODO: consider this for lenny\n"
1153     "You can list packages that take up most of the disk space with\n"
1154     " /aptitude/ . Start /aptitude/ into \"visual mode\", select\n"
1155     " \"Views\" and \"New Flat Package List\" (this menu entry is available only\n"
1156     " after etch version), press \"l\" and enter \"~i\", press \"S\" and enter\n"
1157     " \"~installsize\", then it will give you nice list to work with. Doing\n"
1158     " this after partial upgrade described in ref id=\"upgrading_aptitude\"\n"
1159     " should give you access to this new feature.\n"
1160     msgstr ""
1161    
1162 debacle 5329 # type: Content of: <chapter><section><section><itemizedlist><listitem><para>
1163 debacle 5419 #: en/upgrading.dbk:692
1164 debacle 5329 msgid ""
1165     "Temporarily move to another system, or permanently remove, system logs "
1166     "residing under <filename>/var/log/</filename>."
1167     msgstr ""
1168    
1169     # type: Content of: <chapter><section><section><para>
1170 debacle 5419 #: en/upgrading.dbk:698
1171 debacle 5329 msgid ""
1172     "Note that in order to safely remove packages, it is advisable to switch your "
1173     "<filename>sources.list</filename> back to &oldreleasename; as described in "
1174     "<xref linkend=\"old-sources\"/> ."
1175     msgstr ""
1176    
1177     # type: Content of: <chapter><section><section><title>
1178 debacle 5419 #: en/upgrading.dbk:705
1179 debacle 5329 msgid "Minimal system upgrade"
1180     msgstr ""
1181    
1182     # type: Content of: <chapter><section><section><para>
1183 debacle 5419 #: en/upgrading.dbk:707
1184 debacle 5329 msgid ""
1185     "Because of certain necessary package conflicts between &oldreleasename; and "
1186     "&releasename;, running <literal>aptitude dist-upgrade</literal> directly "
1187     "will often remove large numbers of packages that you will want to keep. We "
1188     "therefore recommend a two-part upgrade process, first a minimal upgrade to "
1189     "overcome these conflicts, then a full <literal>dist-upgrade</literal>."
1190     msgstr ""
1191    
1192     # type: Content of: <chapter><section><section><para>
1193 debacle 5419 #: en/upgrading.dbk:714
1194 debacle 5329 msgid "First, run:"
1195     msgstr ""
1196    
1197     # type: Content of: <chapter><section><section><screen>
1198 debacle 5419 #: en/upgrading.dbk:716
1199 debacle 5329 #, no-wrap
1200     msgid ""
1201     "\n"
1202     "# aptitude upgrade\n"
1203     msgstr ""
1204    
1205     # type: Content of: <chapter><section><section><para>
1206 debacle 5419 #: en/upgrading.dbk:720
1207 debacle 5329 msgid ""
1208     "This has the effect of upgrading those packages which can be upgraded "
1209     "without requiring any other packages to be removed or installed."
1210     msgstr ""
1211    
1212     # type: Content of: <chapter><section><section><para>
1213 debacle 5419 #: en/upgrading.dbk:724
1214 debacle 5329 msgid "Follow the minimal upgrade with:"
1215     msgstr ""
1216    
1217     # type: Content of: <chapter><section><section><screen>
1218 debacle 5419 #: en/upgrading.dbk:726
1219 debacle 5329 #, no-wrap
1220     msgid ""
1221     "\n"
1222 debacle 5419 "TODO: initrd-tools does not exist in lenny\n"
1223 debacle 5329 "# aptitude install initrd-tools\n"
1224     msgstr ""
1225    
1226     # type: Content of: <chapter><section><section><para>
1227 debacle 5419 #: en/upgrading.dbk:731
1228 debacle 5329 msgid ""
1229 debacle 5419 "This step will automatically upgrade <systemitem role=\"package\">libc6</"
1230     "systemitem> and <systemitem role=\"package\">locales</systemitem> and will "
1231     "pull in SELinux support libraries (<systemitem role=\"package\">libselinux1</"
1232     "systemitem>). At this point, some running services will be restarted, "
1233     "including <command>xdm</command>, <command>gdm</command> and <command>kdm</"
1234     "command>. As a consequence, local X11 sessions will be disconnected."
1235 debacle 5329 msgstr ""
1236    
1237     # type: Content of: <chapter><section><section><para>
1238 debacle 5419 #: en/upgrading.dbk:740
1239 debacle 5329 msgid ""
1240     "The next step will vary depending on the set of packages that you have "
1241     "installed. These release notes give general advice about which method "
1242     "should be used, but if in doubt, it is recommended that you examine the "
1243     "package removals proposed by each method before proceeding."
1244     msgstr ""
1245    
1246     # type: Content of: <chapter><section><section><para>
1247 debacle 5419 #: en/upgrading.dbk:746
1248 debacle 5329 msgid ""
1249     "Some common packages that are expected to be removed include <systemitem "
1250 debacle 5419 "role=\"package\">base-config</systemitem>, <systemitem role=\"package"
1251     "\">hotplug</systemitem>, <systemitem role=\"package\">xlibs</systemitem>, "
1252     "<systemitem role=\"package\">netkit-inetd</systemitem>, <systemitem role="
1253     "\"package\">python2.3</systemitem>, <systemitem role=\"package\">xfree86-"
1254     "common</systemitem>, and <systemitem role=\"package\">xserver-common</"
1255     "systemitem>. For a more complete list of packages obsoleted in "
1256     "&releasename;, see <xref linkend=\"obsolete\"/> ."
1257 debacle 5329 msgstr ""
1258    
1259     # type: Content of: <chapter><section><section><section><title>
1260 debacle 5419 #: en/upgrading.dbk:757
1261 debacle 5329 msgid "Upgrading a desktop system"
1262     msgstr ""
1263    
1264     # type: Content of: <chapter><section><section><section><para>
1265 debacle 5419 #: en/upgrading.dbk:759
1266 debacle 5329 msgid ""
1267     "This upgrade path has been verified to work on systems with the "
1268     "&oldreleasename; <literal>desktop</literal> task installed. It is probably "
1269     "the method that will give the best results on systems with the "
1270 debacle 5419 "<literal>desktop</literal> task installed, or with the <literal>gnome</"
1271     "literal> or <literal>kde</literal> packages installed."
1272 debacle 5329 msgstr ""
1273    
1274     # type: Content of: <chapter><section><section><section><para>
1275 debacle 5419 #: en/upgrading.dbk:766
1276 debacle 5329 msgid ""
1277     "It is probably <emphasis>not</emphasis> the correct method to use if you do "
1278     "not already have the <systemitem role=\"package\">libfam0c102</systemitem> "
1279     "and <systemitem role=\"package\">xlibmesa-glu</systemitem> packages "
1280     "installed:"
1281     msgstr ""
1282    
1283     # type: Content of: <chapter><section><section><section><screen>
1284 debacle 5419 #: en/upgrading.dbk:770 en/upgrading.dbk:802
1285 debacle 5329 #, no-wrap
1286     msgid ""
1287     "\n"
1288     "# dpkg -l libfam0c102 | grep ^ii\n"
1289     "# dpkg -l xlibmesa-glu | grep ^ii\n"
1290     msgstr ""
1291    
1292     # type: Content of: <chapter><section><section><section><para>
1293 debacle 5419 #: en/upgrading.dbk:775
1294 debacle 5329 msgid "If you do have a full desktop system installed, run:"
1295     msgstr ""
1296    
1297     # type: Content of: <chapter><section><section><section><screen>
1298 debacle 5419 #: en/upgrading.dbk:777
1299 debacle 5329 #, no-wrap
1300     msgid ""
1301     "\n"
1302     "# aptitude install libfam0 xlibmesa-glu\n"
1303     msgstr ""
1304    
1305     # type: Content of: <chapter><section><section><section><title>
1306 debacle 5419 #: en/upgrading.dbk:783
1307 debacle 5329 msgid "Upgrading a system with some X packages installed"
1308     msgstr ""
1309    
1310     # type: Content of: <chapter><section><section><section><para>
1311 debacle 5419 #: en/upgrading.dbk:785
1312 debacle 5329 msgid ""
1313 debacle 5419 "Systems with some X packages installed, but not the full <literal>desktop</"
1314     "literal> task, require a different method. This method applies in general "
1315     "to systems with <systemitem role=\"package\">xfree86-common</systemitem> "
1316     "installed, including some server systems which have <systemitem role="
1317     "\"package\">tasksel</systemitem> server tasks installed as some of these "
1318     "tasks include graphical management tools. It is likely the correct method "
1319     "to use on systems which run X, but do not have the full <literal>desktop</"
1320     "literal> task installed."
1321 debacle 5329 msgstr ""
1322    
1323     # type: Content of: <chapter><section><section><section><screen>
1324 debacle 5419 #: en/upgrading.dbk:794
1325 debacle 5329 #, no-wrap
1326     msgid ""
1327     "\n"
1328     "# dpkg -l xfree86-common | grep ^ii\n"
1329     msgstr ""
1330    
1331     # type: Content of: <chapter><section><section><section><para>
1332 debacle 5419 #: en/upgrading.dbk:798
1333 debacle 5329 msgid ""
1334 debacle 5419 "First, check whether you have the <systemitem role=\"package\">libfam0c102</"
1335     "systemitem> and <systemitem role=\"package\">xlibmesa-glu</systemitem> "
1336     "packages installed."
1337 debacle 5329 msgstr ""
1338    
1339     # type: Content of: <chapter><section><section><section><para><footnote>
1340 debacle 5419 #: en/upgrading.dbk:807
1341 debacle 5329 msgid ""
1342     "If you do not have <systemitem role=\"package\">libfam0c102</systemitem> "
1343     "installed, do not include <systemitem role=\"package\">libfam0</systemitem> "
1344 debacle 5419 "in the following commandline. If you do not have <systemitem role=\"package"
1345     "\">xlibmesa-glu</systemitem> installed, do not include it in the following "
1346     "commandline. <footnote>"
1347 debacle 5329 msgstr ""
1348    
1349     # type: Content of: <chapter><section><section><section><para><footnote><para>
1350 debacle 5419 #: en/upgrading.dbk:811
1351 debacle 5329 msgid ""
1352     "This command will determine whether you need libfam0 and xlibmesa-glu "
1353     "installed, and auto-select them for you:"
1354     msgstr ""
1355    
1356     # type: Content of: <chapter><section><section><section><para><footnote><screen>
1357 debacle 5419 #: en/upgrading.dbk:813
1358 debacle 5329 #, no-wrap
1359     msgid ""
1360     " # aptitude install x11-common \\ $(dpkg-query --showformat\n"
1361 debacle 5419 "'${Package} ${Status}\\n' -W libfam0c102 xlibmesa-glu \\ | grep 'ok installed$' |\n"
1362 debacle 5329 "sed -e's/ .*//; s/c102//') "
1363     msgstr ""
1364    
1365     # type: Content of: <chapter><section><section><section><screen>
1366 debacle 5419 #: en/upgrading.dbk:817
1367 debacle 5329 #, no-wrap
1368     msgid ""
1369     "\n"
1370 debacle 5419 "# aptitude install x11-common <replaceable>libfam0</replaceable> <replaceable>xlibmesa-glu</replaceable>\n"
1371 debacle 5329 msgstr ""
1372    
1373     # type: Content of: <chapter><section><section><section><para>
1374 debacle 5419 #: en/upgrading.dbk:821
1375 debacle 5329 msgid ""
1376     "Note that installing <systemitem role=\"package\">libfam0</systemitem> will "
1377 debacle 5419 "also install the File Alteration Monitor (<systemitem role=\"package\">fam</"
1378     "systemitem>) as well as the RPC portmapper (<systemitem role=\"package"
1379     "\">portmap</systemitem>) if not already available in your system. Both "
1380     "packages will enable a new network service in the system although they can "
1381     "both be configured to be bound to the (internal) loopback network device."
1382 debacle 5329 msgstr ""
1383    
1384     # type: Content of: <chapter><section><section><section><title>
1385 debacle 5419 #: en/upgrading.dbk:831
1386 debacle 5329 msgid "Upgrading a system with no X support installed"
1387     msgstr ""
1388    
1389     # type: Content of: <chapter><section><section><section><para>
1390 debacle 5419 #: en/upgrading.dbk:833
1391 debacle 5329 msgid ""
1392     "On a system with no X, no additional <literal>aptitude install</literal> "
1393     "command should be required, and you can move on to the next step."
1394     msgstr ""
1395    
1396     # type: Content of: <chapter><section><section><title>
1397 debacle 5419 #: en/upgrading.dbk:841
1398 debacle 5329 msgid "Upgrading the kernel"
1399     msgstr ""
1400    
1401     # type: Content of: <chapter><section><section><para>
1402 debacle 5419 #: en/upgrading.dbk:843
1403 debacle 5329 msgid ""
1404     "The <systemitem role=\"package\">udev</systemitem> version in &releasename; "
1405     "does not support kernel versions earlier than 2.6.15 (which includes "
1406 debacle 5419 "&oldreleasename; 2.6.8 kernels), and the <systemitem role=\"package\">udev</"
1407     "systemitem> version in &oldreleasename; will not work properly with the "
1408     "latest kernels. In addition, installing the &releasename; version of "
1409     "<systemitem role=\"package\">udev</systemitem> will force the removal of "
1410     "<systemitem role=\"package\">hotplug</systemitem>, used by Linux 2.4 kernels."
1411 debacle 5329 msgstr ""
1412    
1413     # type: Content of: <chapter><section><section><para>
1414 debacle 5419 #: en/upgrading.dbk:852
1415 debacle 5329 msgid ""
1416     "As a consequence, the previous kernel package will probably not boot "
1417     "properly after this upgrade. Similarly, there is a time window during the "
1418     "upgrade in which <systemitem role=\"package\">udev</systemitem> has been "
1419     "upgraded but the latest kernel has not been installed. If the system were "
1420     "to be rebooted at this point, in the middle of the upgrade, it might not be "
1421     "bootable because of drivers not being properly detected and loaded. (See "
1422     "<xref linkend=\"upgrade-preparations\"/> for recommendations on preparing "
1423     "for this possibility if you are upgrading remotely.)"
1424     msgstr ""
1425    
1426     # type: Content of: <chapter><section><section><para>
1427 debacle 5419 #: en/upgrading.dbk:862
1428 debacle 5329 msgid ""
1429     "Unless your system has the <literal>desktop</literal> task installed, or "
1430     "other packages that would cause an unacceptable number of package removals, "
1431     "it is therefore recommended that you upgrade the kernel on its own at this "
1432     "point."
1433     msgstr ""
1434    
1435     # type: Content of: <chapter><section><section><para>
1436 debacle 5419 #: en/upgrading.dbk:867
1437 debacle 5329 msgid "To proceed with this kernel upgrade, run:"
1438     msgstr ""
1439    
1440     # type: Content of: <chapter><section><section><screen>
1441 debacle 5419 #: en/upgrading.dbk:869
1442 debacle 5329 #, no-wrap
1443     msgid ""
1444     "\n"
1445     "# aptitude install linux-image-2.6-<replaceable>flavor</replaceable>\n"
1446     msgstr ""
1447    
1448     # type: Content of: <chapter><section><section><para>
1449 debacle 5419 #: en/upgrading.dbk:873
1450 debacle 5329 msgid ""
1451     "See <xref linkend=\"kernel-metapackage\"/> for help in determining which "
1452     "flavor of kernel package you should install."
1453     msgstr ""
1454    
1455     # type: Content of: <chapter><section><section><para>
1456 debacle 5419 #: en/upgrading.dbk:877
1457 debacle 5329 msgid ""
1458     "In the desktop case, it is unfortunately not possible to ensure the new "
1459 debacle 5419 "kernel package is installed immediately after the new <systemitem role="
1460     "\"package\">udev</systemitem> is installed, so there is a window of unknown "
1461     "length when your system will have no kernel installed with full hotplug "
1462     "support. See <xref linkend=\"newkernel\"/> for information on configuring "
1463     "your system to not depend on hotplug for booting."
1464 debacle 5329 msgstr ""
1465    
1466     # type: Content of: <chapter><section><section><title>
1467 debacle 5419 #: en/upgrading.dbk:887
1468 debacle 5329 msgid "Upgrading the rest of the system"
1469     msgstr ""
1470    
1471     # type: Content of: <chapter><section><section><para>
1472 debacle 5419 #: en/upgrading.dbk:889
1473     msgid ""
1474     "You are now ready to continue with the main part of the upgrade. Execute:"
1475 debacle 5329 msgstr ""
1476    
1477     # type: Content of: <chapter><section><section><screen>
1478 debacle 5419 #: en/upgrading.dbk:891
1479 debacle 5329 #, no-wrap
1480     msgid ""
1481     "\n"
1482     "# aptitude dist-upgrade\n"
1483     msgstr ""
1484    
1485     # type: Content of: <chapter><section><section><para>
1486 debacle 5419 #: en/upgrading.dbk:895
1487 debacle 5329 msgid ""
1488     "This will perform a complete upgrade of the system, i.e. install the newest "
1489     "available versions of all packages, and resolve all possible dependency "
1490     "changes between packages in different releases. If necessary, it will "
1491     "install some new packages (usually new library versions, or renamed "
1492     "packages), and remove any conflicting obsoleted packages."
1493     msgstr ""
1494    
1495     # type: Content of: <chapter><section><section><para>
1496 debacle 5419 #: en/upgrading.dbk:902
1497 debacle 5329 msgid ""
1498     "When upgrading from a set of CD-ROMs, you will be asked to insert specific "
1499     "CDs at several points during the upgrade. You might have to insert the same "
1500     "CD multiple times; this is due to inter-related packages that have been "
1501     "spread out over the CDs."
1502     msgstr ""
1503    
1504     # type: Content of: <chapter><section><section><para>
1505 debacle 5419 #: en/upgrading.dbk:908
1506 debacle 5329 msgid ""
1507     "New versions of currently installed packages that cannot be upgraded without "
1508     "changing the install status of another package will be left at their current "
1509     "version (displayed as held back). This can be resolved by either using "
1510     "<command>aptitude</command> to choose these packages for installation or by "
1511 debacle 5419 "trying <literal>aptitude -f install <replaceable>package</replaceable></"
1512     "literal>."
1513 debacle 5329 msgstr ""
1514    
1515     # type: Content of: <chapter><section><section><title>
1516 debacle 5419 #: en/upgrading.dbk:918
1517 debacle 5329 msgid "Getting package signatures"
1518     msgstr ""
1519    
1520     # type: Content of: <chapter><section><section><para>
1521 debacle 5419 #: en/upgrading.dbk:920
1522 debacle 5329 msgid ""
1523     "After the upgrade, with the new version of <command>apt</command> you can "
1524     "now update your package information, which will include the new package "
1525     "signature checking mechanism:"
1526     msgstr ""
1527    
1528     # type: Content of: <chapter><section><section><para>
1529 debacle 5419 #: en/upgrading.dbk:928
1530 debacle 5329 msgid ""
1531     "The upgrade will have already retrieved and enabled the signing keys for "
1532     "Debian's package archives. If you add other (unofficial) package sources, "
1533     "<command>apt</command> will print warnings related to its inability to "
1534     "confirm that packages downloaded from them are legitimate and have not been "
1535 debacle 5419 "tampered with. For more information please see <xref linkend=\"pkgmgmt\"/> ."
1536 debacle 5329 msgstr ""
1537    
1538     # type: Content of: <chapter><section><section><para>
1539 debacle 5419 #: en/upgrading.dbk:935
1540 debacle 5329 msgid ""
1541 debacle 5419 "You will notice that, since you are using the new version of <command>apt</"
1542     "command>, it will download package differences files (<literal>pdiff</"
1543     "literal>) instead of the full package index list. For more information on "
1544     "this feature please read <xref linkend=\"apt-pdiff\"/> ."
1545 debacle 5329 msgstr ""
1546    
1547     # type: Content of: <chapter><section><section><title>
1548 debacle 5419 #: en/upgrading.dbk:943
1549 debacle 5329 msgid "Possible issues during upgrade"
1550     msgstr ""
1551    
1552     # type: Content of: <chapter><section><section><para>
1553 debacle 5419 #: en/upgrading.dbk:945
1554 debacle 5329 msgid ""
1555 debacle 5419 "If an operation using <command>aptitude</command>, <command>apt-get</"
1556     "command>, or <command>dpkg</command> fails with the error"
1557 debacle 5329 msgstr ""
1558    
1559     # type: Content of: <chapter><section><section><screen>
1560 debacle 5419 #: en/upgrading.dbk:948
1561 debacle 5329 #, no-wrap
1562     msgid ""
1563     "\n"
1564     "E: Dynamic MMap ran out of room\n"
1565     msgstr ""
1566    
1567     # type: Content of: <chapter><section><section><para>
1568 debacle 5419 #: en/upgrading.dbk:952
1569 debacle 5329 msgid ""
1570     "the default cache space is insufficient. You can solve this by either "
1571 debacle 5419 "removing or commenting lines you don't need in <filename>/etc/apt/sources."
1572     "list</filename> or by increasing the cache size. The cache size can be "
1573     "increased by setting <literal>APT::Cache-Limit</literal> in <filename>/etc/"
1574     "apt/apt.conf</filename>. The following command will set it to a value that "
1575     "should be sufficient for the upgrade:"
1576 debacle 5329 msgstr ""
1577    
1578     # type: Content of: <chapter><section><section><screen>
1579 debacle 5419 #: en/upgrading.dbk:959
1580 debacle 5329 #, no-wrap
1581     msgid ""
1582     "\n"
1583     "# echo 'APT::Cache-Limit 12500000;' &gt;&gt; /etc/apt/apt.conf\n"
1584     msgstr ""
1585    
1586     # type: Content of: <chapter><section><section><para>
1587 debacle 5419 #: en/upgrading.dbk:963
1588 debacle 5329 msgid "This assumes that you do not yet have this variable set in that file."
1589     msgstr ""
1590    
1591     # type: Content of: <chapter><section><section><para>
1592 debacle 5419 #: en/upgrading.dbk:966
1593 debacle 5329 msgid ""
1594 debacle 5419 "Sometimes it's necessary to enable the <literal>APT::Force-LoopBreak</"
1595     "literal> option in APT to be able to temporarily remove an essential package "
1596     "due to a Conflicts/Pre-Depends loop. <command>aptitude</command> will alert "
1597     "you of this and abort the upgrade. You can work around that by specifying "
1598     "<literal>-o APT::Force-LoopBreak=1</literal> option on <command>aptitude</"
1599     "command> command line."
1600 debacle 5329 msgstr ""
1601    
1602     # type: Content of: <chapter><section><section><para>
1603 debacle 5419 #: en/upgrading.dbk:974
1604 debacle 5329 msgid ""
1605     "It is possible that a system's dependency structure can be so corrupt as to "
1606 debacle 5419 "require manual intervention. Usually this means using <command>aptitude</"
1607     "command> or"
1608 debacle 5329 msgstr ""
1609    
1610     # type: Content of: <chapter><section><section><screen>
1611 debacle 5419 #: en/upgrading.dbk:978
1612 debacle 5329 #, no-wrap
1613     msgid ""
1614     "\n"
1615     "# dpkg --remove <replaceable>package_name</replaceable>\n"
1616     msgstr ""
1617    
1618     # type: Content of: <chapter><section><section><para>
1619 debacle 5419 #: en/upgrading.dbk:982
1620 debacle 5329 msgid "to eliminate some of the offending packages, or"
1621     msgstr ""
1622    
1623     # type: Content of: <chapter><section><section><screen>
1624 debacle 5419 #: en/upgrading.dbk:984
1625 debacle 5329 #, no-wrap
1626     msgid ""
1627     "\n"
1628     "# aptitude -f install\n"
1629     "# dpkg --configure --pending\n"
1630     msgstr ""
1631    
1632     # type: Content of: <chapter><section><section><para>
1633 debacle 5419 #: en/upgrading.dbk:989
1634     msgid ""
1635     "In extreme cases you might have to force re-installation with a command like"
1636 debacle 5329 msgstr ""
1637    
1638     # type: Content of: <chapter><section><section><screen>
1639 debacle 5419 #: en/upgrading.dbk:991
1640 debacle 5329 #, no-wrap
1641     msgid ""
1642     "\n"
1643     "# dpkg --install <replaceable>/path/to/package_name.deb</replaceable>\n"
1644     msgstr ""
1645    
1646     # type: Content of: <chapter><section><section><para>
1647 debacle 5419 #: en/upgrading.dbk:995
1648 debacle 5329 msgid ""
1649     "File conflicts should not occur if you upgrade from a pure &oldreleasename; "
1650     "system, but can occur if you have unofficial backports installed. A file "
1651     "conflict will result in an error like:"
1652     msgstr ""
1653    
1654     # type: Content of: <chapter><section><section><screen>
1655 debacle 5419 #: en/upgrading.dbk:999
1656 debacle 5329 #, no-wrap
1657     msgid ""
1658     "\n"
1659 debacle 5419 "Unpacking <replaceable>&lt;package-foo&gt;</replaceable> (from <replaceable>&lt;package-foo-file&gt;</replaceable>) ...\n"
1660     "dpkg: error processing <replaceable>&lt;package-foo&gt;</replaceable> (--install):\n"
1661 debacle 5329 " trying to overwrite `<replaceable>&lt;some-file-name&gt;</replaceable>',\n"
1662     " which is also in package <replaceable>&lt;package-bar&gt;</replaceable>\n"
1663     "dpkg-deb: subprocess paste killed by signal (Broken pipe)\n"
1664     " Errors were encountered while processing:\n"
1665     " <replaceable>&lt;package-foo&gt;</replaceable>\n"
1666     msgstr ""
1667    
1668     # type: Content of: <chapter><section><section><para>
1669 debacle 5419 #: en/upgrading.dbk:1009
1670 debacle 5329 msgid ""
1671     "You can try to solve a file conflict by forcibly removing the package "
1672     "mentioned on the <emphasis>last</emphasis> line of the error message:"
1673     msgstr ""
1674    
1675     # type: Content of: <chapter><section><section><screen>
1676 debacle 5419 #: en/upgrading.dbk:1012
1677 debacle 5329 #, no-wrap
1678     msgid ""
1679     "\n"
1680     "# dpkg -r --force-depends <replaceable>package_name</replaceable>\n"
1681     msgstr ""
1682    
1683     # type: Content of: <chapter><section><section><para>
1684 debacle 5419 #: en/upgrading.dbk:1016
1685 debacle 5329 msgid ""
1686     "After fixing things up, you should be able to resume the upgrade by "
1687     "repeating the previously described <literal>aptitude</literal> commands."
1688     msgstr ""
1689    
1690     # type: Content of: <chapter><section><section><para>
1691 debacle 5419 #: en/upgrading.dbk:1020
1692 debacle 5329 msgid ""
1693     "During the upgrade, you will be asked questions regarding the configuration "
1694     "or re-configuration of several packages. When you are asked if any file in "
1695     "the <filename>/etc/init.d</filename> or <filename>/etc/terminfo</filename> "
1696     "directories, or the <filename>/etc/manpath.config</filename> file should be "
1697     "replaced by the package maintainer's version, it's usually necessary to "
1698     "answer `yes' to ensure system consistency. You can always revert to the old "
1699     "versions, since they will be saved with a <literal>.dpkg-old</literal> "
1700     "extension."
1701     msgstr ""
1702    
1703     # type: Content of: <chapter><section><section><para>
1704 debacle 5419 #: en/upgrading.dbk:1029
1705 debacle 5329 msgid ""
1706     "If you're not sure what to do, write down the name of the package or file "
1707     "and sort things out at a later time. You can search in the typescript file "
1708     "to review the information that was on the screen during the upgrade."
1709     msgstr ""
1710    
1711     # type: Content of: <chapter><section><title>
1712 debacle 5419 #: en/upgrading.dbk:1038
1713 debacle 5329 msgid "Upgrading your kernel and related packages"
1714     msgstr ""
1715    
1716     # type: Content of: <chapter><section><para>
1717 debacle 5419 #: en/upgrading.dbk:1040
1718 debacle 5329 msgid ""
1719     "This section explains how to upgrade your kernel and identifies potential "
1720     "issues related to this upgrade. You can either install one of the "
1721     "<systemitem role=\"package\">linux-image-*</systemitem> packages provided by "
1722     "Debian, or compile a customized kernel from source."
1723     msgstr ""
1724    
1725     # type: Content of: <chapter><section><para>
1726 debacle 5419 #: en/upgrading.dbk:1046
1727 debacle 5329 msgid ""
1728     "Note that a lot of information in this section is based on the assumption "
1729     "that you will be using one of the modular Debian kernels, together with "
1730     "<systemitem role=\"package\">initramfs-tools</systemitem> and <systemitem "
1731     "role=\"package\">udev</systemitem>. If you choose to use a custom kernel "
1732     "that does not require an initrd or if you use a different initrd generator, "
1733     "some of the information may not be relevant for you."
1734     msgstr ""
1735    
1736     # type: Content of: <chapter><section><para>
1737 debacle 5419 #: en/upgrading.dbk:1054
1738 debacle 5329 msgid ""
1739     "Note also that if <systemitem role=\"package\">udev</systemitem> is "
1740     "<emphasis>not</emphasis> installed on your system, it is still possible to "
1741 debacle 5419 "use <systemitem role=\"package\">hotplug</systemitem> for hardware discovery."
1742 debacle 5329 msgstr ""
1743    
1744     # type: Content of: <chapter><section><para>
1745 debacle 5419 #: en/upgrading.dbk:1059
1746 debacle 5329 msgid ""
1747 debacle 5419 "If you are currently using a 2.4 kernel, you should also read <xref linkend="
1748     "\"upgrade-to-2.6\"/> carefully."
1749 debacle 5329 msgstr ""
1750    
1751     # type: Content of: <chapter><section><section><title>
1752 debacle 5419 #: en/upgrading.dbk:1063
1753 debacle 5329 msgid "Installing the kernel metapackage"
1754     msgstr ""
1755    
1756     # type: Content of: <chapter><section><section><para>
1757 debacle 5419 #: en/upgrading.dbk:1065
1758 debacle 5329 msgid ""
1759     "When you dist-upgrade from &oldreleasename; to &releasename;, it is strongly "
1760     "recommended that you install a new linux-image-2.6-* metapackage. This "
1761     "package may be installed automatically by the dist-upgrade process. You can "
1762     "verify this by running:"
1763     msgstr ""
1764    
1765     # type: Content of: <chapter><section><section><screen>
1766 debacle 5419 #: en/upgrading.dbk:1069
1767 debacle 5329 #, no-wrap
1768     msgid ""
1769     "\n"
1770     "# dpkg -l linux-image* | grep ^ii\n"
1771     msgstr ""
1772    
1773     # type: Content of: <chapter><section><section><para>
1774 debacle 5419 #: en/upgrading.dbk:1073
1775 debacle 5329 msgid ""
1776 debacle 5419 "If you do not see any output, then you will need to install a new linux-"
1777     "image package by hand. To see a list of available linux-image-2.6 "
1778 debacle 5329 "metapackages, run:"
1779     msgstr ""
1780    
1781     # type: Content of: <chapter><section><section><screen>
1782 debacle 5419 #: en/upgrading.dbk:1076
1783 debacle 5329 #, no-wrap
1784     msgid ""
1785     "\n"
1786     "# apt-cache search linux-image-2.6- | grep -v transition\n"
1787     msgstr ""
1788    
1789     # type: Content of: <chapter><section><section><para>
1790 debacle 5419 #: en/upgrading.dbk:1080
1791 debacle 5329 msgid ""
1792 debacle 5419 "If you are unsure about which package to select, run <literal>uname -r</"
1793     "literal> and look for a package with a similar name. For example, if you "
1794     "see '2.4.27-3-686', it is recommended that you install <systemitem role="
1795     "\"package\">linux-image-2.6-686</systemitem>. (Note that the 386 flavor no "
1796     "longer exists; if you are currently using the 386 kernel flavor, you should "
1797     "install the 486 flavor instead.) You may also use <command>apt-cache</"
1798     "command> to see a long description of each package in order to help choose "
1799     "the best one available. For example:"
1800 debacle 5329 msgstr ""
1801    
1802     # type: Content of: <chapter><section><section><screen>
1803 debacle 5419 #: en/upgrading.dbk:1089
1804 debacle 5329 #, no-wrap
1805     msgid ""
1806     "\n"
1807     "# apt-cache show linux-image-2.6-686\n"
1808     msgstr ""
1809    
1810     # type: Content of: <chapter><section><section><para>
1811 debacle 5419 #: en/upgrading.dbk:1093
1812 debacle 5329 msgid ""
1813     "You should then use <literal>aptitude install</literal> to install it. Once "
1814     "this new kernel is installed you should reboot at the next available "
1815     "opportunity to get the benefits provided by the new kernel version."
1816     msgstr ""
1817    
1818     # type: Content of: <chapter><section><section><para>
1819 debacle 5419 #: en/upgrading.dbk:1098
1820 debacle 5329 msgid ""
1821     "For the more adventurous there is an easy way to compile your own custom "
1822 debacle 5419 "kernel on &debian;. Install the <systemitem role=\"package\">kernel-"
1823     "package</systemitem> tool and read the documentation in <filename>/usr/share/"
1824     "doc/kernel-package</filename>."
1825 debacle 5329 msgstr ""
1826    
1827     # type: Content of: <chapter><section><section><title>
1828 debacle 5419 #: en/upgrading.dbk:1106
1829 debacle 5329 msgid "Upgrading from a 2.6 kernel"
1830     msgstr ""
1831    
1832     # type: Content of: <chapter><section><section><para>
1833 debacle 5419 #: en/upgrading.dbk:1108
1834 debacle 5329 msgid ""
1835     "If you are currently running a 2.6 series kernel from &oldreleasename; this "
1836     "upgrade will take place automatically after you do a full upgrade of the "
1837     "system packages (as described in <xref linkend=\"upgradingpackages\"/> )."
1838     msgstr ""
1839    
1840     # type: Content of: <chapter><section><section><para>
1841 debacle 5419 #: en/upgrading.dbk:1113
1842 debacle 5329 msgid ""
1843     "If possible, it is to your advantage to upgrade the kernel package "
1844     "separately from the main <literal>dist-upgrade</literal> to reduce the "
1845 debacle 5419 "chances of a temporarily non-bootable system. See <xref linkend=\"upgrading-"
1846     "kernel\"/> for a description of this process. Note that this should only be "
1847     "done after the minimal upgrade process described in <xref linkend=\"minimal-"
1848     "upgrade\"/> ."
1849 debacle 5329 msgstr ""
1850    
1851     # type: Content of: <chapter><section><section><para>
1852 debacle 5419 #: en/upgrading.dbk:1120
1853 debacle 5329 msgid ""
1854     "You can also take this step if you are using your own custom kernel and want "
1855     "to use the kernel available in &releasename;. If your kernel version is not "
1856     "supported by <systemitem role=\"package\">udev</systemitem> then it is "
1857     "recommended that you upgrade after the minimal upgrade. If your version is "
1858     "supported by <systemitem role=\"package\">udev</systemitem> you can safely "
1859     "wait until after the full system upgrade."
1860     msgstr ""
1861    
1862     # type: Content of: <chapter><section><section><title>
1863 debacle 5419 #: en/upgrading.dbk:1130
1864 debacle 5329 msgid "Upgrading from a 2.4 kernel"
1865     msgstr ""
1866    
1867     # type: Content of: <chapter><section><section><para>
1868 debacle 5419 #: en/upgrading.dbk:1132
1869 debacle 5329 msgid ""
1870     "If you have a 2.4 kernel installed, and your system relies on <systemitem "
1871     "role=\"package\">hotplug</systemitem> for its hardware detection you should "
1872     "first upgrade to a 2.6 series kernel from &oldreleasename; before attempting "
1873     "the upgrade. Make sure that the 2.6 series kernel boots your system and all "
1874     "your hardware is properly detected before you perform the upgrade. The "
1875     "<systemitem role=\"package\">hotplug</systemitem> package is removed from "
1876     "the system (in favor of <systemitem role=\"package\">udev</systemitem>) when "
1877     "you do a full system upgrade. If you do not do the kernel upgrade before "
1878     "this your system might not boot up properly from this point on. Once you "
1879     "have done an upgrade to a 2.6 series kernel in &oldreleasename; you can do a "
1880     "kernel upgrade as described in <xref linkend=\"upgrade-from-2.6\"/> ."
1881     msgstr ""
1882    
1883     # type: Content of: <chapter><section><section><para><footnote>
1884 debacle 5419 #: en/upgrading.dbk:1145
1885 debacle 5329 msgid ""
1886 debacle 5419 "If your system does not rely on <systemitem role=\"package\">hotplug</"
1887     "systemitem><footnote>"
1888 debacle 5329 msgstr ""
1889    
1890     # type: Content of: <chapter><section><section><para><footnote><para>
1891 debacle 5419 #: en/upgrading.dbk:1146
1892 debacle 5329 msgid ""
1893     "You can have the kernel modules needed by your system loaded statically "
1894     "through proper configuration of <filename>/etc/modules</filename>"
1895     msgstr ""
1896    
1897     # type: Content of: <chapter><section><section><para>
1898 debacle 5419 #: en/upgrading.dbk:1148
1899 debacle 5329 msgid ""
1900     "</footnote> you can delay the kernel upgrade to after you have done a full "
1901     "system upgrade, as described in <xref linkend=\"upgrading-other\"/> . Once "
1902     "your system has been upgraded you can then do the following (changing the "
1903     "kernel package name to the one most suited to your system by substituting "
1904     "<emphasis>&lt;flavor&gt;</emphasis>):"
1905     msgstr ""
1906    
1907     # type: Content of: <chapter><section><section><screen>
1908 debacle 5419 #: en/upgrading.dbk:1154
1909 debacle 5329 #, no-wrap
1910     msgid ""
1911     "\n"
1912     "# aptitude install linux-image-2.6-&lt;flavor&gt;\n"
1913     msgstr ""
1914    
1915     # type: Content of: <chapter><section><section><title>
1916 debacle 5419 #: en/upgrading.dbk:1160
1917 debacle 5329 msgid "Device enumeration reordering"
1918     msgstr ""
1919    
1920     # type: Content of: <chapter><section><section><para>
1921 debacle 5419 #: en/upgrading.dbk:1162
1922 debacle 5329 msgid ""
1923     "&releasename; features a more robust mechanism for hardware discovery than "
1924     "previous releases. However, this may cause changes in the order devices are "
1925     "discovered on your system, affecting the order in which device names are "
1926     "assigned. For example, if you have two network adapters that are associated "
1927     "with two different drivers, the devices eth0 and eth1 refer to may be "
1928     "swapped. Please note that the new mechanism means that if you e.g. "
1929     "exchange ethernet adapters in a running &releasename; system, the new "
1930     "adapter will also get a new interface name."
1931     msgstr ""
1932    
1933     # type: Content of: <chapter><section><section><para><footnote>
1934 debacle 5419 #: en/upgrading.dbk:1171
1935 debacle 5329 msgid ""
1936 debacle 5419 "For network devices, you can avoid this reordering by using <systemitem role="
1937     "\"package\">udev</systemitem> rules, more specifically, through the "
1938     "definitions at <filename>/etc/udev/rules.d/z25_persistent-net.rules</"
1939     "filename><footnote>"
1940 debacle 5329 msgstr ""
1941    
1942     # type: Content of: <chapter><section><section><para><footnote><para>
1943 debacle 5419 #: en/upgrading.dbk:1175
1944 debacle 5329 msgid ""
1945 debacle 5419 "The rules there are automatically generated by the script <filename>/etc/"
1946     "udev/rules.d/z45_persistent-net-generator.rules</filename> to have "
1947     "persistent names for network interfaces. Delete this symlink to disable "
1948     "persistent device naming for NICs by <systemitem role=\"package\">udev</"
1949     "systemitem>."
1950 debacle 5329 msgstr ""
1951    
1952     # type: Content of: <chapter><section><section><para>
1953 debacle 5419 #: en/upgrading.dbk:1179
1954 debacle 5329 msgid ""
1955     "</footnote>. Alternatively you can use the <command>ifrename</command> "
1956     "utility to bind physical devices to specific names at boot time. See "
1957 debacle 5419 "<citerefentry> <refentrytitle>ifrename</refentrytitle> <manvolnum>8</"
1958     "manvolnum> </citerefentry> and <citerefentry> <refentrytitle>iftab</"
1959     "refentrytitle> <manvolnum>5</manvolnum> </citerefentry> for more "
1960     "information. The two alternatives (<systemitem role=\"package\">udev</"
1961     "systemitem> and <command>ifrename</command>) should not be used at the same "
1962     "time."
1963 debacle 5329 msgstr ""
1964    
1965     # type: Content of: <chapter><section><section><para>
1966 debacle 5419 #: en/upgrading.dbk:1189
1967 debacle 5329 msgid ""
1968 debacle 5419 "For storage devices, you can avoid this reordering by using <systemitem role="
1969     "\"package\">initramfs-tools</systemitem> and configuring it to load storage "
1970     "device driver modules in the same order they are currently loaded. To do "
1971     "this, identify the order the storage modules on your system were loaded by "
1972     "looking at the output of <command>lsmod</command>. <command>lsmod</command> "
1973     "lists modules in the reverse order that they were loaded in, i.e., the first "
1974     "module in the list was the last one loaded. Note that this will only work "
1975     "for devices which the kernel enumerates in a stable order (like PCI devices)."
1976 debacle 5329 msgstr ""
1977    
1978     # type: Content of: <chapter><section><section><para>
1979 debacle 5419 #: en/upgrading.dbk:1199
1980 debacle 5329 msgid ""
1981     "However, removing and reloading modules after initial boot will affect this "
1982     "order. Also, your kernel may have some drivers linked statically, and these "
1983     "names will not appear in the output of <command>lsmod</command>. You may be "
1984     "able to decipher these driver names and load order from looking at "
1985 debacle 5419 "<filename>/var/log/kern.log</filename>, or the output of <command>dmesg</"
1986     "command>."
1987 debacle 5329 msgstr ""
1988    
1989     # type: Content of: <chapter><section><section><para>
1990 debacle 5419 #: en/upgrading.dbk:1207
1991 debacle 5329 msgid ""
1992     "Add these module names to <filename>/etc/initramfs-tools/modules</filename> "
1993     "in the order they should be loaded at boot time. Some module names may have "
1994     "changed between &oldreleasename; and &releasename;. For example, "
1995     "sym53c8xx_2 has become sym53c8xx."
1996     msgstr ""
1997    
1998     # type: Content of: <chapter><section><section><para>
1999 debacle 5419 #: en/upgrading.dbk:1212
2000 debacle 5329 msgid ""
2001     "You will then need to regenerate your initramfs image(s) by executing "
2002     "<literal>update-initramfs -u -k all</literal>."
2003     msgstr ""
2004    
2005     # type: Content of: <chapter><section><section><para>
2006 debacle 5419 #: en/upgrading.dbk:1216
2007 debacle 5329 msgid ""
2008 debacle 5419 "Once you are running a &releasename; kernel and <systemitem role=\"package"
2009     "\">udev</systemitem>, you may reconfigure your system to access disks by an "
2010     "alias that is not dependent upon driver load order. These aliases reside in "
2011     "the <filename>/dev/disk/</filename> hierarchy."
2012 debacle 5329 msgstr ""
2013    
2014     # type: Content of: <chapter><section><section><title>
2015 debacle 5419 #: en/upgrading.dbk:1224
2016 debacle 5329 msgid "Boot timing issues"
2017     msgstr ""
2018    
2019     # type: Content of: <chapter><section><section><para>
2020 debacle 5419 #: en/upgrading.dbk:1226
2021 debacle 5329 msgid ""
2022 debacle 5419 "If an initrd created with <systemitem role=\"package\">initramfs-tools</"
2023     "systemitem> is used to boot the system, in some cases the creation of device "
2024     "files by <systemitem role=\"package\">udev</systemitem> can happen too late "
2025     "for the boot scripts to act on."
2026 debacle 5329 msgstr ""
2027    
2028     # type: Content of: <chapter><section><section><para>
2029 debacle 5419 #: en/upgrading.dbk:1233
2030 debacle 5329 msgid ""
2031     "The usual symptoms are that the boot will fail because the root file system "
2032     "cannot be mounted and you are dropped into a debug shell, but that when you "
2033 debacle 5419 "check afterwards, all devices that are needed are present in <filename>/dev</"
2034     "filename>. This has been observed in cases where the root file system is on "
2035     "a"
2036 debacle 5329 msgstr ""
2037    
2038 debacle 5419 # type: Content of: <chapter><section><section><para><acronym>
2039     #: en/upgrading.dbk:1237
2040     msgid "USB"
2041     msgstr ""
2042    
2043 debacle 5329 # type: Content of: <chapter><section><section><para>
2044 debacle 5419 #: en/upgrading.dbk:1237
2045     msgid "disk or on"
2046     msgstr ""
2047    
2048     # type: Content of: <chapter><section><section><para><acronym>
2049     #: en/upgrading.dbk:1237 en/upgrading.dbk:1318
2050     msgid "RAID"
2051     msgstr ""
2052    
2053     # type: Content of: <chapter><section><section><para>
2054     #: en/upgrading.dbk:1237
2055     msgid ", especially if lilo is used."
2056     msgstr ""
2057    
2058     # type: Content of: <chapter><section><section><para>
2059     #: en/upgrading.dbk:1240
2060 debacle 5329 msgid ""
2061     "A workaround for this issue is to use the boot parameter "
2062     "<literal>rootdelay=<replaceable>9</replaceable></literal>. The value for "
2063     "the timeout (in seconds) may need to be adjusted."
2064     msgstr ""
2065    
2066     # type: Content of: <chapter><section><title>
2067 debacle 5419 #: en/upgrading.dbk:1249
2068 debacle 5329 msgid "Things to do before rebooting"
2069     msgstr ""
2070    
2071     # type: Content of: <chapter><section><para>
2072 debacle 5419 #: en/upgrading.dbk:1251
2073 debacle 5329 msgid ""
2074     "When <literal>aptitude dist-upgrade</literal> has finished, the formal "
2075     "upgrade is complete, but there are some other things that should be taken "
2076     "care of <emphasis>before</emphasis> the next reboot."
2077     msgstr ""
2078    
2079     # type: Content of: <chapter><section><section><title>
2080 debacle 5419 #: en/upgrading.dbk:1256
2081 debacle 5329 msgid "Converting from devfs"
2082     msgstr ""
2083    
2084     # type: Content of: <chapter><section><section><para>
2085 debacle 5419 #: en/upgrading.dbk:1258
2086 debacle 5329 msgid ""
2087     "Debian kernels no longer include support for <literal>devfs</literal>, so "
2088     "<literal>devfs</literal> users will need to convert their systems manually "
2089     "before booting an &releasename; kernel."
2090     msgstr ""
2091    
2092     # type: Content of: <chapter><section><section><para>
2093 debacle 5419 #: en/upgrading.dbk:1263
2094 debacle 5329 msgid ""
2095     "If you see the string 'devfs' in <filename>/proc/mounts</filename>, you are "
2096     "most likely using <literal>devfs</literal>. Any configuration files that "
2097     "reference <literal>devfs</literal>-style names will need to be adjusted to "
2098     "use <systemitem role=\"package\">udev</systemitem>-style names. Files that "
2099     "are likely to refer to <literal>devfs</literal>-style device names include "
2100     "<filename>/etc/fstab</filename>, <filename>/etc/lilo.conf</filename>, "
2101 debacle 5419 "<filename>/boot/grub/menu.lst</filename>, and <filename>/etc/inittab</"
2102     "filename>."
2103 debacle 5329 msgstr ""
2104    
2105     # type: Content of: <chapter><section><section><para>
2106 debacle 5419 #: en/upgrading.dbk:1273
2107 debacle 5329 msgid ""
2108     "More information about potential issues is available in bug report <ulink "
2109 debacle 5419 "url=\"&url-bts;341152\">#341152</ulink>."
2110 debacle 5329 msgstr ""
2111    
2112     # type: Content of: <chapter><section><section><title>
2113 debacle 5419 #: en/upgrading.dbk:1279
2114 debacle 5329 msgid "Rerun lilo"
2115     msgstr ""
2116    
2117     # type: Content of: <chapter><section><section><para>
2118 debacle 5419 #: en/upgrading.dbk:1281
2119 debacle 5329 msgid ""
2120     "If you are using <systemitem role=\"package\">lilo</systemitem> as your "
2121     "bootloader (it is the default bootloader for some installations of "
2122 debacle 5419 "&oldreleasename;) it is strongly recommended that you rerun <command>lilo</"
2123     "command> after the upgrade:"
2124 debacle 5329 msgstr ""
2125    
2126     # type: Content of: <chapter><section><section><screen>
2127 debacle 5419 #: en/upgrading.dbk:1285
2128 debacle 5329 #, no-wrap
2129     msgid ""
2130     "\n"
2131     "# /sbin/lilo\n"
2132     msgstr ""
2133    
2134     # type: Content of: <chapter><section><section><para>
2135 debacle 5419 #: en/upgrading.dbk:1289
2136 debacle 5329 msgid ""
2137     "Notice this is needed even if you did not upgrade your system's kernel, as "
2138     "<command>lilo</command>'s second stage will change due to the package "
2139     "upgrade."
2140     msgstr ""
2141    
2142     # type: Content of: <chapter><section><section><para>
2143 debacle 5419 #: en/upgrading.dbk:1293
2144 debacle 5329 msgid ""
2145     "Also, review the contents of your <filename>/etc/kernel-img.conf</filename> "
2146     "and make sure that you have <emphasis>do_bootloader = Yes</emphasis> in it. "
2147     "That way the bootloader will always be rerun after a kernel upgrade."
2148     msgstr ""
2149    
2150     # type: Content of: <chapter><section><section><para>
2151 debacle 5419 #: en/upgrading.dbk:1298
2152 debacle 5329 msgid ""
2153     "If you encounter any issues when running <command>lilo</command>, review the "
2154     "symbolic links in <filename>/</filename> to <filename>vmlinuz</filename> and "
2155 debacle 5419 "<filename>initrd</filename> and the contents of your <filename>/etc/lilo."
2156     "conf</filename> for discrepancies."
2157 debacle 5329 msgstr ""
2158    
2159     # type: Content of: <chapter><section><section><para><footnote>
2160 debacle 5419 #: en/upgrading.dbk:1304
2161 debacle 5329 msgid ""
2162     "If you forgot to rerun <command>lilo</command> before the reboot or the "
2163     "system is accidentally rebooted before you could do this manually, your "
2164     "system might fail to boot. Instead of the lilo prompt, you will only see "
2165     "<emphasis>LI</emphasis> when booting the system<footnote>"
2166     msgstr ""
2167    
2168     # type: Content of: <chapter><section><section><para><footnote><para>
2169 debacle 5419 #: en/upgrading.dbk:1307
2170 debacle 5329 msgid ""
2171     "For more information on <command>lilo</command>'s boot error codes please "
2172     "see <ulink url=\"http://tldp.org/HOWTO/Bootdisk-HOWTO/a1483.html\">The Linux "
2173     "Bootdisk HOWTO</ulink>."
2174     msgstr ""
2175    
2176     # type: Content of: <chapter><section><section><para>
2177 debacle 5419 #: en/upgrading.dbk:1310
2178 debacle 5329 msgid ""
2179     "</footnote>. See <xref linkend=\"recovery\"/> for information on how to "
2180     "recover from this."
2181     msgstr ""
2182    
2183     # type: Content of: <chapter><section><section><title>
2184 debacle 5419 #: en/upgrading.dbk:1316
2185 debacle 5329 msgid "Upgrading mdadm"
2186     msgstr ""
2187    
2188     # type: Content of: <chapter><section><section><para>
2189 debacle 5419 #: en/upgrading.dbk:1318
2190     msgid "mdadm now needs a configuration file to assemble MD arrays ("
2191     msgstr ""
2192    
2193     # type: Content of: <chapter><section><section><para>
2194     #: en/upgrading.dbk:1318
2195 debacle 5329 msgid ""
2196 debacle 5419 ") from the initial ramdisk and during the system initialisation sequence. "
2197     "Please make sure to read and act upon the instructions in <filename>/usr/"
2198     "share/doc/mdadm/README.upgrading-2.5.3.gz</filename> after the package has "
2199     "been upgraded <emphasis role=\"strong\">and before you reboot</emphasis>. "
2200     "The latest version of this file is available at <ulink url=\"http://svn."
2201     "debian.org/wsvn/pkg-mdadm/mdadm/trunk/debian/README.upgrading-2.5.3?op=file"
2202     "\"></ulink>; please consult it in case of problems."
2203 debacle 5329 msgstr ""
2204    
2205     # type: Content of: <chapter><section><title>
2206 debacle 5419 #: en/upgrading.dbk:1332
2207 debacle 5427 msgid "System boot hangs on <literal>Waiting for root file system</literal>"
2208     msgstr ""
2209    
2210     # type: Content of: <chapter><section><subtitle>
2211     #: en/upgrading.dbk:1334
2212     msgid ""
2213     "Procedure to recover from <filename>/dev/hda</filename> became <filename>/"
2214     "dev/sda</filename>"
2215     msgstr ""
2216    
2217     # type: Content of: <chapter><section><para>
2218     #: en/upgrading.dbk:1338
2219     msgid ""
2220     "Some users have reported that an upgrade could cause the kernel not finding "
2221     "the system root partition after a system reboot."
2222     msgstr ""
2223    
2224     # type: Content of: <chapter><section><para>
2225     #: en/upgrading.dbk:1343
2226     msgid "In such case, the system boot will hang on the following message:"
2227     msgstr ""
2228    
2229     # type: Content of: <chapter><section><para><screen>
2230     #: en/upgrading.dbk:1344
2231     #, no-wrap
2232     msgid "Waiting for root file system ..."
2233     msgstr ""
2234    
2235     # type: Content of: <chapter><section><para>
2236     #: en/upgrading.dbk:1345
2237     msgid "and after a few seconds a bare busybox prompt will show."
2238     msgstr ""
2239    
2240     # type: Content of: <chapter><section><para>
2241     #: en/upgrading.dbk:1349
2242     msgid ""
2243     "This problem can occur when the upgrade of the kernel introduces the use of "
2244     "the new generation of"
2245     msgstr ""
2246    
2247     # type: Content of: <chapter><section><para><acronym>
2248     #: en/upgrading.dbk:1350 en/upgrading.dbk:1351
2249     msgid "IDE"
2250     msgstr ""
2251    
2252     # type: Content of: <chapter><section><para>
2253     #: en/upgrading.dbk:1351
2254     msgid "drivers. The"
2255     msgstr ""
2256    
2257     # type: Content of: <chapter><section><para>
2258     #: en/upgrading.dbk:1351
2259     msgid ""
2260     "disk naming convention for the old drivers was <literal>hda</literal>, "
2261     "<literal>hdb</literal>, <literal>hdc</literal>, <literal>hdd</literal>. The "
2262     "new drivers will name the same disks respectively <literal>sda</literal>, "
2263     "<literal>sdb</literal>, <literal>sdc</literal>, <literal>sdd</literal>. The "
2264     "problem appears when the upgrade does not generate a new <filename>/boot/"
2265     "grub/menu.lst</filename> file to take the new naming convention into "
2266     "account. During the boot, Grub will pass a system root partition to the "
2267     "kernel that the kernel doesn't find."
2268     msgstr ""
2269    
2270     # type: Content of: <chapter><section><para>
2271     #: en/upgrading.dbk:1364
2272     msgid ""
2273     "If you have encountered this problem after upgrading, jump to <xref linkend="
2274     "\"how-to-recover\"/>. To avoid the problem before upgrading, read ahead."
2275     msgstr ""
2276    
2277     # type: Content of: <chapter><section><section><title>
2278     #: en/upgrading.dbk:1370
2279     msgid "How to avoid the problem before upgrading"
2280     msgstr ""
2281    
2282     # type: Content of: <chapter><section><section><para>
2283     #: en/upgrading.dbk:1373
2284     msgid ""
2285     "One can avoid this problem entirely by using an identifier for the root "
2286     "filesystem that does not change from one boot to the next. There are two "
2287     "possible methods for doing this - labelling the filesystem, or using the "
2288     "filesystem's universal unique identifier ("
2289     msgstr ""
2290    
2291     # type: Content of: <chapter><section><section><para><orderedlist><listitem><para><note><para><acronym>
2292     #: en/upgrading.dbk:1377 en/upgrading.dbk:1456 en/upgrading.dbk:1461
2293     msgid "UUID"
2294     msgstr ""
2295    
2296     # type: Content of: <chapter><section><section><para>
2297     #: en/upgrading.dbk:1377
2298     msgid "). These methods are supported in Debian since the 'etch' release."
2299     msgstr ""
2300    
2301     # type: Content of: <chapter><section><section><para>
2302     #: en/upgrading.dbk:1382
2303     msgid ""
2304     "The two approaches have advantages and disadvantages. The labelling approach "
2305     "is more readable, but there may be problems if another filesystem on your "
2306     "machine has the same label. The uuid approach is uglier, but having two "
2307     "clashing uuids is highly unlikely."
2308     msgstr ""
2309    
2310     # type: Content of: <chapter><section><section><para>
2311     #: en/upgrading.dbk:1390
2312     msgid ""
2313     "For the examples below we assume the root filesystem is on <filename>/dev/"
2314     "hda6</filename>. We also assume your system has a working udev installation "
2315     "and ext2 or ext3 filesystems."
2316     msgstr ""
2317    
2318     # type: Content of: <chapter><section><section><para>
2319     #: en/upgrading.dbk:1396
2320     msgid "To implement the labelling approach:"
2321     msgstr ""
2322    
2323     # type: Content of: <chapter><section><section><para><orderedlist><listitem><para>
2324     #: en/upgrading.dbk:1400
2325     msgid ""
2326     "Label the filesystem (the name must be &lt; 16 characters) by running the "
2327     "command:"
2328     msgstr ""
2329    
2330     # type: Content of: <chapter><section><section><para><orderedlist><listitem><para><programlisting>
2331     #: en/upgrading.dbk:1402
2332     #, no-wrap
2333     msgid "e2label /dev/hda6 rootfilesys"
2334     msgstr ""
2335    
2336     # type: Content of: <chapter><section><section><para><orderedlist><listitem><para>
2337     #: en/upgrading.dbk:1407
2338     msgid "Edit <filename>/boot/grub/menu.lst</filename> and change the line:"
2339     msgstr ""
2340    
2341     # type: Content of: <chapter><section><section><para><orderedlist><listitem><para><programlisting>
2342     #: en/upgrading.dbk:1408 en/upgrading.dbk:1472
2343     #, no-wrap
2344     msgid "# kopt=root=/dev/hda6 ro"
2345     msgstr ""
2346    
2347     # type: Content of: <chapter><section><section><para><orderedlist><listitem><para>
2348     #: en/upgrading.dbk:1409 en/upgrading.dbk:1433 en/upgrading.dbk:1474
2349     #: en/upgrading.dbk:1499
2350     msgid "to"
2351     msgstr ""
2352    
2353     # type: Content of: <chapter><section><section><para><orderedlist><listitem><para><programlisting>
2354     #: en/upgrading.dbk:1410
2355     #, no-wrap
2356     msgid "# kopt=root=LABEL=rootfilesys ro"
2357     msgstr ""
2358    
2359     # type: Content of: <chapter><section><section><para><orderedlist><listitem><para><note><para>
2360     #: en/upgrading.dbk:1413 en/upgrading.dbk:1480
2361     msgid ""
2362     "Do not remove the <literal>#</literal> at the start of the line, it needs to "
2363     "be there."
2364     msgstr ""
2365    
2366     # type: Content of: <chapter><section><section><para><orderedlist><listitem><para>
2367     #: en/upgrading.dbk:1421 en/upgrading.dbk:1488
2368     msgid ""
2369     "Update the <literal>kernel</literal> lines in <filename>menu.lst</filename> "
2370     "by running the command <command>update-grub</command>."
2371     msgstr ""
2372    
2373     # type: Content of: <chapter><section><section><para><orderedlist><listitem><para>
2374     #: en/upgrading.dbk:1428 en/upgrading.dbk:1495
2375     msgid ""
2376     "Edit <filename>/etc/fstab</filename> and change the line that mounts the "
2377     "<filename>/</filename> partition, eg.:"
2378     msgstr ""
2379    
2380     # type: Content of: <chapter><section><section><para><orderedlist><listitem><para><programlisting>
2381     #: en/upgrading.dbk:1431 en/upgrading.dbk:1497
2382     #, no-wrap
2383     msgid "/dev/hda6 / ext3 defaults,errors=remount-ro 0 1"
2384     msgstr ""
2385    
2386     # type: Content of: <chapter><section><section><para><orderedlist><listitem><para><programlisting>
2387     #: en/upgrading.dbk:1435
2388     #, no-wrap
2389     msgid "LABEL=rootfilesys / ext3 defaults,errors=remount-ro 0 1"
2390     msgstr ""
2391    
2392     # type: Content of: <chapter><section><section><para><orderedlist><listitem><para>
2393     #: en/upgrading.dbk:1437 en/upgrading.dbk:1503
2394     msgid ""
2395     "The change that matters here is the first column, you don't need to modify "
2396     "the other columns of this line."
2397     msgstr ""
2398    
2399     # type: Content of: <chapter><section><section><para>
2400     #: en/upgrading.dbk:1445
2401     msgid "To implement the uuid approach:"
2402     msgstr ""
2403    
2404     # type: Content of: <chapter><section><section><para><orderedlist><listitem><para>
2405     #: en/upgrading.dbk:1449
2406     msgid ""
2407     "Find out the universal unique identifier of your filesystem by issuing: "
2408     "<command>ls -l /dev/disk/by-uuid | grep hda6</command>"
2409     msgstr ""
2410    
2411     # type: Content of: <chapter><section><section><para><orderedlist><listitem><para>
2412     #: en/upgrading.dbk:1453
2413     msgid "You should get a line similar to this one:"
2414     msgstr ""
2415    
2416     # type: Content of: <chapter><section><section><para><orderedlist><listitem><para><screen>
2417     #: en/upgrading.dbk:1454
2418     #, no-wrap
2419     msgid "lrwxrwxrwx 1 root root 24 2008-09-25 08:16 d0dfcc8a-417a-41e3-ad2e-9736317f2d8a -> ../../hda6"
2420     msgstr ""
2421    
2422     # type: Content of: <chapter><section><section><para><orderedlist><listitem><para>
2423     #: en/upgrading.dbk:1456
2424     msgid "The"
2425     msgstr ""
2426    
2427     # type: Content of: <chapter><section><section><para><orderedlist><listitem><para>
2428     #: en/upgrading.dbk:1456
2429     msgid ""
2430     "is the name of the symbolic link pointing to <filename>/dev/hda6</filename> "
2431     "ie.: <literal>d0dfcc8a-417a-41e3-ad2e-9736317f2d8a</literal>."
2432     msgstr ""
2433    
2434     # type: Content of: <chapter><section><section><para><orderedlist><listitem><para><note><para>
2435     #: en/upgrading.dbk:1461
2436     msgid "Your filesystem"
2437     msgstr ""
2438    
2439     # type: Content of: <chapter><section><section><para><orderedlist><listitem><para><note><para>
2440     #: en/upgrading.dbk:1462
2441     msgid "will be a different string."
2442     msgstr ""
2443    
2444     # type: Content of: <chapter><section><section><para><orderedlist><listitem><para>
2445     #: en/upgrading.dbk:1469
2446     msgid "Edit <filename>/boot/grub/menu.lst</filename> and change the line"
2447     msgstr ""
2448    
2449     # type: Content of: <chapter><section><section><para><orderedlist><listitem><para><programlisting>
2450     #: en/upgrading.dbk:1476
2451     #, no-wrap
2452     msgid "# kopt=root=UUID=d0dfcc8a-417a-41e3-ad2e-9736317f2d8 ro"
2453     msgstr ""
2454    
2455     # type: Content of: <chapter><section><section><para><orderedlist><listitem><para><programlisting>
2456     #: en/upgrading.dbk:1501
2457     #, no-wrap
2458     msgid "UUID=d0dfcc8a-417a-41e3-ad2e-9736317f2d8 / ext3 defaults,errors=remount-ro 0 1"
2459     msgstr ""
2460    
2461     # type: Content of: <chapter><section><section><title>
2462     #: en/upgrading.dbk:1512
2463     msgid "How to recover from the problem after the upgrade"
2464     msgstr ""
2465    
2466     # type: Content of: <chapter><section><section><section><title>
2467     #: en/upgrading.dbk:1515
2468     msgid "Solution 1"
2469     msgstr ""
2470    
2471     # type: Content of: <chapter><section><section><section><para>
2472     #: en/upgrading.dbk:1517
2473     msgid ""
2474     "This is applicable when Grub shows you the menu interface for selecting the "
2475     "entry you want to boot from. If such menu does not appear, try pressing "
2476     "<keycap>Esc</keycap> key before the kernel boots in order to make it "
2477     "appear. If you can't get into this menu, try <xref linkend=\"solution2\"/> "
2478     "or <xref linkend=\"solution3\"/>."
2479     msgstr ""
2480    
2481     # type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
2482     #: en/upgrading.dbk:1528
2483     msgid ""
2484     "In the Grub menu, highlight the entry you want to boot from. Press "
2485     "<keycap>e</keycap> key to edit the options related to this entry. You will "
2486     "see something like:"
2487     msgstr ""
2488    
2489     # type: Content of: <chapter><section><section><section><orderedlist><listitem><para><screen>
2490     #: en/upgrading.dbk:1532
2491     #, no-wrap
2492     msgid ""
2493     "root (hd0,0)\n"
2494     "kernel /vmlinuz-2.6.26-1-686 root=/dev/hda6 ro\n"
2495     "initrd /initrd.img-2.6.26-1-686"
2496     msgstr ""
2497    
2498     # type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
2499     #: en/upgrading.dbk:1539
2500     msgid "Highlight the line"
2501     msgstr ""
2502    
2503     # type: Content of: <chapter><section><section><section><orderedlist><listitem><para><screen>
2504     #: en/upgrading.dbk:1541
2505     #, no-wrap
2506     msgid "kernel /vmlinuz-2.6.26-1-686 root=/dev/hda6 ro"
2507     msgstr ""
2508    
2509     # type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
2510     #: en/upgrading.dbk:1543
2511     msgid ""
2512     "press <keycap>e</keycap> key and replace <literal>hdX</literal> with "
2513     "<literal>sd<replaceable>X</replaceable></literal> (<replaceable>X</"
2514     "replaceable> being the letter <literal>a</literal>, <literal>b</literal>, "
2515     "<literal>c</literal> or <literal>d</literal> depending of your system), In "
2516     "my example the line becomes:"
2517     msgstr ""
2518    
2519     # type: Content of: <chapter><section><section><section><orderedlist><listitem><para><screen>
2520     #: en/upgrading.dbk:1551
2521     #, no-wrap
2522     msgid "kernel /vmlinuz-2.6.26-1-686 root=/dev/sda6 ro"
2523     msgstr ""
2524    
2525     # type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
2526     #: en/upgrading.dbk:1553
2527     msgid ""
2528     "Then press <keycap>Enter</keycap> to save the modification. If other lines "
2529     "show <literal>hd<replaceable>X</replaceable></literal>, change these line "
2530     "too. Don't modify the entry similar to <literal>root (hd0,0)</literal>. "
2531     "Once all modifications are done, press <keycap>b</keycap> key. And your "
2532     "system should now boot as usual."
2533     msgstr ""
2534    
2535     # type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
2536     #: en/upgrading.dbk:1564
2537     msgid ""
2538     "Now that your system has booted, you need to fix this issue permanently. "
2539     "Jump to <xref linkend=\"avoid-problems-before-upgrading\"/> and apply one of "
2540     "the two proposed procedures."
2541     msgstr ""
2542    
2543     # type: Content of: <chapter><section><section><section><title>
2544     #: en/upgrading.dbk:1574
2545     msgid "Solution 2"
2546     msgstr ""
2547    
2548     # type: Content of: <chapter><section><section><section><para>
2549     #: en/upgrading.dbk:1577
2550     msgid "Boot from a debian installation media ("
2551     msgstr ""
2552    
2553     # type: Content of: <chapter><section><section><section><para><acronym>
2554     #: en/upgrading.dbk:1578
2555     msgid "CD"
2556     msgstr ""
2557    
2558     # type: Content of: <chapter><section><section><section><para>
2559     #: en/upgrading.dbk:1578
2560     msgid "/"
2561     msgstr ""
2562    
2563     # type: Content of: <chapter><section><section><section><para><acronym>
2564     #: en/upgrading.dbk:1578
2565     msgid "DVD"
2566     msgstr ""
2567    
2568     # type: Content of: <chapter><section><section><section><para>
2569     #: en/upgrading.dbk:1578
2570     msgid ""
2571     ") and when prompt, type <literal>rescue</literal> to launch the rescue mode. "
2572     "Select your language, location, keyboard mapping, let it configure the "
2573     "network no matter if it success or not. After a while, you should be asked "
2574     "for selecting a partition you want to use as root file system. The proposed "
2575     "choices will look something like:"
2576     msgstr ""
2577    
2578     # type: Content of: <chapter><section><section><section><para><screen>
2579     #: en/upgrading.dbk:1586
2580     #, no-wrap
2581     msgid ""
2582     "/dev/ide/host0/bus0/target0/lun0/part1\n"
2583     "/dev/ide/host0/bus0/target0/lun0/part2\n"
2584     "/dev/ide/host0/bus0/target0/lun0/part5\n"
2585     "/dev/ide/host0/bus0/target0/lun0/part6"
2586     msgstr ""
2587    
2588     # type: Content of: <chapter><section><section><section><para>
2589     #: en/upgrading.dbk:1593
2590     msgid ""
2591     "If you know which partition is your root file system, choose the right one. "
2592     "If you don't, just try with the first. If it complains about an invalid root "
2593     "file system partition, try the next one, and so on. Trying one after the "
2594     "other shouldn't arm your partitions and if you have only one system "
2595     "installed on your disks, you should easily find the right root file system "
2596     "partition. If you have many systems installed on your disks, it would be "
2597     "better to know exactly which is the right partition."
2598     msgstr ""
2599    
2600     # type: Content of: <chapter><section><section><section><para>
2601     #: en/upgrading.dbk:1605
2602     msgid ""
2603     "Once you have choosen a partition, you will be proposed among several "
2604     "actions. Make the choice of executing a shell in the selected partition. If "
2605     "it complains that it cannot do that then try with another partition."
2606     msgstr ""
2607    
2608     # type: Content of: <chapter><section><section><section><para>
2609     #: en/upgrading.dbk:1612
2610     msgid ""
2611     "Now you should have shell access as user root on your root file system "
2612     "mounted on <filename>/</filename>. You need access to the <filename>/boot</"
2613     "filename>, <filename>/sbin</filename> and <filename>/usr</filename> "
2614     "directories content. If these directories need to be mounted from other "
2615     "partitions, do it. (see <filename>/etc/fstab</filename> if you have no idea "
2616     "of which partition to mount)."
2617     msgstr ""
2618    
2619     # type: Content of: <chapter><section><section><section><para>
2620     #: en/upgrading.dbk:1622
2621     msgid ""
2622     "Jump to <xref linkend=\"avoid-problems-before-upgrading\"/> and apply one of "
2623     "the two proposed procedures to fix the problem parmanently. Then type "
2624     "<literal>exit</literal> to leave the rescue shell and select "
2625     "<literal>reboot</literal> for rebooting the system as usual. (Don't forget "
2626     "to remove the bootable media)"
2627     msgstr ""
2628    
2629     # type: Content of: <chapter><section><section><section><title>
2630     #: en/upgrading.dbk:1632
2631     msgid "Solution 3"
2632     msgstr ""
2633    
2634     # type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
2635     #: en/upgrading.dbk:1637
2636     msgid ""
2637     "Boot from your favorite LiveCD distribution (Debian Live, Knoppix, Ubuntu "
2638     "Live and many other)."
2639     msgstr ""
2640    
2641     # type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
2642     #: en/upgrading.dbk:1643
2643     msgid ""
2644     "Mount the partition where your <filename>/boot</filename> directory is. If "
2645     "you don't know which one it is, use the output of the command "
2646     "<command>dmesg</command> to find whether your disk is known as <literal>hda</"
2647     "literal>, <literal>hdb</literal>, <literal>hdc</literal>, <literal>hdd</"
2648     "literal> or <literal>sda</literal>, <literal>sdb</literal>, <literal>sdc</"
2649     "literal>, <literal>sdd</literal>. Once you know which disk to work on, for "
2650     "example <literal>sdb</literal>, issue the following command to see the "
2651     "partition table of the disk and to find the right partition <command>fdisk -"
2652     "l /dev/sdb</command>"
2653     msgstr ""
2654    
2655     # type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
2656     #: en/upgrading.dbk:1659
2657     msgid ""
2658     "Assuming that you have mounted the right partition under <filename>/mnt</"
2659     "filename> and that this partition contains the <filename>/boot</filename> "
2660     "directory and its content, edit the <filename>/mnt/boot/grub/menu.lst</"
2661     "filename> file."
2662     msgstr ""
2663    
2664     # type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
2665     #: en/upgrading.dbk:1666
2666     msgid "Find the section similar to:"
2667     msgstr ""
2668    
2669     # type: Content of: <chapter><section><section><section><orderedlist><listitem><para><programlisting>
2670     #: en/upgrading.dbk:1667
2671     #, no-wrap
2672     msgid ""
2673     "## ## End Default Options ##\n"
2674     "\n"
2675     "title Debian GNU/Linux, kernel 2.6.26-1-686\n"
2676     "root (hd0,0)\n"
2677     "kernel /vmlinuz-2.6.26-1-686 root=/dev/hda6 ro\n"
2678     "initrd /initrd.img-2.6.26-1-686\n"
2679     "\n"
2680     "title Debian GNU/Linux, kernel 2.6.26-1-686 (single-user mode)\n"
2681     "root (hd0,0)\n"
2682     "kernel /vmlinuz-2.6.26-1-686 root=/dev/hda6 ro single\n"
2683     "initrd /initrd.img-2.6.26-1-686\n"
2684     "\n"
2685     "### END DEBIAN AUTOMAGIC KERNELS LIST"
2686     msgstr ""
2687    
2688     # type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
2689     #: en/upgrading.dbk:1681
2690     msgid ""
2691     "and replace every <literal>hda</literal>, <literal>hdb</literal>, "
2692     "<literal>hdc</literal>, <literal>hdd</literal> respectively with "
2693     "<literal>sda</literal>, <literal>sdb</literal>, <literal>sdc</literal>, "
2694     "<literal>sdd</literal>. Don't modify the line similar to:"
2695     msgstr ""
2696    
2697     # type: Content of: <chapter><section><section><section><orderedlist><listitem><para><screen>
2698     #: en/upgrading.dbk:1688
2699     #, no-wrap
2700     msgid "root (hd0,0)"
2701     msgstr ""
2702    
2703     # type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
2704     #: en/upgrading.dbk:1693
2705     msgid ""
2706     "Reboot the system, remove the LiveCD and your system should boot correctly."
2707     msgstr ""
2708    
2709     # type: Content of: <chapter><section><section><section><orderedlist><listitem><para>
2710     #: en/upgrading.dbk:1699
2711     msgid ""
2712     "When it has booted, apply one of the two proposed procedures under <xref "
2713     "linkend=\"avoid-problems-before-upgrading\"/> to fix the problem permanently."
2714     msgstr ""
2715    
2716     # type: Content of: <chapter><section><title>
2717     #: en/upgrading.dbk:1711
2718 debacle 5329 msgid "Preparing for the next release"
2719     msgstr ""
2720    
2721     # type: Content of: <chapter><section><para>
2722 debacle 5427 #: en/upgrading.dbk:1713
2723 debacle 5329 msgid ""
2724     "After the upgrade there are several things you can do to prepare for the "
2725     "next release."
2726     msgstr ""
2727    
2728     # type: Content of: <chapter><section><itemizedlist><listitem><para>
2729 debacle 5427 #: en/upgrading.dbk:1719
2730 debacle 5329 msgid ""
2731 debacle 5419 "If using <command>grub</command>, edit <filename>/etc/kernel-img.conf</"
2732     "filename> and adjust the location of the <command>update-grub</command> "
2733     "program changing <filename>/sbin/update-grub</filename> to <filename>/usr/"
2734     "sbin/update-grub</filename>."
2735 debacle 5329 msgstr ""
2736    
2737     # type: Content of: <chapter><section><itemizedlist><listitem><para>
2738 debacle 5427 #: en/upgrading.dbk:1728
2739 debacle 5329 msgid ""
2740     "If the new kernel image metapackage was pulled in as a dependency of the old "
2741 debacle 5419 "one, it will be marked as automatically installed, which should be corrected:"
2742 debacle 5329 msgstr ""
2743    
2744     # type: Content of: <chapter><section><itemizedlist><listitem><screen>
2745 debacle 5427 #: en/upgrading.dbk:1731
2746 debacle 5329 #, no-wrap
2747     msgid ""
2748     "\n"
2749     "# aptitude unmarkauto $(dpkg-query -W 'linux-image-2.6-*' | cut -f1)\n"
2750     msgstr ""
2751    
2752     # type: Content of: <chapter><section><itemizedlist><listitem><para>
2753 debacle 5427 #: en/upgrading.dbk:1737
2754 debacle 5329 msgid "Remove &oldreleasename;'s kernel metapackages by running:"
2755     msgstr ""
2756    
2757     # type: Content of: <chapter><section><itemizedlist><listitem><screen>
2758 debacle 5427 #: en/upgrading.dbk:1739
2759 debacle 5329 #, no-wrap
2760     msgid ""
2761     "\n"
2762     "# aptitude purge kernel-image-2.6-&lt;flavor&gt;\n"
2763     msgstr ""
2764    
2765     # type: Content of: <chapter><section><itemizedlist><listitem><para>
2766 debacle 5427 #: en/upgrading.dbk:1745
2767 debacle 5329 msgid ""
2768 debacle 5419 "Move any configuration options from <filename>/etc/network/options</"
2769     "filename> to <filename>/etc/sysctl.conf</filename>. Please see <filename>/"
2770     "usr/share/doc/netbase/README.Debian</filename> for details."
2771 debacle 5329 msgstr ""
2772    
2773     # type: Content of: <chapter><section><itemizedlist><listitem><para>
2774 debacle 5427 #: en/upgrading.dbk:1752
2775 debacle 5329 msgid ""
2776 debacle 5419 "Remove obsolete and unused packages as described in <xref linkend=\"obsolete"
2777     "\"/> . You should review which configuration files they use and consider "
2778     "purging the packages to remove their configuration files"
2779 debacle 5329 msgstr ""
2780    
2781     # type: Content of: <chapter><section><title>
2782 debacle 5427 #: en/upgrading.dbk:1761
2783 debacle 5329 msgid "Deprecated packages"
2784     msgstr ""
2785    
2786     # type: Content of: <chapter><section><para>
2787 debacle 5427 #: en/upgrading.dbk:1763
2788 debacle 5329 msgid ""
2789     "With the release of <literal>Lenny</literal> a bigger number of server "
2790     "packages will be deprecated, thus updating to newer versions of those now "
2791     "will save you from trouble when updating to <literal>Lenny</literal>."
2792     msgstr ""
2793    
2794     # type: Content of: <chapter><section><para>
2795 debacle 5427 #: en/upgrading.dbk:1768
2796 debacle 5329 msgid "This includes the following packages:"
2797     msgstr ""
2798    
2799     # type: Content of: <chapter><section><itemizedlist><listitem><para>
2800 debacle 5427 #: en/upgrading.dbk:1773
2801 debacle 5329 msgid "apache (1.x), successor is apache2"
2802     msgstr ""
2803    
2804     # type: Content of: <chapter><section><itemizedlist><listitem><para>
2805 debacle 5427 #: en/upgrading.dbk:1778
2806 debacle 5329 msgid "bind8, successor is bind9"
2807     msgstr ""
2808    
2809     # type: Content of: <chapter><section><itemizedlist><listitem><para>
2810 debacle 5427 #: en/upgrading.dbk:1783
2811 debacle 5329 msgid "php4, successor is php5"
2812     msgstr ""
2813    
2814     # type: Content of: <chapter><section><itemizedlist><listitem><para>
2815 debacle 5427 #: en/upgrading.dbk:1788
2816 debacle 5329 msgid "postgresql-7.4, successor is postgresql-8.1"
2817     msgstr ""
2818    
2819     # type: Content of: <chapter><section><itemizedlist><listitem><para>
2820 debacle 5427 #: en/upgrading.dbk:1793
2821 debacle 5329 msgid "exim 3, successor is exim4"
2822     msgstr ""
2823    
2824     # type: Content of: <chapter><section><title>
2825 debacle 5427 #: en/upgrading.dbk:1800
2826 debacle 5329 msgid "Obsolete packages"
2827     msgstr ""
2828    
2829     # type: Content of: <chapter><section><para><footnote>
2830 debacle 5427 #: en/upgrading.dbk:1802
2831 debacle 5329 msgid ""
2832     "Introducing several thousand new packages, &releasename; also retires and "
2833     "omits more than two thousand old packages that were in &oldreleasename;. It "
2834     "provides no upgrade path for these obsolete packages. While nothing "
2835     "prevents you from continuing to use an obsolete package where desired, the "
2836     "Debian project will usually discontinue security support for it a year after "
2837     "&releasename;'s release<footnote>"
2838     msgstr ""
2839    
2840     # type: Content of: <chapter><section><para><footnote><para>
2841 debacle 5427 #: en/upgrading.dbk:1806
2842 debacle 5329 msgid ""
2843     "Or for as long as there is not another release in that time frame. "
2844     "Typically only two stable releases are supported at any given time."
2845     msgstr ""
2846    
2847     # type: Content of: <chapter><section><para>
2848 debacle 5427 #: en/upgrading.dbk:1808
2849 debacle 5329 msgid ""
2850     "</footnote>, and will not normally provide other support in the meantime. "
2851     "Replacing them with available alternatives, if any, is recommended."
2852     msgstr ""
2853    
2854     # type: Content of: <chapter><section><para>
2855 debacle 5427 #: en/upgrading.dbk:1813
2856 debacle 5329 msgid ""
2857     "There are many reasons why packages might have been removed from the "
2858     "distribution: they are no longer maintained upstream; there is no longer a "
2859     "Debian Developer interested in maintaining the packages; the functionality "
2860     "they provide has been superseded by different software (or a new version); "
2861     "or they are no longer considered suitable for &releasename; due to bugs in "
2862     "them. In the latter case, packages might still be present in the unstable "
2863     "distribution."
2864     msgstr ""
2865    
2866     # type: Content of: <chapter><section><para>
2867 debacle 5427 #: en/upgrading.dbk:1821
2868 debacle 5329 msgid ""
2869     "Detecting which packages in an updated system are obsolete is easy since the "
2870     "package management front-ends will mark them as such. If you are using "
2871     "<command>aptitude</command>, you will see a listing of these packages in the "
2872     "Obsolete and Locally Created Packages entry. <command>dselect</command> "
2873     "provides a similar section but the listing it presents might differ. Also, "
2874     "if you have used <command>aptitude</command> to manually install packages in "
2875     "&oldreleasename; it will have kept track of those packages you manually "
2876     "installed and will be able to mark as obsolete those packages pulled in by "
2877     "dependencies alone which are no longer needed if a package has been "
2878 debacle 5419 "removed. Also, <command>aptitude</command>, unlike <command>deborphan</"
2879     "command> will not mark as obsolete packages that you manually installed, as "
2880     "opposed to those that were automatically installed through dependencies."
2881 debacle 5329 msgstr ""
2882    
2883     # type: Content of: <chapter><section><para>
2884 debacle 5427 #: en/upgrading.dbk:1835
2885 debacle 5329 msgid ""
2886     "There are additional tools you can use to find obsolete packages such as "
2887     "<command>deborphan</command>, <command>debfoster</command> or "
2888     "<command>cruft</command>. <command>deborphan</command> is highly "
2889     "recommended, although it will (in default mode) only report obsolete "
2890     "libraries: packages in the libs or oldlibs sections that are not used by any "
2891     "other packages. Do not blindly remove the packages these tools present, "
2892     "especially if you are using aggressive non-default options that are prone to "
2893     "produce false positives. It is highly recommended that you manually review "
2894     "the packages suggested for removal (i.e. their contents, size and "
2895     "description) before you remove them."
2896     msgstr ""
2897    
2898     # type: Content of: <chapter><section><para>
2899 debacle 5427 #: en/upgrading.dbk:1846
2900 debacle 5329 msgid ""
2901 debacle 5419 "The <ulink url=\"&url-bts;\">Debian Bug Tracking System</ulink> often "
2902     "provides additional information on why the package was removed. You should "
2903     "review both the archived bug reports for the package itself and the archived "
2904     "bug reports for the <ulink url=\"&url-bts;cgi-bin/pkgreport.cgi?pkg=ftp."
2905     "debian.org&amp;archive=yes\">ftp.debian.org pseudo-package</ulink>."
2906 debacle 5329 msgstr ""
2907    
2908     # type: Content of: <chapter><section><section><title>
2909 debacle 5427 #: en/upgrading.dbk:1854
2910 debacle 5329 msgid "Dummy packages"
2911     msgstr ""
2912    
2913     # type: Content of: <chapter><section><section><para>
2914 debacle 5427 #: en/upgrading.dbk:1856
2915 debacle 5329 msgid ""
2916     "Some packages from &oldreleasename; have been split into several packages in "
2917     "&releasename;, often to improve system maintainability. To ease the upgrade "
2918     "path in such cases, &releasename; often provides dummy packages: empty "
2919     "packages that have the same name as the old package in &oldreleasename; with "
2920     "dependencies that cause the new packages to be installed. These dummy "
2921     "packages are considered obsolete packages after the upgrade and can be "
2922     "safely removed."
2923     msgstr ""
2924    
2925     # type: Content of: <chapter><section><section><para>
2926 debacle 5427 #: en/upgrading.dbk:1864
2927 debacle 5329 msgid ""
2928     "Most (but not all) dummy packages' descriptions indicate their purpose. "
2929     "Package descriptions for dummy packages are not uniform, however, so you "
2930 debacle 5419 "might also find <command>deborphan</command> with the <literal>--guess</"
2931     "literal> options useful to detect them in your system. Note that some dummy "
2932     "packages are not intended to be removed after an upgrade but are, instead, "
2933     "used to keep track of the current available version of a program over time."
2934 debacle 5329 msgstr ""
2935 debacle 5419
2936     # type: Content of: <chapter><section><title>
2937 debacle 5427 #: en/upgrading.dbk:1876
2938 debacle 5419 msgid "Plans for the next Debian release"
2939     msgstr ""
2940    
2941     # type: Content of: <chapter><section><section><title>
2942 debacle 5427 #: en/upgrading.dbk:1879
2943 debacle 5419 msgid "Drop of the ARM port, in favour of the ARM EABI port"
2944     msgstr ""
2945    
2946     # type: Content of: <chapter><section><section><para>
2947 debacle 5427 #: en/upgrading.dbk:1882
2948 debacle 5419 msgid ""
2949     "Debian lenny has two different and incompatible ARM ports: the old ABI port "
2950     "(arm) and the new EABI port (armel). Debian lenny is the last release with "
2951     "support for the ARM port and future releases will only support the ARM EABI "
2952     "or armel port. It's therefore recommended to use armel for new "
2953     "installations of lenny."
2954     msgstr ""
2955    
2956     # type: Content of: <chapter><section><section><para>
2957 debacle 5427 #: en/upgrading.dbk:1891
2958 debacle 5419 msgid ""
2959     "With the exception of Netwinder, installer images for supported ARM machines "
2960     "are available for both arm and armel in lenny. Netwinder support is only "
2961     "available for arm and it will be dropped after lenny along with the arm port."
2962     msgstr ""
2963    
2964     # type: Content of: <chapter><section><section><para>
2965 debacle 5427 #: en/upgrading.dbk:1898
2966 debacle 5419 msgid ""
2967     "Please visit <ulink url=\"http://wiki.debian.org/ArmEabiPort\">this page</"
2968     "ulink> to learn more about the ARM EABI (armel) port."
2969     msgstr ""

  ViewVC Help
Powered by ViewVC 1.1.5