This article has been archived and is no longer updated by Apple.

Managed Client: How to flush cached settings

When changing binding information from one directory server to another, you should flush the Managed Client (MCX) cache as described in this article.

The preferred method to refresh the MCX cache is to use the Refresh Preferences feature. This can be found by logging in as an administrative user while holding the Option key, to display the Workgroup Picker. If the user has access to disable or refresh management, the "Refresh Preferences" button will be available.

Command line alternative

Mac OS X v10.6

Execute the following Terminal command:

dscl . -list Computers | grep -v "^localhost$" | while read computer_name ; do sudo dscl . -delete Computers/"$computer_name" ; done

Mac OS X v10.5

Execute the following Terminal command:

sudo dscl . -delete /Computers

Mac OS X v10.4

Execute the following Terminal command:

sudo /System/Library/CoreServices/mcxd.app/Contents/Resources/MCXCacher -f

Mac OS X v10.5, 10.6 note: Refreshing the preferences via the Workgroup Picker or the command above does not clear cached settings for mobile user accounts in Mac OS X v10.5 and later. To flush the managed settings for a mobile account:

sudo dscl . -delete /Users/mobileaccountname MCXSettings sudo dscl . -delete /Users/mobileaccountname MCXFlags sudo dscl . -delete /Users/mobileaccountname cached_groups

Learn more

MCXCacher is not included with Mac OS X v10.5 and later. These versions cache for offline use, not performance. If the network server is available the cache is not used, only updated. You shouldn't have to flush the cache on a Mac OS X v10.5 or later system when the server is available.

You should not delete the localhost computer record in Mac OS X v10.6 as this can affect kerberized services.

Published Date: