| 1 |
<!DOCTYPE debiandoc PUBLIC "-//DebianDoc//DTD DebianDoc//EN" [ |
<!DOCTYPE debiandoc PUBLIC "-//DebianDoc//DTD DebianDoc//EN" [ |
| 2 |
<!entity % dynamicdata SYSTEM "../dynamic.ent" > %dynamicdata; |
<!entity % dynamicdata SYSTEM "../dynamic.ent" > %dynamicdata; |
| 3 |
<!entity % shareddata SYSTEM "../release-notes.ent" > %shareddata; |
<!entity % shareddata SYSTEM "../release-notes.ent" > %shareddata; |
| 4 |
<!entity docid "$Id: release-notes.en.sgml,v 1.44 2005-05-26 12:15:07 fjp Exp $"> |
<!entity docid "$Id: release-notes.en.sgml,v 1.45 2005-05-27 00:04:26 fjp Exp $"> |
| 5 |
]> |
]> |
| 6 |
|
|
| 7 |
<!-- Be careful with automatic reformatting. Please note that the indentation |
<!-- Be careful with automatic reformatting. Please note that the indentation |
| 13 |
<title>Release Notes for &debian; &release; (`&releasename'), &arch-title;</title> |
<title>Release Notes for &debian; &release; (`&releasename'), &arch-title;</title> |
| 14 |
<author> |
<author> |
| 15 |
<name>Josip Rodin, Bob Hilliard, Adam Di Carlo, Anne Bezemer, Rob |
<name>Josip Rodin, Bob Hilliard, Adam Di Carlo, Anne Bezemer, Rob |
| 16 |
Bradford (current)</name><email></email> |
Bradford (current), Frans Pop (current)</name><email></email> |
| 17 |
</author> |
</author> |
| 18 |
<author> |
<author> |
| 19 |
<name></name><email>debian-doc@lists.debian.org</email> |
<name></name><email>debian-doc@lists.debian.org</email> |
| 325 |
|
|
| 326 |
<p>The main things you'll want to back up are the contents of |
<p>The main things you'll want to back up are the contents of |
| 327 |
<file>/etc</file>, <file>/var/lib/dpkg</file> and the output of |
<file>/etc</file>, <file>/var/lib/dpkg</file> and the output of |
| 328 |
<tt>dpkg --get-selections \*</tt>.</p> |
<tt>dpkg --get-selections "*"</tt> (the quotes are important).</p> |
| 329 |
|
|
| 330 |
<p>It's wise to inform all users in advance of any upgrades you're |
<p>It's wise to inform all users in advance of any upgrades you're |
| 331 |
planning, although users accessing your system via SSH (at least) |
planning, although users accessing your system via SSH (at least) |
| 339 |
textmode virtual console (or a directly connected serial |
textmode virtual console (or a directly connected serial |
| 340 |
terminal), or remotely via an <prgn/ssh/ link.</p> |
terminal), or remotely via an <prgn/ssh/ link.</p> |
| 341 |
|
|
| 342 |
<p><em/Important/: You should <em/not/ upgrade using <prgn/telnet/, |
<p><strong/Important!/ You should <em/not/ upgrade using <prgn/telnet/, |
| 343 |
<prgn/rlogin/, <prgn/rsh/, or from an X session managed by <prgn/xdm/, |
<prgn/rlogin/, <prgn/rsh/, or from an X session managed by <prgn/xdm/, |
| 344 |
<prgn/gdm/ or <prgn/kdm/ etc on the machine you are upgrading. That is |
<prgn/gdm/ or <prgn/kdm/ etc on the machine you are upgrading. That is |
| 345 |
because each of those services may well be terminated during the |
because each of those services may well be terminated during the |
| 346 |
upgrade, which can result in an <em/inaccessible/ system that is only |
upgrade, which can result in an <em/inaccessible/ system that is only |
| 347 |
half-upgraded.</p> |
half-upgraded.</p> |
| 348 |
|
|
| 349 |
<p>The recommended method of upgrading is to use <prgn/aptitude/, as |
<p>Any package installation operation must be run with superuser |
|
described here. The built-in dependency analysis enables smooth |
|
|
upgrades and easy installations.</p> |
|
|
|
|
|
<p>Any package installation operation must be run with superuser |
|
| 350 |
privileges, so either login as root or use <prgn/su/ or |
privileges, so either login as root or use <prgn/su/ or |
| 351 |
<prgn/sudo/ to gain the necessary access rights.</p> |
<prgn/sudo/ to gain the necessary access rights.</p> |
|
|
|
|
<p>First the <package>aptitude</package> package needs to be installed. |
|
|
This is done with:</p> |
|
| 352 |
|
|
| 353 |
<p><example> |
</sect> |
|
apt-get install aptitude |
|
|
</example></p> |
|
| 354 |
|
|
| 355 |
<p>Provided that you have a working APT configuration this will |
<sect id="system-status"> |
| 356 |
install the &oldreleasename; version of |
<heading>Checking system status</heading> |
| 357 |
|
|
| 358 |
<prgn>aptitude</prgn>.</p> |
<p>The upgrade process described in this chapter has been designed for |
| 359 |
|
upgrades from "pure" &oldreleasename; systems. It assumes your system |
| 360 |
|
has been updated to the latest point release of &oldreleasename;. |
| 361 |
|
If you have not or are unsure, follow the instructions in |
| 362 |
|
<ref id="old-upgrade"></p> |
| 363 |
|
|
| 364 |
|
<![ %has-woody-aptitude [ |
| 365 |
|
<p>It also assumes you have the &oldreleasename; version of |
| 366 |
|
<prgn/aptitude/ installed. You can check if it is installed using |
| 367 |
|
|
| 368 |
|
<example> |
| 369 |
|
$ dpkg -l aptitude |
| 370 |
|
</example> |
| 371 |
|
|
| 372 |
|
If the line of output does <em/not/ begin with "i", you should install |
| 373 |
|
it before you start the upgrade using the instructions in |
| 374 |
|
<ref id="old-aptitude">.</p> |
| 375 |
|
]]> |
| 376 |
|
|
| 377 |
|
<sect1><heading>Disabling APT pinning</heading> |
| 378 |
|
|
| 379 |
|
<p>If you have configured APT to install certain packages from a |
| 380 |
|
distribution other than stable (e.g. from testing), you may have to |
| 381 |
|
change your APT pinning configuration (stored in |
| 382 |
|
<file>/etc/apt/preferences</file>) to allow the upgrade of packages to |
| 383 |
|
the versions in the new stable release. Further information on APT |
| 384 |
|
pinning can be found in <manref name="apt_preferences" section="5">.</p> |
| 385 |
|
|
| 386 |
|
</sect1> |
| 387 |
|
|
| 388 |
|
<sect1><heading>Checking packages status</heading> |
| 389 |
|
|
| 390 |
|
<p>Regardless of the method used for upgrading, it is recommended |
| 391 |
|
that you check the status of all packages first, and verify that |
| 392 |
|
all packages are in an upgradable state. The following command |
| 393 |
|
will show any packages which have a status of Half-Installed or |
| 394 |
|
Failed-Config, and those with any error status. |
| 395 |
|
|
| 396 |
|
<example> |
| 397 |
|
# dpkg --audit |
| 398 |
|
</example></p> |
| 399 |
|
|
| 400 |
|
<p>You could also inspect the state of all packages on your system |
| 401 |
|
using <prgn/dselect/, <prgn/aptitude/, or with commands such as |
| 402 |
|
|
| 403 |
|
<example> |
| 404 |
|
# dpkg -l | pager |
| 405 |
|
</example> |
| 406 |
|
|
| 407 |
|
or |
| 408 |
|
|
| 409 |
|
<example> |
| 410 |
|
# dpkg --get-selections > ~/curr-pkgs.txt |
| 411 |
|
</example></p> |
| 412 |
|
|
| 413 |
|
<p>It is desirable to remove any holds before upgrading. If any |
| 414 |
|
package that is essential for the upgrade is on hold, the upgrade |
| 415 |
|
will fail. You can identify packages on hold with |
| 416 |
|
|
| 417 |
|
<example> |
| 418 |
|
# dpkg --audit |
| 419 |
|
</example></p> |
| 420 |
|
|
| 421 |
|
<p>If you changed and recompiled a package locally, and didn't rename |
| 422 |
|
it or put an epoch in the version, you must put it on hold to prevent |
| 423 |
|
it from being upgraded. |
| 424 |
|
|
| 425 |
|
<![ %has-woody-aptitude [ |
| 426 |
|
The `hold' package state can be changed by using <prgn/aptitude/: |
| 427 |
|
|
| 428 |
|
<example> |
| 429 |
|
# aptitude hold | unhold <package name> |
| 430 |
|
</example> |
| 431 |
|
]]> |
| 432 |
|
<![ %no-woody-aptitude [ |
| 433 |
|
The `hold' package state can be changed either by using <prgn/dselect/ |
| 434 |
|
(in the Select menu, use the `H' and `G' keys to hold and unhold, |
| 435 |
|
respectively), or by editing the file produced by |
| 436 |
|
|
| 437 |
|
<example> |
| 438 |
|
# dpkg --get-selections > ~/curr-sels.txt |
| 439 |
|
</example> |
| 440 |
|
|
| 441 |
|
to change "hold" to "install" (or vice versa), and then doing |
| 442 |
|
|
| 443 |
|
<example> |
| 444 |
|
# dpkg --set-selections < ~/curr-sels.txt |
| 445 |
|
</example> |
| 446 |
|
]]> |
| 447 |
|
</p> |
| 448 |
|
|
| 449 |
|
<p>If there is anything you need to fix, it is best to make sure your |
| 450 |
|
<file/sources.list/ still refers to &oldreleasename; as explained in |
| 451 |
|
<ref id="old-sources">.</p> |
| 452 |
|
</sect1> |
| 453 |
|
|
| 454 |
|
<sect1 id="backports"><heading>Unofficial sources and backports</heading> |
| 455 |
|
|
| 456 |
|
<p>If you have any non-Debian packages on your system, you should be |
| 457 |
|
aware that these may be removed during the upgrade because of |
| 458 |
|
conflicting dependencies. If these packages were installed by adding |
| 459 |
|
an extra package archive in your <file>/etc/apt/sources.list</file>, |
| 460 |
|
you should check if that archive also offers packages compiled for |
| 461 |
|
&releasename; and change the source line accordingly at the same time |
| 462 |
|
as your source lines for Debian packages.</p> |
| 463 |
|
|
| 464 |
|
<p>Some users may have unofficial backported "newer" versions of |
| 465 |
|
packages that <em/are/ in Debian installed on their &oldreleasename; |
| 466 |
|
system. Such packages are most likely to cause problems during an |
| 467 |
|
upgrade as they may result in file conflicts<footnote>Debian's |
| 468 |
|
package management system normally does not allow a package to remove |
| 469 |
|
or replace a file owned by another package; not unless it has been |
| 470 |
|
defined to replace that package.</footnote>. Section <ref id="trouble"> |
| 471 |
|
has some information on how to deal with file conflicts if they should |
| 472 |
|
occur.</p> |
| 473 |
|
|
| 474 |
|
</sect1> |
| 475 |
|
</sect> |
| 476 |
|
|
| 477 |
<![ %glibcneedsnewkernel [ |
<![ %glibcneedsnewkernel [ |
| 478 |
|
|
| 479 |
<sect1 id="new-kernel"> |
<sect id="new-kernel"> |
| 480 |
<heading>Checking kernel support</heading> |
<heading>Checking kernel support</heading> |
| 481 |
|
|
| 482 |
<![ %sparc [ |
<![ %sparc [ |
| 530 |
]]> |
]]> |
| 531 |
|
|
| 532 |
<![ %upgradekernel [ |
<![ %upgradekernel [ |
| 533 |
<sect2 id="kernel-upgrade"><heading>Upgrading the kernel</heading> |
<sect1 id="kernel-upgrade"><heading>Upgrading the kernel</heading> |
| 534 |
|
|
| 535 |
<p>If (and only if) the previous section indicates that you should |
<p>If (and only if) the previous section indicates that you should |
| 536 |
upgrade your kernel <em/before/ the upgrade of the system, you |
upgrade your kernel <em/before/ the upgrade of the system, you |
| 544 |
Detailed instructions on how to install the new kernel can be |
Detailed instructions on how to install the new kernel can be |
| 545 |
found in <ref id="kernel-upgrade-howto">.</p> |
found in <ref id="kernel-upgrade-howto">.</p> |
| 546 |
|
|
|
</sect2> |
|
|
]]> |
|
|
</sect1> |
|
|
]]> |
|
|
|
|
|
<sect1><heading>Disabling APT pinning</heading> |
|
|
|
|
|
<p>If you have configured APT to install certain packages from a |
|
|
distribution other than stable (e.g. from testing), you may have to |
|
|
change your APT pinning configuration (stored in |
|
|
<file>/etc/apt/preferences</file>) to allow the upgrade of packages to |
|
|
the versions in the new stable release. Further information on APT |
|
|
pinning can be found in <manref name="apt_preferences" section="5">.</p> |
|
|
<!-- FJP: Couldn't the advise to hold such packages prevent the upgrade of e.g. |
|
|
libc6 if the package depends on the old version! --> |
|
|
|
|
|
</sect1> |
|
|
|
|
|
<sect1><heading>Checking packages status</heading> |
|
|
|
|
|
<p>Regardless of the method used for upgrading, it is recommended |
|
|
that you check the status of all packages first, and verify that |
|
|
all packages are in an upgradable state. The following command |
|
|
will show any packages which have a status of Half-Installed or |
|
|
Failed-Config, and those with any error status. |
|
|
|
|
|
<example> |
|
|
# dpkg --audit |
|
|
</example></p> |
|
|
|
|
|
<p>You could also inspect the state of all packages on your system |
|
|
using <prgn/dselect/, <prgn/aptitude/, or with commands such as |
|
|
|
|
|
<example> |
|
|
# dpkg -l | pager |
|
|
</example> |
|
|
|
|
|
or |
|
|
|
|
|
<example> |
|
|
# dpkg --get-selections > ~/curr-pkgs.txt |
|
|
</example></p> |
|
|
|
|
|
<p>It is desirable to remove any holds before upgrading. If any |
|
|
package that is essential for the upgrade is on hold, the upgrade |
|
|
will fail. You can identify packages on hold with |
|
|
|
|
|
<example> |
|
|
# dpkg --audit |
|
|
</example></p> |
|
|
|
|
|
<p>If you changed and recompiled a package locally, and didn't rename |
|
|
it or put an epoch in the version, you must put it on hold to prevent |
|
|
it from being upgraded. The `hold' package state can be changed by |
|
|
using <prgn/aptitude/. With |
|
|
|
|
|
<example> |
|
|
aptitude hold | unhold <package> |
|
|
</example> |
|
|
</p> |
|
| 547 |
</sect1> |
</sect1> |
| 548 |
|
]]> |
| 549 |
</sect> |
</sect> |
| 550 |
|
]]> |
| 551 |
|
|
| 552 |
<sect id="upgrade-process"><heading>Preparing sources for APT</heading> |
<sect id="upgrade-process"><heading>Preparing sources for APT</heading> |
| 553 |
|
|
| 562 |
name a local harddisk, then CD-ROMs, and then HTTP/FTP |
name a local harddisk, then CD-ROMs, and then HTTP/FTP |
| 563 |
mirrors).</p> |
mirrors).</p> |
| 564 |
|
|
| 565 |
|
<p>A release can often be referred to by both its codename (e.g. |
| 566 |
|
&oldreleasename;, &releasename;) and by its status name (i.e. |
| 567 |
|
oldstable, stable, testing, unstable). Referring to a release by its |
| 568 |
|
codename has the advantage that you will never be surprised by a |
| 569 |
|
new release and for this reason is the approach taken here. It |
| 570 |
|
does of course mean that you will have to watch out for release |
| 571 |
|
announcements yourself. If you use the status name instead, you |
| 572 |
|
will just see loads of updates for packages available as soon as a |
| 573 |
|
release has happened.</p> |
| 574 |
|
|
| 575 |
<sect1 id="network"><heading>Adding APT Internet sources</heading> |
<sect1 id="network"><heading>Adding APT Internet sources</heading> |
| 576 |
|
|
| 577 |
<p>The default configuration is set up for installation from main |
<p>The default configuration is set up for installation from main |
| 589 |
<url id="&url-debian-mirrors;"> (look at the "Full list of |
<url id="&url-debian-mirrors;"> (look at the "Full list of |
| 590 |
mirrors" section). HTTP mirrors are generally speedier than FTP |
mirrors" section). HTTP mirrors are generally speedier than FTP |
| 591 |
mirrors.</p> |
mirrors.</p> |
|
<!-- FJP: 'Otherwise' does not refer back to anything here, so I deleted it |
|
|
(unless the intention was to refer to local intr_a_net HTTP |
|
|
servers in the previous para). --> |
|
| 592 |
|
|
| 593 |
<p>For example, suppose your closest Debian mirror is |
<p>For example, suppose your closest Debian mirror is |
| 594 |
<tt>&url-debian-mirror-eg;/</tt>. When inspecting that mirror |
<tt>&url-debian-mirror-eg;/</tt>. When inspecting that mirror |
| 596 |
directories are organized like this: |
directories are organized like this: |
| 597 |
|
|
| 598 |
<example> |
<example> |
| 599 |
&url-debian-mirror-eg;/dists/stable/main/binary-&architecture;/... |
&url-debian-mirror-eg;/dists/&releasename;/main/binary-&architecture;/... |
| 600 |
&url-debian-mirror-eg;/dists/stable/contrib/binary-&architecture;/... |
&url-debian-mirror-eg;/dists/&releasename;/contrib/binary-&architecture;/... |
| 601 |
</example></p> |
</example></p> |
| 602 |
|
|
| 603 |
<p>To use this mirror with <prgn/apt/, you add this line to your |
<p>To use this mirror with <prgn/apt/, you add this line to your |
| 636 |
this: |
this: |
| 637 |
|
|
| 638 |
<example> |
<example> |
| 639 |
/var/ftp/debian/dists/stable/main/binary-&architecture;/... |
/var/ftp/debian/dists/&releasename;/main/binary-&architecture;/... |
| 640 |
/var/ftp/debian/dists/stable/contrib/binary-&architecture;/... |
/var/ftp/debian/dists/&releasename;/contrib/binary-&architecture;/... |
| 641 |
</example></p> |
</example></p> |
| 642 |
|
|
| 643 |
<p>To use this with <prgn/apt/, add this line to your |
<p>To use this with <prgn/apt/, add this line to your |
| 644 |
<file/sources.list/ file: |
<file/sources.list/ file: |
| 645 |
|
|
| 646 |
<example> |
<example> |
| 647 |
deb file:/var/ftp/debian stable main contrib |
deb file:/var/ftp/debian &releasename; main contrib |
| 648 |
</example></p> |
</example></p> |
| 649 |
|
|
| 650 |
<p>Note that the `<tt>dists</tt>' is added implicitly, and the |
<p>Note that the `<tt>dists</tt>' is added implicitly, and the |
| 655 |
existing "<tt/deb/" lines in <file/sources.list/, by placing a |
existing "<tt/deb/" lines in <file/sources.list/, by placing a |
| 656 |
hash sign (<tt/#/) in front of them.</p></sect1> |
hash sign (<tt/#/) in front of them.</p></sect1> |
| 657 |
|
|
| 658 |
<sect1 id="cdroms"><heading>Adding APT source from CD-ROM</heading> |
<sect1 id="cdroms"><heading>Adding APT source from CD-ROM or DVD</heading> |
|
|
|
|
<!-- FJP: Are these instructions also valid for adding DVD's? --> |
|
| 659 |
|
|
| 660 |
<p>If you want to use CDs <em/only/, comment out the existing |
<p>If you want to use CDs <em/only/, comment out the existing |
| 661 |
"<tt/deb/" lines in <file>/etc/apt/sources.list</file> by placing |
"<tt/deb/" lines in <file>/etc/apt/sources.list</file> by placing |
| 680 |
<p>To verify it works, insert a CD and try running |
<p>To verify it works, insert a CD and try running |
| 681 |
|
|
| 682 |
<example> |
<example> |
| 683 |
mount /cdrom # this will mount the CD to the mount point |
# mount /cdrom # this will mount the CD to the mount point |
| 684 |
ls -alF /cdrom # this should show the CD's root directory |
# ls -alF /cdrom # this should show the CD's root directory |
| 685 |
umount /cdrom # this will unmount the CD |
# umount /cdrom # this will unmount the CD |
| 686 |
</example></p> |
</example></p> |
| 687 |
|
|
| 688 |
<p>Next, run: |
<p>Next, run: |
| 689 |
|
|
| 690 |
<example> |
<example> |
| 691 |
apt-cdrom add |
# apt-cdrom add |
| 692 |
</example> |
</example> |
| 693 |
|
|
| 694 |
for each Debian Binary CD-ROM you have, to add the data about |
for each Debian Binary CD-ROM you have, to add the data about |
| 697 |
</sect> |
</sect> |
| 698 |
|
|
| 699 |
<sect id="upgradingpackages"><heading>Upgrading packages</heading> |
<sect id="upgradingpackages"><heading>Upgrading packages</heading> |
| 700 |
|
|
| 701 |
<p>The recommended tool for upgrading between &debian; releases is |
<p>The recommended tool for upgrading between &debian; releases is |
| 702 |
to use the package management tool <prgn>aptitude</prgn>. This tool |
to use the package management tool <prgn>aptitude</prgn>. This tool |
| 703 |
makes safer decisions about package installations than running |
makes safer decisions about package installations than running |
| 704 |
<prgn>apt-get</prgn> directly.</p> |
<prgn>apt-get</prgn> directly.</p> |
| 705 |
|
|
| 706 |
<p>Don't forget to mount all needed partitions (notably the root |
<p>Don't forget to mount all needed partitions (notably the root |
| 707 |
and <file>/usr</file> partitions) read-write, with a command |
and <file>/usr</file> partitions) read-write, with a command |
| 708 |
like: |
like: |
| 709 |
|
|
| 710 |
<example> |
<example> |
| 711 |
mount -o remount,rw /<var>mountpoint</var> |
# mount -o remount,rw /<var>mountpoint</var> |
| 712 |
</example></p> |
</example></p> |
| 713 |
|
|
| 714 |
<p>Next ensure that the APT source entries (in |
<p>Next you should double check that the APT source entries (in |
| 715 |
<file>/etc/apt/sources.list</file>) refer to the <tt>'stable'</tt> |
<file>/etc/apt/sources.list</file>) refer either to |
| 716 |
distribution and do not refer to it by its codename (e.g. |
"<tt/&releasename;/" or to "<tt>stable</tt>". Note: source |
| 717 |
<tt>&oldreleasename;</tt>). |
lines for a CD-ROM will often refer to "<tt/unstable/"; |
| 718 |
|
although this may be confusing, you should <em/not/ change it.</p> |
| 719 |
|
|
| 720 |
<p>It is strongly recommended that you use the |
<p>It is strongly recommended that you use the |
| 721 |
<prgn>/usr/bin/script</prgn> program to record a transcript of the |
<prgn>/usr/bin/script</prgn> program to record a transcript of the |
| 722 |
upgrade session. Then if a problem occurs, you will have a log of |
upgrade session. Then if a problem occurs, you will have a log of |
| 724 |
report. To start the recording, type: |
report. To start the recording, type: |
| 725 |
|
|
| 726 |
<example> |
<example> |
| 727 |
script -a ~/upgrade-to-&releasename;.typescript |
# script -a ~/upgrade-to-&releasename;.typescript |
| 728 |
</example> |
</example> |
| 729 |
|
|
| 730 |
or similar. Do not put the typescript file in a temporary |
or similar. Do not put the typescript file in a temporary |
| 731 |
directory such as <file>/tmp</file> or <file>/var/tmp</file> (files |
directory such as <file>/tmp</file> or <file>/var/tmp</file> (files |
| 732 |
in those directories may be deleted during the upgrade or during any |
in those directories may be deleted during the upgrade or during any |
| 733 |
restart).</p> |
restart).</p> |
| 734 |
|
|
| 735 |
<p>First <prgn>aptitude</prgn> needs to fetch a list of new and |
<p>The typescript will also allow you to review information that has |
| 736 |
updated packages for the new release. This is done by executing:</p> |
scrolled off-screen. Just switch to VT2 (using <tt/alt-F2/) and, after |
| 737 |
|
logging in, use <tt>less ~root/upgrade-to-&releasename;.typescript</tt> |
| 738 |
|
to view the file.</p> |
| 739 |
|
|
| 740 |
|
<p>After you have completed the upgrade, you can stop the typescript |
| 741 |
|
by typing <tt/exit/ at the prompt.</p> |
| 742 |
|
|
| 743 |
|
<sect1 id="updating_lists"><heading>Updating the package list</heading> |
| 744 |
|
|
| 745 |
|
<p>First the list of available packages for the new release needs to |
| 746 |
|
be fetched. This is done by executing<footnote>We use <prgn/apt-get/ |
| 747 |
|
for this because the &oldreleasename; version <prgn/aptitude/ may fail |
| 748 |
|
when new sources have been added to <file/sources.list/.</footnote>:</p> |
| 749 |
|
|
| 750 |
<p><example> |
<p><example> |
| 751 |
aptitude update |
# apt-get update |
| 752 |
</example></p> |
</example></p> |
| 753 |
|
|
| 754 |
<p>Once <prgn>aptitude</prgn> has information on all the available |
</sect1> |
| 755 |
packages, the system is almost ready to be fully upgraded. First |
|
| 756 |
however the <package>doc-base</package> package must be upgraded |
<!-- FJP: This next section can probably be dropped for etch --> |
| 757 |
<em>if it is installed</em>. You can find out if it is installed |
<sect1 id="upgrading_aptitude"><heading>Upgrading aptitude</heading> |
| 758 |
using:</p> |
|
| 759 |
|
<p>Upgrade tests have shown that &releasename;'s version of |
| 760 |
|
<prgn/aptitude/ is better at solving the complex dependencies during |
| 761 |
|
an upgrade than either <prgn/apt-get/ or &oldreleasename;'s |
| 762 |
|
<prgn/aptitude/. |
| 763 |
|
|
| 764 |
|
<![ %has-woody-aptitude [ |
| 765 |
|
It should therefore be upgraded first using: |
| 766 |
|
<example> |
| 767 |
|
# aptitude install aptitude |
| 768 |
|
</example></p> |
| 769 |
|
]]> |
| 770 |
|
<![ %no-woody-aptitude [ |
| 771 |
|
It should therefore be installed first using: |
| 772 |
|
<example> |
| 773 |
|
# apt-get install aptitude |
| 774 |
|
</example></p> |
| 775 |
|
]]> |
| 776 |
|
|
| 777 |
|
<p><prgn/aptitude/ will show you a list of the changes that will be |
| 778 |
|
made and ask you to confirm them. You should take a careful look at |
| 779 |
|
the proposed changes, especially packages that will be removed by the |
| 780 |
|
upgrade, before you confirm.</p> |
| 781 |
|
|
| 782 |
|
</sect1> |
| 783 |
|
|
| 784 |
|
<sect1 id="upgrading_doc-base"><heading>Upgrading doc-base</heading> |
| 785 |
|
|
| 786 |
|
<p><em>If you have <package/doc-base/ installed</em>, it must be |
| 787 |
|
upgraded before the rest of the system too. Reason is that it may fail |
| 788 |
|
if perl is upgraded at the same time. You can find out if it is |
| 789 |
|
installed using:</p> |
| 790 |
|
|
| 791 |
<p><example> |
<p><example> |
| 792 |
dpkg -l doc-base |
# dpkg -l doc-base |
| 793 |
</example></p> |
</example></p> |
| 794 |
|
|
| 795 |
<p>If the line of output begins with "i" then it is installed and |
<p>If the line of output begins with "i" then it is installed and |
| 796 |
must be upgraded before continuing.</p> |
must be upgraded before continuing.</p> |
| 797 |
|
|
| 798 |
<p><example> |
<p><example> |
| 799 |
aptitude install doc-base |
# aptitude install doc-base |
| 800 |
</example></p> |
</example></p> |
| 801 |
|
|
| 802 |
|
</sect1> |
| 803 |
|
|
| 804 |
|
<sect1 id="upgrading_other"><heading>Upgrading the rest of the system</heading> |
| 805 |
|
|
| 806 |
<p>You are now ready to continue with the main part of the |
<p>You are now ready to continue with the main part of the |
| 807 |
upgrade. Execute:</p> |
upgrade. Execute:</p> |
| 808 |
<p><example> |
<p><example> |
| 809 |
aptitude -f --with-recommends dist-upgrade |
# aptitude -f --with-recommends dist-upgrade |
| 810 |
</example></p> |
</example></p> |
| 811 |
|
|
| 812 |
<p>This will perform a complete upgrade of the system, i.e. install |
<p>This will perform a complete upgrade of the system, i.e. install |
| 813 |
the newest available versions of all packages, and resolve all |
the newest available versions of all packages, and resolve all |
| 814 |
possible dependency changes between packages in different releases. |
possible dependency changes between packages in different releases. |
| 815 |
If necessary, it will install some new packages (usually new library |
If necessary, it will install some new packages (usually new library |
| 833 |
dependencies in place. <package/apt/ does not allow broken package |
dependencies in place. <package/apt/ does not allow broken package |
| 834 |
dependencies to exist on a system.</p> |
dependencies to exist on a system.</p> |
| 835 |
|
|
| 836 |
|
</sect1> |
| 837 |
|
|
| 838 |
<sect1 id="trouble"><heading>Possible issues during upgrade</heading> |
<sect1 id="trouble"><heading>Possible issues during upgrade</heading> |
| 839 |
|
|
| 840 |
<p>If an operation using <prgn/aptitude/, <prgn/apt-get/ or |
<p>If an operation using <prgn/aptitude/, <prgn/apt-get/ or |
| 849 |
<file>/etc/apt/apt.conf</file>. The following command will set it |
<file>/etc/apt/apt.conf</file>. The following command will set it |
| 850 |
to a value that should be sufficient for the upgrade: |
to a value that should be sufficient for the upgrade: |
| 851 |
<example> |
<example> |
| 852 |
echo 'APT::Cache-Limit "12500000";' >> /etc/apt/apt.conf |
# echo 'APT::Cache-Limit "12500000";' >> /etc/apt/apt.conf |
| 853 |
</example> |
</example> |
| 854 |
This assumes that you do not yet have this variable set in that file.</p> |
This assumes that you do not yet have this variable set in that file.</p> |
| 855 |
|
|
| 866 |
using <prgn/aptitude/ or |
using <prgn/aptitude/ or |
| 867 |
|
|
| 868 |
<example> |
<example> |
| 869 |
dpkg --remove <var>packagename</var> |
# dpkg --remove <var>packagename</var> |
| 870 |
</example> |
</example> |
| 871 |
|
|
| 872 |
to eliminate some of the offending packages, or |
to eliminate some of the offending packages, or |
| 873 |
|
|
| 874 |
<example> |
<example> |
| 875 |
aptitude --fix-broken install |
# aptitude --fix-broken install |
| 876 |
dpkg --configure --pending |
# dpkg --configure --pending |
| 877 |
</example></p> |
</example></p> |
| 878 |
|
|
| 879 |
<p>In extreme cases you might have to force re-installation with a |
<p>In extreme cases you might have to force re-installation with a |
| 880 |
command like |
command like |
| 881 |
|
|
| 882 |
<example> |
<example> |
| 883 |
dpkg --install <var>/path/to/packagename.deb</var> |
# dpkg --install <var>/path/to/packagename.deb</var> |
| 884 |
</example></p> |
</example></p> |
| 885 |
|
|
| 886 |
|
<!-- FJP Add instructions what to do in case of file conflicts |
| 887 |
|
dpkg -r \-\-force-depends <package name> |
| 888 |
|
--> |
| 889 |
|
|
| 890 |
<p>After fixing things up, you should be able to resume the |
<p>After fixing things up, you should be able to resume the |
| 891 |
upgrade by repeating the previously described <tt/aptitude/ |
upgrade by repeating the previously described <tt/aptitude/ |
| 892 |
commands.</p> |
commands.</p> |
| 904 |
<p>If you're not sure what to do, write down the name of the |
<p>If you're not sure what to do, write down the name of the |
| 905 |
package or file, and sort things out at a later time. You can |
package or file, and sort things out at a later time. You can |
| 906 |
search in the typescript file to review the information that |
search in the typescript file to review the information that |
| 907 |
was on the screen during the upgrade.</p></sect1> |
was on the screen during the upgrade.</p> |
| 908 |
|
|
| 909 |
|
</sect1> |
| 910 |
|
</sect> |
| 911 |
|
|
| 912 |
<sect1 id="nownownow"><heading>Things to do before rebooting</heading> |
<sect id="nownownow"><heading>Things to do before rebooting</heading> |
| 913 |
|
|
| 914 |
<p>When <tt>aptitude dist-upgrade</tt> has finished, the |
<p>When <tt>aptitude dist-upgrade</tt> has finished, the |
| 915 |
"formal" upgrade is complete, but there are some other things |
"formal" upgrade is complete, but there are some other things |
| 921 |
relevant for users of all previous Debian releases. In short, you |
relevant for users of all previous Debian releases. In short, you |
| 922 |
need to read it.</p> |
need to read it.</p> |
| 923 |
|
|
| 924 |
<sect2 id="newkernel"><heading>Upgrading your kernel</heading> |
<sect1 id="newkernel"><heading>Upgrading your kernel</heading> |
| 925 |
|
|
| 926 |
<p>Note that the Linux kernel was <em/not/ upgraded by these |
<p>Note that the Linux kernel was <em/not/ upgraded by these |
| 927 |
procedures. You may wish to do so yourself, either by installing one |
procedures. You may wish to do so yourself, either by installing one |
| 946 |
<p>To upgrade your kernel you must first choose the kernel most |
<p>To upgrade your kernel you must first choose the kernel most |
| 947 |
appropriate for your subarchitecture. A list of kernels available for |
appropriate for your subarchitecture. A list of kernels available for |
| 948 |
you to install can be found with: |
you to install can be found with: |
|
<!-- FJP: s/subarchitecture/subarchitecture and processor/ ??? --> |
|
| 949 |
|
|
| 950 |
<example> |
<example> |
| 951 |
apt-cache search ^kernel-image |
# apt-cache search ^kernel-image |
| 952 |
</example></p> |
</example></p> |
| 953 |
|
|
| 954 |
<p>You should then use <tt/aptitude install/ to install it. Once |
<p>You should then use <tt/aptitude install/ to install it. Once |
| 971 |
<package>kernel-package</package> tool and read the documentation |
<package>kernel-package</package> tool and read the documentation |
| 972 |
in <file>/usr/share/doc/kernel-package</file>.</p> |
in <file>/usr/share/doc/kernel-package</file>.</p> |
| 973 |
|
|
|
</sect2> |
|
| 974 |
</sect1> |
</sect1> |
| 975 |
</sect> |
</sect> |
| 976 |
|
|
| 1583 |
</appendix> |
</appendix> |
| 1584 |
]]> |
]]> |
| 1585 |
|
|
| 1586 |
|
<appendix id="old-stuff"> |
| 1587 |
|
<heading>Managing your &oldreleasename; system</heading> |
| 1588 |
|
|
| 1589 |
|
<p>This appendix contains information on how to make sure you can install |
| 1590 |
|
or upgrade &oldreleasename; packages before you upgrade to &releasename;. |
| 1591 |
|
This should only be necessary in specific situations.</p> |
| 1592 |
|
|
| 1593 |
|
<sect id="old-upgrade"> |
| 1594 |
|
<heading>Upgrading your &oldreleasename; system</heading> |
| 1595 |
|
|
| 1596 |
|
<p>Basically this is no different than any other upgrade of |
| 1597 |
|
&oldreleasename; you've been doing. The only difference is that you |
| 1598 |
|
first need to make sure your package list still contains |
| 1599 |
|
&oldreleasename; packages as explained in <ref id="old-sources">.</p> |
| 1600 |
|
|
| 1601 |
|
</sect> |
| 1602 |
|
|
| 1603 |
|
<![ %has-woody-aptitude [ |
| 1604 |
|
<sect id="old-aptitude"> |
| 1605 |
|
<heading>Installing &oldreleasename; version of aptitude</heading> |
| 1606 |
|
|
| 1607 |
|
<p>First you need to make sure you will install &oldreleasename;'s |
| 1608 |
|
version of <package/aptitude/ and not &releasename;'s by following |
| 1609 |
|
the instructions in <ref id="old-sources">.</p> |
| 1610 |
|
|
| 1611 |
|
<p>After that, just execute |
| 1612 |
|
|
| 1613 |
|
<example> |
| 1614 |
|
# apt-get install aptitude |
| 1615 |
|
</example> |
| 1616 |
|
|
| 1617 |
|
to install <package/aptitude/.</p> |
| 1618 |
|
|
| 1619 |
|
</sect> |
| 1620 |
|
]]> |
| 1621 |
|
|
| 1622 |
|
<sect id="old-sources"> |
| 1623 |
|
<heading>Checking your sources list</heading> |
| 1624 |
|
|
| 1625 |
|
<p>If any of the lines in your <file>/etc/apt/sources.list</file> |
| 1626 |
|
refer to 'stable', you are effectively already "using" &releasename;. |
| 1627 |
|
If you have already run <tt>apt-get update</tt>, you can still get |
| 1628 |
|
back without problems following the procedure below.</p> |
| 1629 |
|
|
| 1630 |
|
<p>If you have also already installed packages from &releasename;, |
| 1631 |
|
there probably is not much point in installing packages from |
| 1632 |
|
&oldreleasename; anymore. In that case you will have to decide for |
| 1633 |
|
yourself whether you want to continue or not. It is possible to |
| 1634 |
|
downgrade packages, but that is not covered here.</p> |
| 1635 |
|
|
| 1636 |
|
<p>Open the file <file>/etc/apt/sources.list</file> with your favorite |
| 1637 |
|
editor (as root) and check all lines beginning with <tt>deb http:</tt> |
| 1638 |
|
or <tt>deb ftp:</tt> for a reference to "<tt/stable/". If you find any, |
| 1639 |
|
change <tt/stable/ to <tt/&oldreleasename;/.</p> |
| 1640 |
|
|
| 1641 |
|
<p>If you have any lines starting with <tt>deb file:</tt>, you will |
| 1642 |
|
have to check for yourself if the location they refer to contains |
| 1643 |
|
a &oldreleasename; or a &releasename; archive.</p> |
| 1644 |
|
|
| 1645 |
|
<p><strong/Important!/ Do not change any lines that begin with |
| 1646 |
|
<tt>deb cdrom:</tt>. Doing so would invalidate the line and you would |
| 1647 |
|
have to run apt-cdrom again. Do not be alarmed if a 'cdrom' source |
| 1648 |
|
line refers to "<tt/unstable/". Although confusing, this is normal.</p> |
| 1649 |
|
|
| 1650 |
|
<p>If you've made any changes, safe the file and execute |
| 1651 |
|
|
| 1652 |
|
<example> |
| 1653 |
|
# apt-get update |
| 1654 |
|
</example> |
| 1655 |
|
|
| 1656 |
|
to refresh the package list.</p> |
| 1657 |
|
|
| 1658 |
|
</sect> |
| 1659 |
|
|
| 1660 |
|
</appendix> |
| 1661 |
|
|
| 1662 |
</book> |
</book> |
| 1663 |
</debiandoc> |
</debiandoc> |
| 1664 |
|
|