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. | Generates a .csv or PDF or send a mail message with sign-in information. |
Create verification codes. | Generates a .csv or PDF or send a mail message with a verification code. |
Set password policy. | Changes students’ password policy. |
Assign a role to a location. | Adds a role and location to an account. |
Edit a Managed Apple Account. | Edits an account’s Managed Apple Account. |
Disconnect from your source. | Disconnects 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. | Deletes an account. |
Deactivate an account. | Deactivates an account. |
Reactivate an account. | Reactivates an account. |
Add students to classes. | Adds a student or students to specific classes. |
Delete classes. | Deletes classes. |
Change class location. | Changes the location of the class. |
Sync activity. | Automatically syncs records. |
Assign devices to a device management service. | Assigns the selected devices to a device management service. |
Reassign and delete service. | Reassigns and deletes the selected device management service. |
Unassign devices from a device management service. | Unassigns the selected devices from a device management service. |
Unassign and delete service. | Unassigns and deletes the selected device management service. |
Release devices. | Releases the selected devices. |
Enable Improving Schoolwork. | Allows Apple to process students’ and instructors’ Schoolwork usage data in a nonpersonally identifiable way using techniques such as machine learning to improve Schoolwork. |
Disable Improving Schoolwork. | Doesn’t allow Apple to process students’ and instructors’ Schoolwork usage data in a nonpersonally identifiable way using techniques such as machine learning to improve Schoolwork. |
Read a log file
In Apple School Manager
, sign in with a user who has privileges to 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, then 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’s 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 and Description | Associated activity | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
NOT_ENOUGH_PRIVILEGE | Classification: WARNING Description: 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 | Classification: WARNING Description: Active account | Delete an account. Reactivate an account. | |||||||||
OPERATION_NOT_ALLOWED | Classification: WARNING Description: New and synced account | Delete an account. | |||||||||
OPERATION_NOT_ALLOWED | Classification: WARNING Description: Inactive account | Create sign-in information. Create verification codes. Set password policy. Assign a role to a location. | |||||||||
NOT_FOUND | Classification: WARNING Description: 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 | Classification: WARNING Description: No email on file | Create sign-in information. Create verification codes. | |||||||||
EMAIL_UNAVAILABLE_AS_MAID | Classification: WARNING Description: Email unavailable as Managed Apple Account | Roster sync. | |||||||||
USERNAME_CONFLICT_WITH _EXISTING_APPLE_ID_ISSUE | Classification: WARNING Description: An Apple Account is already in use | Email unavailable as Managed Apple Account. | |||||||||
INTERNAL_ERROR | Classification: ERROR Description: Server error | Create sign-in information. Create verification codes. | |||||||||
OPERATION_NOT_ALLOWED _BY_VPP | Classification: ERROR Description: Licenses associated with account | Delete an account. | |||||||||
NOT_ENOUGH_PRIVILEGE | Classification: WARNING Description: Not a user | Create sign-in information. Create verification codes. Set password policy. | |||||||||
OPERATION_NOT_ALLOWED | Classification: WARNING Description: Password policy synced | Set password policy. | |||||||||
NOT_ENOUGH_PRIVILEGE | Classification: WARNING Description: Deactivating self | Deactivate account. | |||||||||
OPERATION_NOT_ALLOWED | Classification: WARNING Description: New manual account | Deactivate an account. | |||||||||
APPROVE_ADMIN_REQUEST _AND_CREATE_REPORT | Classification: COMPLETED_WITH_SUCCESS Description: Onboarding | Approving request, downloadable credentials. | |||||||||
APPROVE_ADMIN_REQUEST _AND_EMAIL | Classification: COMPLETED_WITH_FAILURE Description: Onboarding | Approving request, emailing credentials. | |||||||||
DENY_ADMIN_REQUEST | Classification: COMPLETED_WITH_ERROR Description: Onboarding | Denying request. | |||||||||
ANALYTICS_PERSON_OPT_OUT | Classification: COMPLETED_WITH_SUCCESS Description: Improving Schoolwork | Opt out of Improving Schoolwork for individual. | |||||||||
ANALYTICS_PERSON_OPT_IN | Classification: COMPLETED_WITH_SUCCESS Description: Improving Schoolwork | Opt into Improving Schoolwork for individual. | |||||||||
NOT_FOUND | Classification: WARNING Description: Class deleted | Add student to classes. | |||||||||
OPERATION_NOT_ALLOWED | Classification: WARNING Description: Class synced | Add student to classes. Delete classes. Change class location. | |||||||||
INTERNAL_ERROR INVALID_INPUT UPDATED_WITH_NO_ENROLLMENT_DEADLINE | Classification: OPERATION_NOT_ALLOWED Description: Assign devices to a device management service | Assigns the selected devices. Device in released state. Device management service doesn’t exist. | |||||||||
INTERNAL_ERROR INVALID_INPUT | Classification: OPERATION_NOT_ALLOWED Description: Reassign and delete service | Reassign and delete the selected device management service. | |||||||||
INTERNAL_ERROR INVALID_INPUT | Classification: OPERATION_NOT_ALLOWED Description: Unassign devices from a device management service | Unassign the selected devices. Device in released state. Device management service doesn’t exist. | |||||||||
INTERNAL_ERROR INVALID_INPUT | Classification: OPERATION_NOT_ALLOWED Description: Unassign and delete service | Unassign and delete the selected device management service. | |||||||||
INTERNAL_ERROR INVALID_INPUT | Classification: OPERATION_NOT_ALLOWED Description: Release devices | Release the selected devices. Device in released state. Device management service doesn’t exist. | |||||||||
FIRST_NAME_EMPTY LAST_NAME_EMPTY EMAIL_EMPTY | Classifications: INTERNAL_ERROR OPERATION_NOT_ALLOWED SYNC_SCIM_ACCOUNTS Description: Sync SCIM accounts | Sync accounts from your identity provider (IdP) using SCIM. | |||||||||