Tracking the status of an app

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

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

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

MaaS360 displays granular installation states against each status for iOS and Windows apps.

iOS apps

The app distribution status with the granular stages helps 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 acquired the Volume Purchasing Program (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 criteria of the minimum operating system as specified in 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 device that does not have an assigned user to it.
Installing Scheduled for installation. Waiting for redemption code App installation is scheduled, but the app (if paid iOS app) is waiting for the 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 The 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 an 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 start installer
Installation failed
Relevance criteria not met
Note: The following two columns are added to the App Distribution & Installation Details screen.
  • The column Version installed displays the installed version of the app on the device.
  • The column Pending update version displays the latest version of the app on the portal for which that device can update.