Troubleshooting Enterprise App Installation Errors on macOS devices

1. “Keychain Not Found” prompt appears on Mac when the admin pushes a .pkg file as an enterprise app through Hexnode.

Description: When the admin tries to install the enterprise app as .pkg file, a “Keychain Not Found” prompt is displayed on the user’s device. The app installation resumes soon after the user dismisses the prompt.

Solution: The app installation may expect some configuration settings to be deployed with the package installer, which causes this prompt to appear. For instance, some packages might contain pre-installation scripts that execute additional actions at the time of installation, resulting in an error. Check if you can obtain an app version that can be installed without any interventions.

2. DMG file contains Software License Agreement.

Description: When the admin tries to install the enterprise app, the installation fails with the error, “DMG file contains Software License Agreement”.

Solution: Some apps require user interaction, such as agreeing to the Software License Agreement while installing them. Such apps cannot be deployed through Hexnode. Try to upload the file meant for IT admins that do not have the License Agreement.

3. DMG file is encrypted.

Description: When the admin tries to install the enterprise app, the installation fails with the error, “DMG file is encrypted ”.

Solution: Hexnode only supports .dmg files that are not encrypted. Try to upload the decrypted version of the file through Hexnode.

4. App upload failed since the distribution root file is missing in the .pkg file.

Or

App upload failed since the package info root file is missing in the .pkg file.

Description: When the admin tries to upload the .pkg file of the app, it fails with the error, “App upload failed since distribution root file is missing in the .pkg file.” or “App upload failed since package info root file is missing in the .pkg file.”

Solution: Hexnode validates each package that is uploaded to the portal. The validation fails if the distribution root file or package info root file is missing. Upload the package that has the necessary files.

5. Only gzip/zlib/bzip2 decompression supported.

Description: When the admin tries to upload the .pkg file of the app, the app upload fails in the Hexnode portal with the error, “Only gzip/zlib/bzip2 decompression supported.”

Solution: .pkg files are often compressed to become compact. Hexnode decompresses the .pkg files that the admin uploads and supports only the decompression of files compressed using gzip, zlib, or bzip2. Files that are compressed using other techniques cannot be uploaded to Hexnode. So, make sure that the .pkg file is compressed using the prescribed techniques.