/[ddp]/manuals/trunk/release-notes/en/release-notes.en.sgml
ViewVC logotype

Diff of /manuals/trunk/release-notes/en/release-notes.en.sgml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 3222 by fjp, Thu May 26 12:15:07 2005 UTC revision 3223 by fjp, Fri May 27 00:04:26 2005 UTC
# Line 1  Line 1 
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
# Line 13  Line 13 
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>
# Line 325  release: architectures: Line 325  release: architectures:
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)
# Line 339  release: architectures: Line 339  release: architectures:
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 &gt; ~/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 &lt;package name&gt;
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 &gt; ~/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 &lt; ~/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 [
# Line 422  apt-get install aptitude Line 530  apt-get install aptitude
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
# Line 436  apt-get install aptitude Line 544  apt-get install aptitude
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 &gt; ~/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 &lt;package&gt;  
           </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    
# Line 512  aptitude hold | unhold &lt;package&gt; Line 562  aptitude hold | unhold &lt;package&gt;
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
# Line 529  aptitude hold | unhold &lt;package&gt; Line 589  aptitude hold | unhold &lt;package&gt;
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
# Line 539  aptitude hold | unhold &lt;package&gt; Line 596  aptitude hold | unhold &lt;package&gt;
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
# Line 579  deb &url-debian-mirror-eg; &releasename; Line 636  deb &url-debian-mirror-eg; &releasename;
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
# Line 598  deb file:/var/ftp/debian stable main con Line 655  deb file:/var/ftp/debian stable main con
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
# Line 625  deb file:/var/ftp/debian stable main con Line 680  deb file:/var/ftp/debian stable main con
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
# Line 642  apt-cdrom add Line 697  apt-cdrom add
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
# Line 668  mount -o remount,rw /<var>mountpoint</va Line 724  mount -o remount,rw /<var>mountpoint</va
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
# Line 729  aptitude -f --with-recommends dist-upgra Line 833  aptitude -f --with-recommends dist-upgra
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
# Line 743  E: Dynamic MMap ran out of room Line 849  E: Dynamic MMap ran out of room
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    
# Line 760  echo 'APT::Cache-Limit "12500000";' >> / Line 866  echo 'APT::Cache-Limit "12500000";' >> /
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>
# Line 794  dpkg --install <var>/path/to/packagename Line 904  dpkg --install <var>/path/to/packagename
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
# Line 808  dpkg --install <var>/path/to/packagename Line 921  dpkg --install <var>/path/to/packagename
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
# Line 833  dpkg --install <var>/path/to/packagename Line 946  dpkg --install <var>/path/to/packagename
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
# Line 859  apt-cache search ^kernel-image Line 971  apt-cache search ^kernel-image
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    
# Line 1472  deb &url-kernel-upgrade; Line 1583  deb &url-kernel-upgrade;
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    

Legend:
Removed from v.3222  
changed lines
  Added in v.3223

  ViewVC Help
Powered by ViewVC 1.1.5