Fink

User's Guide - 4. Upgrading Fink

This chapter covers the procedures used to update your Fink installation with the latest and greatest stuff.

4.1 Upgrading using Binary Packages

If you use the binary distribution exclusively, there is no separate upgrade procedure. Just ask the tool of your choice to get the latest package listing from the server and let it update all packages.

For dselect, it is sufficient to hit "[U]pdate", then "[I]nstall". Of course, you may want to run "[S]elect" in between to check the selections that were made and to find out about new packages.

For apt, run apt-get update to get the latest package list, then apt-get upgrade to update all packages that have new versions available.

For Fink Commander, select Binary->Update descriptions to update the package list, and then Binary->Dist-Upgrade packages to update to new versions.

For more information, see the Upgrade Matrix.

4.2 Upgrading the Source Distribution

If you use the source distribution the procedure consists of two steps. In the first step, you download the latest package descriptions to your computer. In the second step, these package descriptions are used to compile new packages; the actual source code is downloaded as needed.

The first step can be accomplished by running fink selfupdate. That command will check with the Fink website to see if a new point release is available, and will automatically download and install the package descriptions in that case. You also have the option to pull package descriptions directly from Git or via rsync. Git is a version-controlled repository where the package descriptions are stored and managed. Using Git has the advantage that it is updated continuously, but the disadvantage that there is a single Git server for Fink, and it can be unreliable if there is a lot of traffic. For this reason, it is recommended that general users go with rsync. There are multiple mirrors available for rsync, and the only disadvantage is that package descriptions take an hour or so to migrate to the rsync mirrors after they've been added to Git.

(If you are having trouble upgrading a source installation, consult these special instructions.)

Once you have updated your package descriptions (no matter which way), you should update all packages at once with the command fink update-all.

To update the source distribution using Fink Commander, select Source->Selfupdate to download new package information files, and then Source->Update-all to update your outdated packages.

4.3 Mixing Binaries and Source

If you use precompiled binary packages for some packages and build others from source, you'll have to follow both sets of instructions above to upgrade your Fink installation. That is, first use dselect or apt-get to get the latest versions of the packages that are available as binaries, then use fink selfupdate and fink update-all to get the current package descriptions and to update the remaining packages.

You may use the UseBinaryDist option (settable via the --use-binary-dist (or -b) option or in the Fink configuration file) both source and binary descriptions will be updated if you call fink selfupdate. In this case you don't need a separate apt-get call anymore.

If you are using Fink Commander select Binary->Update descriptions to update the package list, and then Binary->Dist-Upgrade packages to update to new versions. After that do Source->Selfupdate to download new package information files, and then Source->Update-all (see previous sections for details).

Next: 5. The Fink Configuration File