Edit

Share via

Cloud migration prerequisites for Business Central

This article outlines requirements on the Business Central on-premises and online environments for cloud migration. Review this information before you start the cloud migration.

Destination online environment requirements

  • Customer has a Business Central online tenant

  • At least one user has SUPER permissions in the target company in Business Central online.

    Users assigned with SUPER permissions are the only users who can make changes in Business Central online target company. Users who don't have SUPER permissions are automatically reassigned to the intelligent cloud user group, which limits them to read-only access to data. Learn more in Working with environments during cloud migration.

    If you're the person setting up and running the cloud migration, you must have SUPER permissions in Business Central and admin role in Microsoft admin center. If you'll be running cloud migration as a delegated admin, a Business Central user with SUPER permissions has to grant you permission. The permission is granted when you try to run the Cloud Migration Setup. Learn more in About delegated administrators.

  • Install the Business Central migration apps

    In the Business Central administration center, open the environment that you intend to migrate your data to, and then choose the Apps action. Make sure that these apps have the latest updates installed:

    • Intelligent Cloud Base
    • Business Central Intelligent Cloud

    Important

    In Business Central online, install, publish, or upgrade the Intelligent Cloud Base extension first, and then the product-specific extension or extensions.

    If you're migrating from an earlier supported version of Business Central, you must also make sure that the following apps are updated:

    • Business Central Cloud Migration – Previous Release
    • Business Central Cloud Migration – Previous Release [code for your country-specific version]

    Also, at the end of the upgrade, you must make sure that the applicationVersion field in the ndo$tenantdatabaseproperty table is set to the right version. If the field is blank, or if it's set to an older version than the migration tool supports, the migration can't run. Learn more in Post-upgrade tasks.

  • Install customization extensions

    If the on-premises database includes data owned by an extension, and you want the data migrated, then install the extension on the online tenant. Also, make sure that each extension includes at least one permission set the gives at access.

Source on-premises environment requirements

  • Business Central version 25.0 or later

    If your solution uses an older version, upgrade to at least version 25.0 before you migrate to Business Central online. Learn more about supported migration paths in Migrate on-premises data to Business Central online.

    Important

    During upgrade, change the application version in the database to match the upgraded version. Learn more in Change the application version in the database.

    If this requirement isn't met, the cloud migration fails to run properly. Learn more in Troubleshooting cloud migration.

  • Database

    The database can be hosted on SQL Server or Azure SQL Database.

    An SQL Server database must meet the following requirements:

Other

  • Self-hosted integration runtime machine (local on-premises database only; not Azure Database Server)

    The computer from which you'll run the cloud migration and self-hosted integration runtime should meet the requirements described at Create and configure a self-hosted integration runtime.

Next steps