Files
fleet/tools/mdm/apple/troubleshooting.md
Noah TalermanandRachael Shaw 62c1033868 tools/ directory: Rename "queries" => "reports" and "teams" => "fleets" (#43575)
For the following issue:
- https://github.com/fleetdm/fleet/issues/41419


<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **Chores**
* Updated tooling and documentation wording across scripts, utilities,
and infrastructure files to reflect the product terminology change from
“teams” to “fleets” (references now note “fleets” and indicate the
former “teams” naming).
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: Rachael Shaw <r@rachael.wtf>
2026-05-07 10:42:39 -05:00

1.1 KiB

Troubleshooting

Enable MDM debug logging on the device

  1. Install the ./tools/mdm/apple/turn_on_debug_mdm_logging.mobileconfig profile on the device manually (by double-clicking such file) or using Fleet MDM via:
fleetctl apple-mdm enqueue-command InstallProfile --device-ids=<TARGET_DEVICE_ID> --mobileconfig ./tools/mdm/apple/turn_on_debug_mdm_logging.mobileconfig
  1. Check the profile was successfully installed in "System Preferences" -> "Profiles".

  2. Then on the device run the following command:

log stream --info --debug --predicate 'processImagePath contains "mdmclient"' | tee mdm_logs.txt

Checking and redelivering MDM enrollment profile

To check if a host has the correct MDM enrollment profile installed, run the following command on the host:

sudo profiles show -type configuration

To trigger a redelivery of enrollment profile, run the following command on the host:

sudo profiles renew -type enrollment

If the host does not have the right enrollment profile, try transferring the host to another fleet, wait for 10 minutes, then transfer it back and wait another 10 minutes.