Tracking the status of an app

After an app is distributed, you can track the installation status for the app in the App Distribution & Installation Details page.

To access the App Distribution & Installation Details page, follow these steps:
  1. From the MaaS360® Portal Home page, select Apps > Catalog.
  2. Find the app that you want to track, and then click MoreApp Distribution & Installation Details. The App Distribution & Installation Details page is displayed.

App installation lifecycle

The following flowchart depicts the app installation status at various stages in the app installation lifecycle:
App Status

App update lifecycle

The following flowchart depicts the app update status at various stages in the app update lifecycle:
App update status

App installation status and states

iOS apps

In addition to installation status, MaaS360 displays granular installation states against each status for iOS apps. The app distribution status combined with the granular stages allow you to track the installation progress and also troubleshoot issues during app deployments.

The following table displays the iOS app installation states that are available against each status:
Status State Description
Pending Install Command Scheduled MaaS360 is ready to push the app and is waiting for the device to communicate with MaaS360.
Licensed Installation Scheduled MaaS360 has acquired the VPP licenses to install the app on the device and is ready to push the app, but the device did not communicate with MaaS360 yet.
Not Relevant OS Criteria The device does not satisfy the minimum operating system criteria specified by the app.
Device Criteria App installation did not complete due to one of the following conditions:
  • A non-licensed App Store app is distributed to a shared device.
  • A device-licensed app is distributed to a user-enrolled device.
  • A user-licensed app is distributed to the a device that does not have a user assigned to it.
Installing Scheduled for installation. Waiting for redemption code App installation is scheduled, but the app (in case of paid iOS app) is waiting for a Volume Purchasing Program (VPP) redemption code that is required to purchase the app.
Redeeming the redemption code The device is redeeming the redemption code.
Prompted user for installation The user is prompted to install the app.
Prompted user for app store login The user is prompted to provide their App Store login credentials.
App is being installed The app is installing on the device.
Validating app purchase The app purchase is validating.
Installed App is installed The app is successfully installed on the device.
Prompted user for management of installed app The user is prompted to change the installed app to a managed app.
User installed the app before managed app installation The user installed the app before installing a managed app.
User rejected management of installed app The user rejected managing an app that is already installed.
Removed After Installation App is uninstalled The user removed the managed app. When the app is reinstalled, the app is automatically installed as a managed app.
Pending Update Prompted user for app update The user is prompted to update the app.
Prompted user for app store login for update The user is prompted to provide their App Store credentials for an update.
Updating Updating the app The app is updating.
Validating the update The app update is validating.
?? Unknown app state The app state is unknown.
Failed User rejected app install The user rejected the offer to install the app.
App installation has failed. The app installation failed.
Upgrade Failed User rejected app update The user rejected the offer to update the app.

Windows apps

MaaS360 displays granular states against the Failed status for Windows apps.

The following table displays the states that are supported for Windows devices:
Status State
Failed Failed download
Failed decryption
Failed checksum validation
Failed to launch installer
Installation failed
Relevance criteria not met