--- title: "Preparing to migrate" slug: "preparing-to-migrate" tags: ["Migration", "ENS 10.7.x"] updated: 2026-10-07T18:04:46Z published: 2026-10-07T18:04:46Z canonical: "docs.trellix.com/preparing-to-migrate" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Preparing to migrate To streamline the migration process and minimize conflicts or duplication in migrated settings, follow these best practices before migrating. - **Check system requirements** — Make sure that the environment and managed systems where you want to install Trellix ENS meet all requirements described in: - Windows — [KB82761](https://kcm.trellix.com/corporate/index?page=content&id=KB82761) and the Trellix Endpoint Security (ENS) Installation Guide - Macintosh — [KB84934](https://kcm.trellix.com/corporate/index?page=content&id=KB84934) and the Endpoint Security for Mac Product Guide - Linux — [KB87073](https://kcm.trellix.com/corporate/index?page=content&id=KB87073) and the Trellix Endpoint Security (ENS) for Linux Product Guide - **Check product licensing requirements** — Migration requires a Threat Prevention License extension for the operating system platform. The Migration Assistant checks for a macOS and Linux License extension before enabling the option to migrate macOS and Linux settings. - **Install the Endpoint Migration Assistant** — The Migration Assistant is a self-contained Trellix ePO - On-prem extension that you need to install on the Trellix ePO - On-prem server. - **Review and revise objects you plan to migrate** — > [!NOTE] > Tip > > **Best practice:** See [KB66909](https://kcm.trellix.com/corporate/index?page=content&id=KB66909) for links to frequently used Technical Articles about file and folder exclusions for Trellix ENS 10.x.x and VirusScan Enterprise 8.x. - Review legacy settings and assignments. Consolidate them where possible. Remove duplicates and unused objects. - Review VirusScan Enterprise exclusion rules for unsupported characters. Wherever the ; character is used as a delimiter to separate include and exclude processes, replace it with the , character. - **Notify others not to make changes to the **Policy Catalog**, **Client Task Catalog**, and **Host IPS Catalog** during migration** — If objects change while you're migrating them, the migrated objects don't reflect those changes. - **Locate unassigned policies and client tasks for migration** — (Automatic migration only) During automatic migration, only policies and client tasks that are assigned to at least one group or managed system are migrated. Use manual migration to migrate unassigned policies or client tasks. ## What to do next Once you install the Migration Assistant and review the settings you want to migrate, you are ready to begin migration. See the Maps of migrated policies appendix for illustrations of how legacy policies are migrated to Trellix ENS policies. See the Changes to migrated settings appendix for details about settings that are removed, moved, renamed, or merged.