Category filter
Troubleshoot MSI app installation errors
Hexnode UEM provides the option to install enterprise apps as a .msi file onto a Windows device. But sometimes the installation process may fail due to various reasons. This document provides insight into how to troubleshoot MSI app installation errors that occur commonly.
1. MSI app installation failed with an error message “Missing Agent app”
Description:
The error message indicates that the Hexnode Agent app is missing on the device.
Probable cause:
The Hexnode Agent app failed to get installed on the device during the enrollment process.
Possible solution:
You will need to re-enroll the device using the Hexnode Installer to install the Hexnode Agent app. As you enroll the device, be sure it is linked to a reliable internet connection. The most recent Hexnode Agent app will be downloaded and installed on your device after a successful enrollment.
2. Error 1722. “There is a problem with this Windows Installer package. A program run as part of the setup did not finish as expected.”
Description:
Windows Installer package is the Windows service that takes care of app installations on a Windows device. The error message indicates that there is a problem with the Windows Installer package while it tries to install the .msi file.
Probable cause:
The Windows Installer package might be disabled under Windows Services.
Possible solution:
Certain settings not properly configured on the Windows Installer package can lead to the failure of the installation of apps. Follow these steps on the device to troubleshoot this issue:
- On the Windows device, press Windows key + R to open the Run Dialog.
- Type services.msc in the Run Dialog, and then press Enter to open Services.
- Right-click the Windows Installer service, and then click Properties.
- If the Startup type box is set to Disabled, change it to Manual.
- Click OK to close the Properties window.
An alternate solution is to try to unregister and re-register the Windows Installer. Follow these steps on the device to do the same:
- Press the Windows key + R to open the Run command dialog box.
- Type CMD and press Enter.
- Type,
msiexec /unregin the Command Prompt and click Enter to temporarily unregister the Windows Installer. - Then, type
msiexec /regserverand click Enter to re-register Windows Installer. - Restart the device for the changes to take effect.
3. Error 1603. “When you try to install a Windows Installer package: A fatal error occurred during installation.”
Description:
Error code 1603 indicates that an error occurred during the installation of a .msi file.
Probable cause:
This error code can occur if an older/present version of the app is already present on the device.
Solution:
Check if there is an older/present version of the app is present on the device and uninstall it. Then try reinstalling the app from the Hexnode portal.
4. Error 1618. “Another installation is already under progress.”
This error occurs when multiple installations are initiated at once. The Windows Installer package is responsible for the installation of apps and it only executes the installation of one app at a time. The other installation processes will be on ‘pending’ status and will later be executed.
5. Error 2715/2716/2717. Corrupted custom action scripts during installation.
Probable cause:
These errors can occur when the custom action script in the .msi file has been modified, deleted, or corrupted.
Solution:
Try downloading the .msi file once again from the website concerned or contact the issuer of the .msi file.
6. MSI app installation failed with an error message “The provided log path is invalid. Please provide a valid log path.”
Description:
This error message that occurred as a result of the installation action for an MSI app indicates that the custom path specified for the output log file of the .msi file was invalid.
Probable cause:
This error may occur if:
- The drive specified in the log path doesn’t exist on the device.
- Admin enters invalid data in the input field.
Solution:
Configure the installation settings of the .msi file with a valid log path when installing the app via Policy or Actions.
7. MSI app installation failed with an error message “The SHA-256 checksum of the file must be specified to install this application.”
Description:
This error occurs when trying to install an enterprise app without providing the SHA-256 Checksum.
Probable cause:
This issue arises if you attempt to install an enterprise app, added to the Hexnode app inventory via From Manifest URL without providing the SHA-256 Checksum, on a device without the Hexnode agent app installed.
Solution:
When adding an enterprise application to the Hexnode app inventory using the From Manifest URL method, the SHA-256 Checksum becomes a mandatory requirement when deploying the application to devices that do not have the Hexnode agent app installed.
Hexnode uses the SHA-256 Checksum to ensure that the apps are not corrupted during the upload to the portal and deployment to devices. This checksum verifies the integrity and authenticity of the application during the installation process.
To resolve the issue,
- either re-add the application to the Hexnode app inventory via the From Manifest URL method, this time ensuring the inclusion of the required SHA-256 Checksum.
- or, you can install the Hexnode agent app. This can be initiated by clicking the refresh button next to the Hexnode Service (Agent) App status in the Enrollment Details section of the Device Summary for the specific Windows device from the Hexnode UEM console.
Once this is done, you can proceed to deploy the application using the ‘Install Application‘ action or through the ‘Required Apps‘ policy.
