If an iOS VPP application fails to install or returns licensing errors on managed devices, administrators can force a complete application and license reset within the Mobile Guardian Dashboard.
Prerequisites & Safety Considerations
⚠️ Device Lock Status Warning
If pending commands in the MDM command log display a "NOT NOW" status, the target device is currently locked or asleep. Do not reset licenses—the application will automatically resume installation as soon as the device is awakened and unlocked.
Troubleshooting Application & Licensing Failures
Locate Target Application:
- Log in to the Mobile Guardian Dashboard, click Applications in the left navigation panel, and locate the failing application using the search bar.
Document and Clear Tags:
- Click the Pencil (Edit) icon next to the application, open the Settings tab, and record all existing Auto Install and Self Install tags. Delete all assigned tags and click Save.
Confirm that no tags remain assigned under the application's Settings tab.
Note Down Current Tags
- Under the Settings tab, locate the Auto Install or Self Install tags associated with the application.
- Take a screenshot or save the tags for future reference.
Disassociate All VPP/App Licenses:
- Select the Licenses tab and click Disassociate All. Refresh the browser page and wait until all active licenses are completely cleared from the count before proceeding.
Ensure the active license count reads 0 assigned before moving to the next step.
Re-assign Tags & Save:
- Return to the Settings tab, re-add the exact tags recorded in Step 2, and click Save.
Force Fleet Sync & Re-Push:
- Navigate to the Devices tab and click Re-Push to All to force immediate profile and application synchronisation.
Check the device action log to confirm new application installation commands are queued.
Targeted Application Re-Deployment Options
If specific endpoints still fail to retrieve the application after completing the tag reset, use the manual push controls:
- Push to Missing: Pushes the installation command exclusively to endpoints missing the application payload. (Recommended for isolated failures).
- Push to All Devices: Overwrites existing installations and forces a complete application reinstall across all tagged assets.