Read log files in Apple School Manager
Apple School Manager maintains a log of all activities you perform. These log files are an important source of troubleshooting in case an activity fails to complete successfully. If an activity fails to complete, review the log file, locate and correct the error, and then attempt the activity again.
Activity | Log file message |
|---|---|
Create sign-in information. | Generate a CSV or PDF file or send an email with sign-in information. |
Create verification codes. | Generate a CSV or PDF file or send an email with a verification code. |
Set password policy. | Change students’ password policy. |
Assign a role to a location. | Add a role and location to an account. |
Edit a Managed Apple Account. | Edit an account’s Managed Apple Account. |
Disconnect from your source. | Disconnect from your Student Information System (SIS) or your Secure File Transfer Protocol (SFTP) uploads, and save all accounts and classes locally in Apple School Manager. |
Delete an account. | Delete an account. |
Deactivate an account. | Deactivate an account. |
Reactivate an account. | Reactivate an account. |
Add students to classes. | Add a student or students to specific classes. |
Delete classes. | Delete classes. |
Change class location. | Change the location of a class. |
Sync activity. | Automatically sync records. |
Assign devices. | Assign the selected devices. |
Reassign and delete server. | Reassign and delete the selected mobile device management (MDM) server. |
Unassign devices. | Unassign the selected devices. |
Unassign and delete server. | Unassign and delete the selected mobile device management (MDM) server. |
Release devices. | Release the selected devices. |
Enable Improving Schoolwork. | Allow Apple to process students’ and instructors’ Schoolwork usage data in a way that is not personally identifiable using techniques such as machine learning to improve Schoolwork. |
Disable Improving Schoolwork. | Do not allow Apple to process students’ and instructors’ Schoolwork usage data in a way that is not personally identifiable using techniques such as machine learning to improve Schoolwork. |
Read a log file
In Apple School Manager
, sign in with a user that has the role that can read log files.Select Activity
in the sidebar.In the list that opens, search for the category and event you want and then select it. See How to search.
Select Download Logs, locate the file in the folder used by your web browser to download files, then open the file and locate the error.
Log errors
In Apple School Manager, you can read log files to learn what has been completed and to spot errors. If an activity completes successfully, Apple School Manager generates the log message UPDATED. If an activity fails to complete, the log file generates messages to help you understand how to correct the error. Below are the log messages, along with their classification, description and associated activity. Search for these messages in the log file when an activity fails.
Log Message | Classification | Description | Associated activity |
|---|---|---|---|
NOT_ENOUGH _PRIVILEGE | WARNING | No privilege | Create sign-in information. Create verification codes. Set password policy. Assign a role and location to an account. Delete an account. Deactivate an account. Reactivate an account. Add students to classes. Delete classes. Change class location. Edit a Managed Apple Account. |
OPERATION_NOT _ALLOWED | WARNING | Active account | Delete an account. Reactivate an account. |
OPERATION_NOT _ALLOWED | WARNING | New and synced account | Delete an account. |
OPERATION_NOT _ALLOWED | WARNING | Inactive account | Create sign-in information. Create verification codes. Set password policy. Assign a role to a location. |
NOT_FOUND | WARNING | Deleted or claimed account | Create sign-in information. Create verification codes. Set password policy. Assign a role to a location. Delete an account. Deactivate an account. Reactivate an account. |
NO_EMAIL | WARNING | No email on file | Create sign-in information. Create verification codes. |
EMAIL_UNAVAILABLE _AS_MAID | WARNING | Email unavailable as Managed Apple Account | Roster sync. |
USERNAME_CONFLICT _WITH_EXISTING _APPLE_ID_ISSUE | WARNING | An Apple Account is already in use | Email unavailable as Managed Apple Account. |
INTERNAL_ERROR | ERROR | Server error | Create sign-in information. Create verification codes. |
OPERATION_NOT _ALLOWED_BY _VPP | ERROR | Licences associated with account | Delete an account. |
NOT_ENOUGH _PRIVILEGE | WARNING | Not a user | Create sign-in information. Create verification codes. Set password policy. |
OPERATION_NOT _ALLOWED | WARNING | Password policy synced | Set password policy. |
NOT_ENOUGH _PRIVILEGE | WARNING | Deactivating self | Deactivate an account. |
OPERATION_NOT _ALLOWED | WARNING | New manual account | Deactivate an account. |
APPROVE_ADMIN _REQUEST_AND _CREATE_REPORT | COMPLETED _WITH_SUCCESS | Onboarding | Approving request, downloadable credentials. |
APPROVE_ADMIN _REQUEST_AND _EMAIL | COMPLETED _WITH_FAILURE | Onboarding | Approving request, emailing credentials. |
DENY_ADMIN _REQUEST | COMPLETED _WITH_ERROR | Onboarding | Denying request. |
ANALYTICS _PERSON_OPT _OUT | COMPLETED _WITH_SUCCESS | Improving Schoolwork | Opt out of Improving Schoolwork for individual. |
ANALYTICS _PERSON_OPT _IN | COMPLETED _WITH_SUCCESS | Improving Schoolwork | Opt in to Improving Schoolwork for individual. |
NOT_FOUND | WARNING | Class deleted | Add student to classes. |
OPERATION_NOT _ALLOWED | WARNING | Class synced | Add student to classes. Delete classes. Change class location. |
INTERNAL_ERROR INVALID_INPUT | OPERATION_NOT _ALLOWED | Assign devices | Assign the selected devices. Device in released state. MDM server does not exist. |
INTERNAL_ERROR INVALID_INPUT | OPERATION_NOT _ALLOWED | Reassign and delete server | Reassign and delete the selected MDM server. |
INTERNAL_ERROR INVALID_INPUT | OPERATION_NOT _ALLOWED | Unassign devices | Unassign the selected devices. Device in released state. MDM server does not exist. |
INTERNAL_ERROR INVALID_INPUT | OPERATION_NOT _ALLOWED | Unassign and delete server | Unassign and delete the selected mobile device management (MDM) server. |
INTERNAL_ERROR INVALID_INPUT | OPERATION_NOT _ALLOWED | Release devices | Release the selected devices. Device in released state. MDM server does not exist. |
FIRST_NAME _EMPTY LAST_NAME _EMPTY EMAIL_ EMPTY | INTERNAL_ERROR OPERATION_NOT _ALLOWED SYNC_SCIM _ACCOUNTS | Sync SCIM accounts | Sync accounts from Microsoft Entra ID or your identity provider (IdP) using SCIM. |