Troubleshooting Windows app install error
Hexnode provides easy distribution and management of applications on Windows devices. However, sometimes the installation of applications pushed through the MDM portal might fail on Windows devices. This can prove to be challenging for the users as well as admins. This documentation helps you identify the reasons for app install failure and fix them easily.
Reasons for app install failure
|EXE file not supported||File format not currently supported on Hexnode. Convert to MSI or APPX.|
|Installation overlap||The application is already installed on the device.|
|Version mismatch||The application is not compatible with the Windows version installed on the device.
|Missing Agent App||Hexnode Agent app must be installed on the device before distributing MSI apps.|
|App installation success in the portal but not visible on the device||The MSI package file is initially built specifying its installation directory to a user-specific location. If such apps are deployed via Hexnode, they will install on the system user (root user) account. Hence, the application installation status will be shown as ‘Success’ on the MDM console.
However, such apps will not install on other user accounts present on the device. Here, a ‘Scan Device’ action pushed to the device cannot detect the presence of such apps. So, these apps will not be listed on Manage > Devices > click on the required device to open the device details page > Applications.
|MSI (Enterprise) app installation stays in the “Pending” state when multiple MSI apps are pushed to a device simultaneously.||When multiple MSI apps are pushed to a device, the installation of the applications will only take place one after the other. This is because the Windows Installer allows only a single MSI file to be installed at a time. Hence, until the first MSI app gets installed in the device, the subsequent MSI apps will remain in the “Pending” state and will only get installed one by one.|
|Issue with Package signing||
Package signing issues can be broadly classified into the following:
You can try re-signing the package by considering the above-mentioned points and re-install the application.
|The Enterprise application was in use when the app update was initiated from the portal.||
When the user tried to update the application from the portal, the app was currently running on the device, and hence the app update failed.
You can close the Enterprise application and try re-initiating the action from the portal again.
|Not enough space in the disk||There is insufficient space in the device for the application to get installed. Once you clear some space by removing the unwanted applications/files from your device, you can try re-installing the application.|
|Network issues||If there is a network issue during the app installation, it might not get downloaded successfully and will result in installation failure. You can try connecting to a different network and re-initiate the install application action.|
|App package mismatch when an application is being updated||
The app update will fail if the app package being installed does not match with the installed package. It can arise due to the following reasons as well:
|Dependant files of the application are missing||When an application is pushed to a device, you need to make sure all the dependant files associated with the application are included. Missing dependant files can hamper app installation and updates.|