Migrating your macOS fleet from an MDM or an RMM can be worrisome, confusing, and stressful. This document is intended to clarify the intricacies of this process and walk through the complexity to ensure a smooth, well-thought-out, streamlined migration to Addigy.
Migrating to Addigy assumes that you have an existing MDM tool in place from which to migrate your devices. For new or unmanaged devices, use the normal process for enrolling devices into Addigy.
Below are the requirements for migration:
- Ability to run a script or PKG on the device
- macOS 10.10 or higher
- MDM Configured (If desired)
The following is the migration process for moving a device from another system into Addigy.
Step 1: Deploy the Addigy Agent using your existing MDM/RMM Tool
- Go to Addigy's Add Devices page and select a policy
- For the script option: copy the link in the Install Via Terminal section.
For the PKG option: download the file in the Install Via Package section.
Note: You cannot have two Addigy Agents installed on the device at the same time.
- Migrating from Connectwise
- Migrating from Kaseya
- Migrating from any other tool should be similar. Just copy the CLI Package and deploy it out using the mechanism provided by the tool to run a one-time script.
Step 2: Replicate Software Packages, MDM Configuration Profiles, etc. in Addigy (Optional)
- Navigate to the Policies page and select the Catalog.
- Use the Custom Software tab to recreate deployment packages from your previous RMM/ MDM tool.
- Use the MDM Configuration tab to recreate any existing MDM profiles currently in use in your previous MDM (Wifi, Energy Savings, Security and Privacy, etc.)
Step 3: Copy scripts into the Addigy Devices page. (Optional)
- On the Devices page, select the Manage tab.
- Copy any desired scripts from your current solution into Addigy. Save the script and repeat for each desired script.
Creating Scripts: https://support.addigy.com/support/solutions/articles/8000053938
Step 4: Configure Addigy MDM (Required for MDM)
- Go to the MDM Settings page in Addigy
- Follow the instructions to create an Apple Push Certificate
- Navigate to the Policies page
- Select a policy and go to the section Integrations > Mobile Device Management (MDM)
- Create the MDM Enrollment Profile and associate the Apple Push Certificate
Detailed process for configuring Addigy MDM
Step 5: Remove Current MDM
- Log in to your current MDM tool
- Un-enroll the device
- Verify that the MDM Enrollment Profile has been removed from the device
Note: If the MDM Profiles are not set to unremovable, the removal can be scripted and is part of the migrator utility. You can reach out to firstname.lastname@example.org to get the migrator utility and assistance using the tool.
Step 6: Install and Approve the Addigy MDM Enrollment Profile
- Go to the Addigy Devices page
- Find the device in the list and click the dropdown arrow
- Press the Install MDM button to deploy the Addigy MDM Enrollment profile
- On the Device, navigate to System Preferences >> Profiles.
- Approve the Addigy MDM Enrollment profile.
- (Additionally, Addigy Support can provide a script to prompt the user to approve the profile if desired, please see information at the end of this guide to contact the appropriate team.)
Step 7: Use Addigy to Remove Any Remaining Aspects of the Previous RMM/MDM Tool (Optional)
- Go to the Addigy Devices page
- In the Run Command bar, enter the commands to remove the previous RMM/MDM tool
- If you are using Apple Business Manager (ABM), remember to re-assign your Automated Device Enrollment (ADE) settings to the Addigy MDM Server(s) in ABM.
- If you re-assign your devices in Apple Business Manager (ABM), you can run the command sudo profiles renew -type enrollment to re-enroll the devices with Automated Device Enrollment.
The Addigy Team has extensive experience helping customers migrate. If you run into issues or questions from this document, please contact email@example.com. Alternatively, if you would like our assistance in the migration, please let us know at firstname.lastname@example.org.