Troubleshooting qdec (and other Freesurfer GUIs) on Mac Snow Leopard

Install XQuartz

If you are trying to run qdec and getting the following error:

dyld: Library not loaded: /opt/X11/lib/libGLU.1.dylib
  Referenced from: /Applications/freesurfer/bin/qdec.bin
  Reason: image not found
Trace/BPT trap

then install XQuartz (http://xquartz.macosforge.org/landing/) and reboot your system.


Remove XQuartz and reinstall

If you are trying to run qdec and getting the following error:

Bus error

then you encountered an oft encountered problem when installing XQuartz on top of the existing X11. To solve this you will have to completely remove XQuartz and reinstall. This is done as follows:

sudo rm -rf /System/Library/Launch*/org.x.* 
sudo rm -rf /Applications/Utilities/XQuartz.app
sudo rm -rf /opt/X11
sudo rm /usr/X11
sudo rm /usr/X11R6

Then reinstall XQuartz and reboot the system. At this point, if you try to open qdec (or another Freesurfer GUI) and the terminal just hangs, you will need to goto Applications->Utilities and open XQuartz. If it doesnt work, then you might have to logout then login again. XQuartz can be a finicky install, requiring one or more reboot and logout/logins, but once the GUI opens, it should no longer be a problem.


Incompatible Graphics Card

If you are trying to run qdec and getting the following error:

X Error of failed request:  GLXBadContext
  Major opcode of failed request:  0 ()
  Serial number of failed request:  1171
  Current serial number in output stream:  1171

Than you have a system with graphics card that is incompatible with qdec and so you will have to use another system or get a more power graphics card in order to run qdec.


Contact zkaufman@nmr.mgh.harvard.edu if you have additional questions.