topic hubPlatform, DevOps & Performanceofficial - Microsoftreviewed - checked by Opus

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

Source: Microsoft Learn (CC BY 4.0). Descriptions are Learn’s own.

What Learn documents here 2 Learn pages