Managing Updates in the Business Central Admin Center

Business Central environments are updated according to the Business Central roadmap with two major updates in April and October each year, and monthly, minor updates. For more information, see Major Updates and Minor Updates for Business Central Online and the Dynamics 365 Release Plans.

Updates of the base application and platform are managed by Microsoft. As an internal administrator or as a partner, you can use the Business Central administration center to specify certain parameters of the timing of updates for each environment, and you can specify the people who must receive notifications of when an update is available. You can also help prepare your solution and your users by creating preview environments so that you can get acquainted with new functionality in the product. For more information, see Major Updates and Minor Updates.

Set the update window for each environment

The update window for an environment defines a window of time during the day in which the environment can be updated. When an update is rolling out to Business Central online, regardless of whether it's the monthly update or a major update, the update will be applied to an environment within the time frame that the update window defines. This helps to ensure that updates are applied outside of the normal business hours of the organization, for example.

The update window must be a minimum of six hours.

Note

Desktop users who are signed in during the update will receive an alert in Business Central.

To set the update window for an environment:

  1. On the Environments tab of the Business Central administration center, choose the Name of the relevant environment to open the environment details.
  2. Choose the Update Settings action, and then choose the Set update window action.
  3. In the Set update window pane, specify the start time and the end time for the update window for the environment.

    Note

    The update window must be a minimum of six hours.

  4. Choose Save.

This timeslot now becomes the default window when updates will be applied to this environment.

Schedule an update date

Once an update is available, you can choose a specific date that each environment is updated.

The following fields on the environment page can help you plan the update:

Field Description
Available Update Version Specifies the version to which you can update your environment
Update Scheduling Available Specifies whether it's possible for you to change the update date. The options are Yes or No.
Scheduled Update Date Specifies the default update date set by Microsoft. You can change this date to one you prefer, if Update Scheduling Available is set to Yes
Update Rollout State Microsoft can sometimes postpone the updates for various reasons. This field provides information that can help you track the current state of the rollout. For more information about what happens in such cases, see Postponed updates

Important

If you don't set a date in the Scheduled Update Date field, Microsoft will update the environment automatically on any day between the default date and the date that is shown as the last possible update date in your notification email. If you don't want your environment to be updated automatically, change the update date to one that fits you better.

For more information, see Schedule updates.

To schedule an update date:

  1. On the Environments tab of the Business Central administration center, choose the Name of the relevant environment to open the environment details.

  2. Choose the Update Settings action, and then choose the Set update date action.

  3. In the Schedule Environment Update pane, specify the update date.

    Note

    The specified date must be within a given date range that is shown in the pane.

  4. Choose Schedule Update.

If an administrator has chosen the Set update date action but not set a date, then the update is applied automatically within a default date range. The default date range is communicated in advance to tenant administrators through administrative notifications. You can then choose to override that with a custom date by following the steps that are provided above. Not selecting an update date does not prevent the environment from being updated.

Tip

Starting with 2021 release wave 1, you can also schedule update dates for minor updates.

Get notified of updates

For updates that tenant administrators can schedule, a notification is sent to all notification recipients that are listed on the Notification recipients tab of the Business Central administration center. For more information, see Managing Tenant Notifications.

Important

To not miss update notifications from Microsoft, you must verify that the emails are not redirected to a spam folder by your email software. The notifications are sent from the Microsoft Partner Center account, msftpc@microsoft.com, and contain Dynamics 365 Business Central in the subject line.

For versions earlier than 2021 release wave 1, admins cannot schedule the monthly minor updates. Until such environments are updated to version 18.0 and later, the update is applied to tenant environments as it becomes available. No notifications are sent to tenant administrators prior to the update. Notifications are sent only after the update is applied.

Environments that cannot get updated

Sometimes an environment cannot get the new update. For example, a per-tenant extension might conflict with the changes in the new version of the base application.

Before a major update, Microsoft routinely checks per-tenant extensions in all existing environments for compatibility with the next major update. If we detect compatibility issues with the upcoming version, we send email notifications that describe the detected issues to the notification recipients. We warmly encourage all admins to review these emails and take action as soon as possible.

If you discover any such issues, apply the changes to your solution as usual using Visual Studio Code. Test the new app in a sandbox environment that runs on the new major version, either in preview or the official version. If tests complete successfully, upload the new app version into your production environment in the Extension Management page, setting the Deploy to field to Next major version. This way the compatible version of your app will be used when your environment is updated. For more information, see Deploying a Tenant Customization.

For more information, see Failed updates and rescheduling.

See also

Major Updates of Business Central Online
Prepare for major updates with preview environments
Working with Administration Tools
The Business Central Administration Center
Managing Environments
Managing Tenant Notifications
Introduction to automation APIs