Debian Quick Reference
Chapter 2 - Upgrading a distribution to testing

2.1 Transition of APT to the Woody version

Network upgrade of the APT system and some core packages to the Woody versions can be done as follows after including stable sources in the /etc/apt/sources.list if you still run Potato.

     # apt-get update
     # apt-get install libc6 perl libdb2 debconf
     # apt-get install apt apt-utils dselect dpkg

2.2 Transition preparation (stable to testing)

Tracking the testing flavor of Debian has a side effect of providing very slow security fixes. So be warned.

Network upgrade to testing can be done as follows (run the script go-woody to do this in one command):

Empty the existing sources.list file:

     # cd /etc/apt
     # cp -f sources.list sources.old 
     # :>sources.list

Get a clean list of repositories, for stable:

     # cd /
     # apt-setup noprobe 
         ... select repositories, accessed with HTTP or FTP methods

Add the testing section to this new list. The deb-src lines are commented out.

     # cd /etc/apt
     # grep -e "^deb " sources.list  >sources.deb
     # grep -e "^deb-" sources.list  >sources.src
     # sed -e "s/stable/testing/"  sources.deb \
          >>sources.list
     # sed -e "s/stable/testing/" sources.src | \
          sed -e "s/^deb-/#deb-/"  >>sources.list
     
     # apt-get update
     # apt-get install apt apt-utils
     # cat >preferences <<EOF
      Package: *
      Pin: release a=testing
      Pin-Priority: 600
      
      Package: *
      Pin: release a=unstable
      Pin-Priority: 50
     
      EOF

Optionally, add the "unstable" section of the archives.

     # sed -e "s/stable/unstable/" sources.deb \
          >>sources.list
     # sed -e "s/stable/unstable/" sources.src | \
          sed -e "s/^deb-/#deb-/"  >>sources.list

See Basics of Debian package management, Section 3.2 for the art of tuning /etc/apt/sources.list and /etc/apt/preferences.

Now you can update and upgrade, using one of the methods in the next section.

2.3 Upgrade the Debian system

After properly setting up /etc/apt/sources.list and /etc/apt/preferences files, the system can be upgraded to testing. See Debian package management, Chapter 3 for the basics, and see APT upgrade troubleshooting, Section 3.3.2 if you encounter problems.

2.3.1 Best upgrade practice using dselect

If a system has many packages which include -dev packages, etc., the following method using dselect is recommended for fine-grained package control.

     # dselect update  # always do this before upgrade
     # dselect select  # select additional packages

All your current packages will be selected when dselect starts. dselect may prompt you with additional packages based on depends, suggests, and recommends. If you do not want to add any packages, just type Q to exit dselect again.

     # dselect install

You will have to answer some package configuration questions during this part of the process, so have your notes ready and allow some time for this part. See dselect, Section 3.2.3.

Use dselect. It always works :) If you need to upgrade without dselect after Woody, consider aptitude and other options.

Debian Quick Reference