Repository upgrade error: "Some of the data in this repository is incompatible with the immutability settings."
The resolution procedure of this article involves the directed deletion of backup data that should not have been migrated to the immutable repository.
Please review all details of the article closely, and contact Veeam Support if you would like assistance.
Challenge
After upgrading to Veeam Backup for Microsoft 365 v8, attempting to upgrade an immutable repository fails with the error:
Cannot upgrade this repository (ID: <guid>). Some of the data in this repository is incompatible with the immutability settings. For more details, see KB4644.
Cause
This error occurs because data that may have been mistakenly transferred to that repository using Move-VBOEnttityData was detected. Under certain conditions, it was possible in Veeam Backup for Microsoft 365 v7(a) to transfer backup job data to an immutable repository that should not have been transferred, as technically, only backup copy job data should be stored on an immutable repository. This limitation was detailed in the Release Notes as a known issue:
Using the Move-VBOEntityData cmdlet, you can move backup data to an immutable object storage repository. After such a move only backup copy jobs can be configured to the target repository containing the migrated backup data. Regular backups to an immutable object storage are unsupported.
Because this backup data is not expected to be present in the repository (which was only intended for storing backup copies), after upgrading to Veeam Backup for Microsoft 365 v8, the software cannot upgrade such a repository correctly.
As documented in KB3067, the migration of backup data from a JET-based backup repository to immutable object storage using Move-VBOEntityData is not supported.
Solution
To resolve this issue, the backup data migrated to the immutable object storage must be removed to allow the repository to be upgraded after the upgrade to Veeam Backup for Microsoft 365 v8.
Consider the following:
- Backup data that was mistakenly migrated to the immutable repository cannot be moved to another repository.
- The precheck scripts provided below can be used prior to upgrading Veeam Backup for Microsoft 365 to version 8. This can help determine whether a deployment is impacted by this issue. If impacted, appropriate plans should be made to ensure that all backup jobs are configured to use the supported repository types.
Requirements
The scripts in this section require:
- AWS CLI or Azure CLI must be installed, depending on which type of object storage is in use.
- PowerShell 7
- For Azure storage, the Azure CLI extension 'storage-blob-preview' is required:
-
az extension add --name storage-blob-preview
-
Prepare the Environment
- Ensure all jobs and restore tasks are stopped.
- Reconfigure all jobs targeting the repository that cannot be upgraded to use a different repository.
Note: Please don't run the jobs after changing which repository they use; only change the repository they target so that the repository can be removed. Create a temporary repository to assign the jobs to if one is not available. - Remove the problematic repository from Veeam Backup for Microsoft 365.
Check if the Repository is Impacted by the Issue
- Download the precheck script for the object storage vendor used by the Repository.
- Review the command examples below and specify the parameters as shown.
Remove the Detected Invalid Backup Data
- If the script reports "Found corrupted repository", download the script below that matches the object storage platform to remove those discovered objects/blobs.
- Review the command examples below and specify the parameters as shown.
Re-add the Repository and Finalize
- Re-add the repository to Veeam Backup for Microsoft 365.
- Upgrade the repository.
- Re-configure all jobs modified in Step 3 to use the now repaired and upgraded repository.
Download Information
To report a typo on this page, highlight the typo with your mouse and press CTRL + Enter.