Category filter
Common Issues in Android Enrollment
1. “Certificate error occurred”
Description
After entering the server name on the Hexnode app and clicking Next, a dialog window shows the message “Certificate error occurred”.
Probable Causes
- Case 1: Date and time are not set correctly on the device.
- Case 2: Incorrect server name was entered
- Case 3: Device is missing critical security updates
Solutions
Case 1: Make sure you’ve set the time and date on the device correctly. Then, you may restart the device to ensure the change is applied throughout the device. You may also reconfigure the date and time settings from the Settings app on the device by going to System > Date and time.
Case 2: Retry enrollment with the correct server name.
Case 3: It is recommended to keep your Android devices updated with the latest security patches. You can check and install updates by opening the Settings app and going to System > Advanced > System updates.
2. “Network error occurred”
Description
After entering the server name on the Hexnode app and clicking Next, a dialog window shows the message “Network error occurred”.
Probable Causes
- Device is not connected to the internet.
- Other network issues or connection timed out.
Solutions
- Check the device-end network connectivity.
- For authenticated enrollments, check if the connected domain service is up and operational.
3. “Unknown error occurred”
Description
After entering the server name on the Hexnode app and clicking Next, a dialog window shows the message “Unknown error occurred”.
Probable Cause
Incorrect server name or some advanced enrollment error.
Solution
Retry enrollment with the correct server name.
4. “Invalid server. Make sure you enter a valid portal name in the ‘server’ field”
Description
After entering the server name on the Hexnode app and clicking Next, a dialog window shows the message “Invalid server. Make sure you enter a valid portal name in the ‘server’ field”.
Probable Causes
- Case 1: Clicking Next without entering the server name.
- Case 2: Incorrect server name.
Solution
Retry enrollment with the correct server name.
5. “Trouble connecting to server”
Description
After entering the server name on the Hexnode app and clicking Next, a dialog window shows the message “Trouble connecting to server”.
Probable Cause
An attempt to establish a connection with the server got disrupted.
Solutions
- Check for network connectivity issues.
- Retry after some time.
6. “Device limit reached! Please contact your administrator!”
Description
This error appears while enrolling the device after granting the app permissions.
Probable Causes
- Case 1: You have reached the maximum number of devices you can enroll under your license.
- Case 2: Your license has expired.
Solutions
Case 1: Check the number of devices allowed to enroll as per your current plan. The total number of enrolled devices should not exceed the total device licenses in your subscription under Admin > License.
Case 2: Verify your license and subscription status on your portal under Admin > License.
7. “Your device is not authorized to be enrolled. Please contact the administrator to know more.”
Description
After entering the server name on the Hexnode app and clicking Next, a dialog window shows the message “Your device is not authorized to be enrolled. Please contact the administrator to know more”.
Probable Causes
- Enrollment settings in the portal restrict Android device enrollment.
- Enrollment settings in the portal restrict enrollment only to pre-enrolled devices.
Solutions
On your portal, navigate to Admin > Enrollment and make appropriate changes as follows –
- Under the Enrollment Restrictions section, Android should be checked to allow enrollment of Android devices.
- The option Pre-approved Device only should be unchecked if you are enrolling a new device.
8. Having trouble granting permissions.
Description
Unexpected behavior on attempting to grant device permissions like the toggle button is not working or selections are redirecting to unrelated settings page.
Probable Cause
This error has been observed in a few devices having vendor customized OS and might be resulted from the difference in the Settings app configurations.
Solution
Please grant the required permissions manually. The special permissions required by Hexnode are –
- Device administration
- Usage access
- Draw over apps
- Write systems settings
- Notification access
- Allow app installation
On Android 10, you can find these settings under the Special app access page under Apps & Notifications in Settings app. Grant permission for the Hexnode app from there by selecting and enabling each of the special access permissions.
9. “You are not authorized to enroll any devices with Hexnode MDM. Please contact your administrator if you have received an enrollment request.”
Description
This error shows up on submitting the credentials for authenticated enrollments.
Probable Causes
- Attempt to sync with the associated domain failed
- Self-enrollment is disabled for the domain
- Incorrect user credentials
Solution
Check and enable ‘Self Enrollment’ for the connected domain. You can check if enrollment is allowed for the particular domain by navigating to the Admin tab and selecting the sub-tab corresponding to your domain service provider (e.g., G Suite, Active Directory etc.). The domain must be listed in the following window. Click on the settings icon 
and select Enable Self-enroll.
10. Not able to grant notification access for Hexnode app
Description
Unexpected behaviour when trying to enable Notification access on the app permissions page of the Hexnode agent app during enrollment.
Toggling the option redirects us to the Device & app notifications page in the Settings app (Settings > Notifications > Privacy > Device & app notifications). Here, the ‘Allow notification access’ option must be enabled for the Hexnode app for notification access to be provided. But the option was found to be greyed out.
Probable Cause
This error occurs when the APK version of the Hexnode app is installed on Android devices running versions 13 and above. Android 13+ devices may have device settings restricted for apps when they are installed from unknown sources.
Solution
- Tap on the Hexnode app icon in the Device & app notifications page of the agent app to be taken to its App info page.
- On the App info page, Android provides an overflow icon at the top right, which, when clicked, gives you the ‘Allow restricted settings’ option. Allowing the option lets us enable the notification access option.
On certain Android devices, the ‘Allow restricted settings’ option may not be visible on the App info page. In such cases, the user should go back to the Device & app notifications page of the agent app and tap the greyed-out ‘Allow notification access’ setting. This results in the restricted setting dialog popping-up.
By clicking OK and reverting back to the App info page, the overflow icon with the ‘Allow restricted settings’ option will be visible, which the user can enable. Once the option is enabled, the user is allowed to set the ‘Allow notification access’ option in the Device & app notifications page.
Enable the option and return to the Hexnode app permissions page to enable notification access and continue the enrollment process.
