Note:
Error reasons are formatted differently depending on if you view them via the Jamf Pro API or the Jamf Pro interface.
If the software update plan encounters an error, error reasons are provided. You may see multiple error reasons in a single plan. Generally, Jamf recommends resetting managed software updates and redeploying the update as the first troubleshooting step. Depending on the error, you may need to take additional action. The following list defines each potential error reason:
- APPLE_SILICON_NO_ESCROW_KEY
- The computer has an M series chip and requires the bootstrap token to be escrowed for a fully autonomous software update.
- NOT_SUPERVISED
- The device is not currently supervised, which causes MDM commands to fail.
- NOT_MANAGED
- The device is not currently managed, which causes MDM commands to fail.
- NO_DISK_SPACE
- The latest inventory data from the computer or mobile device indicates that the computer or mobile device's storage is full.
- NO_UPDATES_AVAILABLE
- Remote operating system data indicates that there are currently no updates for the current operating system on the computer or mobile device.
- SPECIFIC_VERSION_UNAVAILABLE
- The requested specific version does not exist on Apple's servers.
- ACTION_NOT_SUPPORTED_FOR_DEVICE_TYPE
- The requested action is not supported for mobile devices.
- PLAN_NOT_FOUND
- The plan could not continue processing because the plan was manually removed from the database.
- APPLE_SOFTWARE_LOOKUP_SERVICE_ERROR
- Apple's available update servers are offline and the Jamf Pro server does not currently have the last response cached in memory (e.g., server restart).
- EXISTING_PLAN_FOR_DEVICE_IN_PROGRESS
- A plan was sent to a computer or mobile device that already has a plan in progress.
- DECLARATIVE_DEVICE_MANAGEMENT_SOFTWARE_UPDATES_NOT_SUPPORTED_FOR_DEVICE_OS_VERSION
- Download, install, and schedule actions are only supported for macOS 14 or later, iOS 17 or later, iPadOS 17 or later, and tvOS 17 or later.
- DOWNGRADE_NOT_SUPPORTED
- Apple does not support downgrading operating systems through MDM or declarative device management, and the selected specific version indicates an attempt at lowering the operating system version.
- DECLARATIVE_SERVICE_ERROR
- Communication with the server encountered an error and the declarative device management update is not scheduled.
- UNABLE_TO_FIND_UPDATES_AND_OUT_OF_RETRIES
- If a computer or mobile device returns no available updates, Jamf Pro retries the request to collect these updates up to four times.
- DATA_INTEGRITY_VIOLATION_EXCEPTION
- A database integrity violation was detected and prevented to avoid corrupting the database.
- ILLEGAL_ARGUMENT_EXCEPTION
- An illegal argument was detected in a update status received from a device while a software update was running.
- MDM_EXCEPTION
- An unexpected error was encountered when queuing MDM commands for a plan.
- ACCEPT_PLAN_FAILURE
- An unexpected failure was encountered accepting a plan.
- SCHEDULE_PLAN_FAILURE
- An unexpected failure was encountered scheduling a plan.
- REJECT_PLAN_FAILURE
- An unexpected failure was encountered rejecting a plan.
- START_PLAN_FAILURE
- An unexpected failure was encountered starting a plan.
- QUEUE_SCHEDULED_OS_UPDATE_SCAN_FAILURE
- An unexpected failure was encountered queuing the ScheduleOsUpdateScan command.
- SCAN_WAIT_FINISHED_FAILURE
- An unexpected failure was encountered updating a plan to indicate the ScheduleOsUpdateScan command completed.
- QUEUE_AVAILABLE_OS_UPDATE_COMMAND_FAILURE
- An unexpected failure was encountered queuing the AvailableOsUpdates command.
- MDM_CLIENT_EXCEPTION
- An MDM client exception was encountered queuing the ScheduleOsUpdate command.
- QUEUE_SCHEDULE_OS_UPDATE_FAILURE
- An unexpected failure was encountered queuing the ScheduleOsUpdate command.
- QUEUE_OS_UPDATE_STATUS_COMMAND_FAILURE
- An unexpected failure was encountered queing the OsUpdateStatus command.
- STILL_IN_PROGRESS_FAILURE
- An unexpected failure was encountered determining the if the OsUpdateStatusResponse command is still in progress.
- WAIT_TO_COLLECT_OS_UPDATE_STATUS_FAILURE
- An error occurred while waiting to collect OS update statuses for an ongoing device update.
- IS_DOWNLOADED_AND_NEEDS_INSTALL_FAILURE
- An unexpected failure was encountered determining if the download has completed and if update needs to be installed.
- IS_INSTALLED_FAILURE
- An unexpected failure was encountered determining if an update has installed successfully.
- IS_DOWNLOAD_ONLY_AND_DOWNLOADED_FAILURE
- An unexpected failure was encountered determining if an update with a Download only command has completed.
- VERIFY_INSTALLATION_FAILURE
- An unexpected failure was encountered verifying installation of an update.
- IS_MAC_OS_UPDATE_FAILURE
- An unexpected failure was encountered attempting to determine if a plan is for a macOS update.
- IS_LATEST_FAILURE
- An unexpected failure was encountered starting a plan with a version type of LATEST_MAJOR, LATEST_MINOR or LATEST_ANY.
- IS_SPECIFIC_VERSION_FAILURE
- An unexpected failure was encountered starting a plan with a specific version type.
- HANDLE_COMMAND_QUEUE_FAILURE
- An unexpected failure was encountered attempting to queue one of the following commands:
AvailableOsUpdates
OsUpdateStatus
ScheduleOsUpdate
ScheduleOsUpdateScan
- SPECIFIC_VERSION_UNAVAILABLE_FOR_DEVICE_MODEL
- The specific version is listed as available for the device's OS type, but is not compatible with the device's model number.
- INVALID_CONFIGURATION_DECLARATION
- The device has responded with an invalid configuration declaration, causing the plan to fail.
- NO_DEVICE_STATUS_BY_GRACE_PERIOD
- No events were received from the device within the allowable grace period, which is set to 7 days by default.
- UNKNOWN
- Database corruption has occurred.