Category filter

Migrate your Macs to Hexnode with Hexnode Onboarder

Efficiently managing digital assets is critical for the growth of the organization. MDM solutions help an organization remotely manage and monitor its endpoint devices with ease. At times, the company may outgrow the existing MDM’s capabilities. To accommodate and manage these changes, organizations may be required to migrate to an alternate MDM solution. A device wipe may be necessary for the migration into a new MDM solution.

Hexnode introduces a new enrollment method targeting the migration of macOS devices to Hexnode UEM. The Mac Onboarder application remotely migrates macOS devices to Hexnode UEM without performing a device wipe. This document will guide you through the steps to seamlessly migrate your macOS devices to Hexnode UEM.

Notes:

  • Configure the APNs certificate before enrolling an Apple device.
  • This feature is supported only on Pro, Enterprise, Ultimate and Ultra pricing plans.

Migrate Mac to Hexnode UEM

The Hexnode Onboarder installed on the devices helps the users with migration from the device end. The app can be installed by creating a configuration file from the Hexnode console and then deploying the PKG file to the devices. You can even use your existing MDM to deploy the file. This configuration file specifies the configurations for the Hexnode Onboarder app and the device-specific network settings necessary to process the migration. Follow these steps to migrate your Mac from another MDM to Hexnode.

  1. Navigate to Enroll > Platform-Specific > macOS > Migrate to Hexnode.
  2. If you have already generated the configuration file, skip to step 11. If not, click on Generate a new configuration file.
  3. Provide a suitable name for the configuration file under the File name field.
  4. Configure Onboarder app settings

  5. Enable the option Enforce Hexnode Onboarder app in full screen to open the app in full screen. This option restricts the device to the Onboarder app until the migration is complete.
  6. Allow users to leave the full screen during migration enforced by the Onboarder app by enabling the option Allow user to exit full screen. The user can tap on the Hexnode icon on the left side of the Onboarder app 5 times in quick succession to exit the full screen for 15 seconds.
  7. Enable the option Automate Migration to initiate the device migration without the interaction of the user. The migration will start automatically after the Hexnode Onboarder app is installed on the device. All removable MDM profiles will be removed from the device, and the user will be asked to authenticate if any authentication is enforced.
  8. Admins can choose the enrollment type as Adaptive or Device enrollment (Manual).
    • Adaptive – The Hexnode Onboarder app automatically detects the device capabilities and initiates Automated Device Enrollment (DEP) or Device Enrollment (Manual) as suited.
    • Device Enrollment (Manual) – The Hexnode Onboarder app forces manual Device Enrollment over Automated Device Enrollment. Not recommended as this severely reduces the device management capabilities.
  9. Configure network settings

  10. Wi-Fi configuration – Enable the option Add Wi-Fi settings to configuration file to configure the Wi-Fi settings. The configured Wi-Fi settings will be reflected on the device upon PKG file installation.
  11. VPN configuration – Enable the option Add VPN settings to configuration file to configure the VPN settings. The configured VPN settings will be reflected on the device upon PKG file installation.
  12. Warning:


    Once the PKG file is deployed, there may be chances that the network configurations be exposed to the users at the device end. Thus, while configuring the network settings, we advise using temporary network configurations and refrain from using Enterprise network configurations.

  13. Click on Generate a custom PKG file to generate the configuration file in downloadable format. It may take several minutes to prepare the configuration profile in PKG format.
  14. Download the PKG file onto your device.
  15. Deploy the configuration to target macOS devices.

Complete device migration

The custom PKG file installs the Hexnode Onboarder app on the device and associates the configurations. The Hexnode Onboarder app automatically opens up after installing the PKG file on the device. Choose any of the following cases depending on your device scenarios and follow the steps accordingly.

Case 1: The device is not a DEP device and enrolled in MDM

  1. Initiate the disenrollment from the currently enrolled MDM.
  2. Now, click Enroll on the Hexnode Onboarder app follow the steps to enroll the device.
  3. The admin user is required to approve the MDM profile before installation on devices running macOS 10.15 and above.

Case 2: The device is DEP device and not enrolled in MDM

  1. Login to your ABM portal and reassign the device to the MDM server associated with the Hexnode UEM console.
  2. Ensure that the device is synced with the Hexnode portal from Admin > Apple Business > Apple DEP > DEP Devices.
  3. If the devices do not appear here, click Sync with DEP to sync with Apple Business Manager.
  4. Then, click Migrate MDM Profile from the Hexnode Onboarder app.
  5. The device will get enrolled in Hexnode without getting wiped.
  6. Admins can update the DEP profile after enrollment.

Case 3: The device is a DEP device and enrolled in MDM

  1. Initiate the disenrollment from the currently enrolled MDM.
  2. Login to your ABM portal and reassign the device to the MDM server associated with the Hexnode UEM console.
  3. Ensure that the device is synced with the Hexnode portal from Admin > Apple Business > Apple DEP > DEP Devices.
  4. If the devices do not appear here, click Sync with DEP to sync with Apple Business Manager.
  5. Then, click Migrate MDM Profile from the Hexnode Onboarder app.
  6. The device will get enrolled in Hexnode without getting wiped.
  7. Admins can update the DEP profile after enrollment.

Case 4: The device is not a DEP device and not enrolled in MDM

  1. Click Enroll on the Hexnode Onboarder app and initiate the enrollment.
  2. On devices running macOS 10.15 and above, the admin user must approve the MDM profile before the installation.
Notes:

  • The Hexnode Onboarder app can be used to migrate macOS devices between two different Hexnode UEM portals.

  • Enrolling Devices
  • How-to Guides