Skip to content

Device migration

You can migrate computers from one Sophos Central account to another. Computers are queued for migration for up to 14 days.

Offline computers must be online within this period to complete the migration. If a computer stays offline for more than 14 days, the migration fails, and the Sophos Central administrator must manually requeue it for migration.

To migrate computers you need to do as follows:

  1. Turn on device migration for your Sophos Central accounts. See Turn on device migration.
  2. Use the Endpoint API to migrate the computers. See Migrate computers using Endpoint API.
  3. Review the migration results in Sophos Central. See Review the migration results.

If an option is locked, your partner or enterprise admin has applied global settings.

Requirements

To migrate computers you must be an administrator for both accounts. You need to have the Admin role. See Role management.

You also need API credentials for both accounts. You need to have Service Principal Super Admin credentials. See API Credentials Management.

To migrate computers you use our Endpoint API. Check the following:

For more information on the Endpoint API see Endpoint API.

Turn on device migration

To turn on migration, do as follows:

  1. Sign in to the Sophos Central account you want to migrate computers from.

    This is your sending account.

  2. Go to My Products > General Settings > Device Migration.

    Device migration.

  3. Turn on Allow device migration.

    Device migration settings.

  4. Set a time limit for migrations.

    We recommend that you allow migrations for a limited time period.

  5. Sign into the Sophos Central account you want to migrate computers to.

    This is your receiving account.

  6. Turn on device migration and set a time limit.

Migrate computers using Endpoint API

Restrictions

  • Only Windows and Mac endpoints support the API-based migration process.
  • Linux endpoints must be migrated on the device by running the installer for the targeted account.

The following video shows how you can migrate computers between Sophos Central accounts using Endpoint API.

To migrate computers between Sophos Central accounts you use our Endpoint API. These instructions summarize the steps you need to do using the API commands. For detailed information on how to use the commands see Endpoint API.

To migrate computers, do as follows:

  1. For the Sophos Central account you want to move computers to, do as follows:

    1. In your Receiver enviroment, create a receiving job for the endpoints.

      You will get an access token when you do this. You need this to create the sending job for the other Sophos Central account. You also need the ID for the receiving job.

  2. For the Sophos Central account you want to move computers from, do as follows:

    1. Get a list of endpoints you want to migrate.
    2. In your Sender environment, create a sending job with the list of endpoints, the access token and the ID from the receiving job you set up for the other Sophos Central account.

      This starts the migration.

You can check the progress of the migration in the API. You can get more detailed information in Sophos Central.

Review the migration results

You can use the event and audit logs in your Sophos Central accounts to check the migration has been successful. You can also check the receiving Sophos Central account for the migrated devices.

In your sending account check your audit log. You should see a "Send endpoints to another tenant" event.

You also need to check your computers. Go to the Events tab for each computer. For each computer that did migrate you should see "Device registered with new account <AccountID>. It's now managed by that account".

For each computer that didn't migrate you should see "Device failed to register with new account <AccountID>. It continues to be managed by this account".

In your receiving account check your audit log. You should see an "Allow endpoints to migrate to this tenant" event.

You also need to check your computers. Go to Devices and then click Computers. You should see your migrated computers. Click on a computer to check it. For each migrated computer, you should see that it has been registered, a user assigned to it and that it has been updated.