Fink RSS News Feeds: [These Headlines] [Package Updates]

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.sh
```
from 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 foo
```
or the command
```
  fink remove foo
```
You 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.sh
```
You 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
```
  sudo /sw/lib/fink/postinstall.pl
```
Step 5: Update your XFree86 packages. This is done with the command
```
  fink update xfree86-base xfree86-rootless
```
If 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-all
```
but 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.