Upgrading Fink for Mac OS X 10.2
Apple introduced major changes in Mac OS X 10.2, and Fink installations need to be upgraded with care in order to cope with these changes. If you have upgraded to Mac OS X 10.2 on a machine with a pre-existing Fink installation, then this document will provide step-by-step instructions for upgrading Fink. The instructions in this document are current as of 6 December 2002.
If you want to install a fresh copy of Fink on Mac OS X 10.2, then you should consult the Jaguar bootstrap guide instead of this document.
Here are the steps to follow for an upgrade.
- Step 1: Upgrade Mac OS X and install the OS X 10.2 Developer Tools.
Even if you have been using Fink's binary distribution, you will need to
install the Developer Tools, because the 10.2 Fink packages are not yet
available in binary form.
- Step 2: Obtain the files for the Fink upgrade.
Download the Fink 0.11.1 archive. Double click on the archive to expand it (Stuffit Expander or OpenUp both work), then open a terminal window and "cd" into the fink-0.11.1 directory. All subsequent commands will assume that you are in the fink-0.11.1 directory.
- Step 3: Verify the integrity of your Fink installation, and update
any external software which is related to Fink. If you have installed
XFree86 using the distribution from the XonX project, you need to get
a 10.2 upgrade from that project. Any other software which Fink learns
about via a system-foo package should also be checked for updates.
There have been reports that if you choose "Archive and Install" when upgrading to OS X 10.2, some parts of your Fink installation may be damaged. To help diagnose this, run the command
./dpkg-checkall.shfrom within the finkcvs/fink directory. You will get a report of any missing files from your Fink installation. In some cases these files are harmless, but in case of doubt about the package foo, you should either issue the command
fink reinstall fooor the command
fink remove fooYou can run dpkg-checkall.sh multiple times if needed.
- Step 4: Run the update script.
From within the fink-0.11.1 directory, issue the command
sudo ./update-fink.shYou will need an internet connection, and a bit of patience, as the update takes a while to complete.
- Step 4a (added November 13, 2002): Finish the update
by running the command
- Step 5: Update your XFree86 packages.
This is done with the command
fink update xfree86-base xfree86-rootlessIf you are not running XFree86, or if you installed it externally from the XonX project, you may skip this step.
- Step 6: Update your other fink packages.
The easy way to do this is with the command
fink update-allbut if you prefer to customize things you may issue individual fink update commands.
- Finally, when all of this has been completed, you may remove the fink-0.11.1 archive, directory, and its contents.
If you encounter problems with these instructions please consult the fink Help page which lists sources of finding assistance.