HCS Blog

Enable the Managed Client Debug Log for OS X

Launch Terminal.app

Type the following commands:

sudo defaults write /Library/Preferences/com.apple.MCXDebug debugOutput -2

sudo defaults write /Library/Preferences/com.apple.MCXDebug collateLogs 1

sudo touch /var/db/MDM_EnableDebug

* Log is written to: /Library/Logs/ManagedClient/ManagedClient.log

Re-enroll a Mac into the Device Enrollment Program (DEP) without erasing

Launch Terminal.app


Type the following commands:

sudo rm /var/db/.AppleSetupDone

sudo rm -rf /var/db/ConfigurationProfiles/

sudo rm /Library/Keychains/apsd.keychain


Restart the Mac and re-enroll via DEP

The Caching Service updates it's registration with Apple every 55 minutes, as registrations expire on Apple's side after 1 hour. This mechanism not only allows for a crashed Caching server to be removed from registry but also to track changes in the public IP.

Changing the Only cache content for local networks setting causes an immediately re-registration, removing the local network range from the registration payload when the setting is turned off.

On Stop
When the Caching Server stops it deregisters with lcdn-registration.apple.com allowing clients to download updates from Apple servers again.

The –perfmode option indicates whether or not the performance mode has been enabled, dedicating resources to binaries within the Server app:

serverinfo --perfmode

If the performance mode has not been enabled then the output will be as such:

Server performance mode is NOT enabled.
To enable performance mode, you can also use serverinfo. This is the only task that the command does that can make any changes to the system and as such is the only time you need to elevate privileges:

sudo serverinfo —setperfmode 1

Or set the boolean value back to 0 to disable.

sudo serverinfo —setperfmode 0

Command to Troubleshoot OS X Server

Location of executable: /Applications/Server.app/Contents/ServerRoot/usr/sbin