Upgrade data
Upgrade data covers running data upgrade during cloud migration from earlier Business Central on-premises versions, and how to skip the API data upgrade to shorten upgrade time. It answers questions on prerequisites, process, error handling, monitoring, and per-company disabling of API upgrade.
Path: Administration > Migrate to Business Central online > Migrate from Business Central on-premises > Upgrade data · tier official · system platform · narrative reviewed (checked by Opus)
Overview
This section belongs to the migration path from Business Central on-premises to Business Central online. It deals with the data upgrade step, which upgrades platform-related data when you migrate from earlier Business Central versions.
Two pages make up the section. “Run data upgrade” describes the prerequisites, the process, how errors are handled, and how to monitor the upgrade, including telemetry and point-in-time restore. “Skip API data upgrade in cloud migration” is a focused option for cases where the upgrade runs too long.
Start with “Run data upgrade” to understand the full flow. Read the skip API page if long-running upgrade times are a concern, since it explains how to postpone the API upgrade until after go-live.
Key points
- Data upgrade during cloud migration upgrades platform-related data when migrating from earlier Business Central versions.
- The Run data upgrade page covers prerequisites, process, error handling, and monitoring.
- Point-in-time restore and telemetry are mentioned in connection with running and monitoring the upgrade.
- Skipping API data upgrade reduces long-running upgrade times.
- With the skip option, the API upgrade is disabled during cloud migration and run after going live.
- In Business Central online, disable it through Cloud Migration Management.
- On-premises, disable it with SQL queries.
- The setting is applied on a per-company basis.
Learn pages
- Run data upgrade: This article explains the process for running the data upgrade as part of cloud migration.
- Skip API data upgrade in cloud migration: This article explains things you can skip the API data upgrade during cloud migration and complete it after going live
Source: Microsoft Learn (CC BY 4.0). Descriptions are Learn’s own.