Clean Installation for MDM Server & Plugin
Recommended steps for performing a clean reinstallation of the MDM Server and MDM Plugin when there are no enrollments or other configurations.
If you encounter persistent installation or configuration issues with the MDM environment, perform a complete cleanup and reinstallation by following the steps below.
Fresh Installation Recovery (No Production Enrollments)
CAUTION:
Use this procedure only if:- Installation failed during initial setup
- No production devices have been enrolled
- No production certificates are in use
- Step 1: Uninstall from WebUI
-
- Uninstall the MDM Server and MDM Plugin from the WebUI.
- Navigate to the Admin page and remove stored credentials related to MDM.
- Clear the WebUI cache:
- Open:
https://<root server ip>/framework/next/webuidata - Click Delete All (refer to the attached screenshot if applicable).
- Open:
- Step 2: Restart WebUI Services
-
- Restart the WebUI services on the Windows Root Server.
- Ensure all the applicable BES services are running properly before proceeding.
- Step 3: Verify Complete Cleanup
-
Before reinstalling, confirm that all configurations have been fully removed:
- On the MDM Server machine:
- Navigate to
/var/opt/and ensure no previous BESUEM folder remains.
- Navigate to
- On the Plugin machine:
- Windows:Navigate to
C:\Program Files (x86)\BigFix Enterprise\BESPluginportaland ensure no Plugins folder remains. - RHEL: Navigate to
/var/opt/BESPluginportaland ensure no Plugins folder remains.
- Windows:Navigate to
- On the MDM Server machine:
- Step 4: Reinstall MDM Components
-
- Install the MDM Server and MDM Plugin.
- During installation, configure required platforms:
- Apple
- Windows
- Android
- ChromeOS
- Step 5: Configure LDAP
- Step 6: Post-Installation Checklist
-
- Verify MDM Server and Plugin status is healthy on the Health Check page.Note: If the identity service configuration shows red on the healthcheck page, restart MDM services.
- Validate device enrollment (Android/Apple/ChromeOS/Windows).
- Ensure identity service synchronization is functioning correctly.
- Verify MDM Server and Plugin status is healthy on the Health Check page.
If issues persist after completing the above steps, collect logs from:
- Root Server
- MDM Server
- Plugin Server
Escalate to HCL BigFix support with logs and screenshots for further analysis.