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
  1. Uninstall the MDM Server and MDM Plugin from the WebUI.
  2. Navigate to the Admin page and remove stored credentials related to MDM.
  3. Clear the WebUI cache:
    • Open: https://<root server ip>/framework/next/webuidata
    • Click Delete All (refer to the attached screenshot if applicable).
Step 2: Restart WebUI Services
  1. Restart the WebUI services on the Windows Root Server.
  2. 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.
  • On the Plugin machine:
    • Windows:Navigate to C:\Program Files (x86)\BigFix Enterprise\BESPluginportal and ensure no Plugins folder remains.
    • RHEL: Navigate to /var/opt/BESPluginportal and ensure no Plugins folder remains.
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

Configure identity service settings via WebUI.

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.

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.