Migrate your Macs to Hexnode with Hexnode Gateway

The Hexnode Gateway application remotely migrates macOS devices from another MDM 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.

Migrate Mac to Hexnode UEM

The Hexnode Gateway app can be installed by creating a configuration file from the Hexnode console and then deploying the PKG file to the devices. Follow these steps to migrate your Mac from another MDM to Hexnode.

1. Navigate to Enroll > Platform-Specific > macOS > Migrate to Hexnode.
2. Click on Generate a new configuration file.
3. Provide a suitable name for the configuration file under the File name field.

Configure Gateway app settings

4. Enable the option Enforce Hexnode Gateway app in full screen to open the app in full screen.
5. Allow users to leave the full screen during migration enforced by the Gateway app by enabling the option Allow user to exit full screen.
6. Enable the option Automate Migration to initiate the device migration without the interaction of the user.
7. Admins can choose the enrollment type as Adaptive or Device enrollment (Manual).

Configure network settings

8. Wi-Fi configuration – Enable the option Add Wi-Fi settings to configuration file to configure the Wi-Fi settings.
9. VPN configuration – Enable the option Add VPN settings to configuration file to configure the VPN settings
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.


10. Click on Generate a custom PKG file to generate the configuration file in downloadable format.
11. Download the PKG file onto your device.
12. Deploy the configuration file to target macOS devices. You can even use your existing MDM to deploy the file.

Complete device migration

The deployed PKG file installs the Hexnode Gateway app on the device and associates the configurations. The Hexnode Gateway 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 Gateway 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 Gateway 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 Gateway app.
   
   Notes:

   
   On devices running macOS 14 and above, admin user approval is required to initiate migration. Additionally, the MDM profile must be approved by the admin user before installation.
   

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 Gateway 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.