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:
- From the IBM® MaaS360® Portal home page, select .
- 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 update lifecycle
The following flowchart depicts the app update status at various stages in the app update
lifecycle.
App installation status and states
MaaS360 displays granular installation states against each status for iOS, Android, 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:
|
|
| 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. | |
| The 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 | The 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
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 |
Android
MaaS360 displays granular states against each status for Android MDM and Enterprise apps.
The following table displays the states that are supported for Android devices.
| Status | State | Description |
|---|---|---|
| Update Available | Pending Update | A new version of the app is available for update but not yet installed. |
| Installing | Installing | The app installation is in progress. |
| Pending Upgrade | Pending Update | The app update is identified and queued for installation. |
| Update Failed | Failed | The app update failed due to an error. |
| Updating | Installing | The app is currently being updated to a newer version. |
| Pending Install | Pending Install | The app installation is pending user or system action. |
| Downloading | Installing | The app download is in progress. |
| Distributed | Pending Install | The app distribution that is initiated but installation has not yet started. |
| Scheduled | Pending Install | The app installation or update is scheduled to run later. |
| Installed | Success | The app is installed successfully on the device. |
| Removed after installation | Removed after installation | The app was removed after being installed (manually by user or by MDM). |
| Not Relevant | Not Relevant | The app is not applicable for the device or user or County context. |
| Success | Success | The app is successfully installed or updated. |
| User Rejected Installation | Failed | The app installation failed because the user rejected or canceled the process. |
| In Progress | Installing | The app installation or update is in progress. |
| Failed | Failed | The app installation or update failed for an unspecified reason. |
| Waiting | Installing | The app installation is waiting for resources or network availability. |
| Cancelled | Failed | The app installation or update was canceled by user or system. |
The following table displays the states that are supported for Android Enterprise devices
| Status | State | Description |
|---|---|---|
| Not Installed | Pending Install | The app is not installed and pending user or system action to install. |
| Installed | Success | The app is already installed successfully on the device. |
| Higher version installed | Success | A newer version of the app is already present on the device. |
| Update Pending | Pending Update | An update is identified but not yet started. |
| Downloading | Installing | The app download is currently in progress. |
| Waiting for Network | Pending Install | The app installation is waiting for network availability. |
| Download Waiting | Pending Install | The app download is queued but not started. |
| User Action pending | Pending Install | The user action is required (for example, confirmation, permissions) to continue. |
| Scheduled Download | Pending Install | The app download is scheduled by MDM or policy but not triggered yet. |
| Schdeuled Update | Pending Update | the app update is scheduled to be installed later. |
| Installation Failed Not Compatible | Failed | The app installation failed due to device incompatibility. |
| Installation Failed OEM API Failed | Failed | The app installation failed due to OEM API or system error. |
| Installation Failed Other | Failed | the app installation failed for an unspecified reason. |
| Uninstalled by user | Removed after Installation | The app was removed manually by the user. |
| Uninstalled by MDM | Removed after Installation | The app was uninstalled remotely by MDM policy. |
| Device OOC | Removed after Installation | Installation failed as the device is out of compliance (OOC). |
| Device Selective Wiped | Removed after Installation | The app is removed due to selective wipe action. |
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.