KB ID: | 4381 |
Product: | Veeam Backup & Replication | 9.5 | 10 | 11 | 12 | 12.1 | 12.2 |
Published: | 2022-11-18 |
Last Modified: | 2024-07-31 |
Languages: | JP |
A Backup or Backup Copy job fails with the following error message:
Error: Incorrect function. Agent failed to process method {ReFs.SetFileIntegrity}.
When an SMB Share repository is added to Veeam Backup & Replication, if that SMB Share advertises that it is capable of certain features, Veeam Backup & Replication will mark the repository as being Fast Clone compatible. While SMB shares are supported for Fast Clone, there are specific requirements. In rare cases, Veeam Backup & Replication may assume, based on the reported capabilities of an SMB share, that the SMB share is compatible with Fast Clone when, in fact, the underlying storage of the NAS is not actually Fast Clone compatible.
This issue has been observed as occurring most often with Synology devices, though other NAS devices may be affected.
The following registry value forces Veeam Backup & Replication to never use Fast Clone with SMB shares.
It must be created on the Veeam Backup Server.
Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication\
Value Name: UseCifsVirtualSynthetic
Value Type: DWORD (32-Bit) Value
Value Data: 0
0 = Disable using Fast Clone with SMB Share
1 = Enable using Fast Clone with SMB Shares
Note:
PowerShell Cmdlet to create Registry Value to Disable Fast Clone for SMB
When a Windows Repository is added to Veeam Backup & Replication, the software checks if the filesystem is ReFS and, if it is, marks it as being Fast Clone compatible. If, for any reason, the underlying filesystem is later changed to NTFS, the jobs targeting that Repository will continue to attempt to use Fast Clone (enable ReFS Integrity Streams).
Resolve the issue by forcing Veeam Backup & Replication to recheck Fast Clone compatibility:
After editing the Repository and allowing Veeam Backup & Replication to recheck the filesystem and Fast Clone compatibility, the job will stop attempting to enable ReFS Integrity Streams.
The following registry value exclusively controls whether Veeam Backup & Replication will attempt to use Fast Clone with Windows Repositories and has nothing to do with SMB/CIFS repositories. It was created for those rare situations where a ReFS-backed repository is in use, and a user does not want Veeam Backup & Replication to use Fast Clone at all.
For the vast majority of situations, this registry value should not have to be created, as Veeam Backup & Replication will only attempt to use Fast Clone if it detects that a ReFS volume has been added as a Windows Repository. As documented in the Solution section above (Scenario 2), simply editing the Windows repository and clicking Finish will cause the Fast Clone capabilities to be re-evaluated.
To disable Fast Clone on ReFS volumes, the following registry value may be created:
Key Location: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication\
Value Name: RefsVirtualSyntheticDisabled
Value Type: DWORD (32-Bit) Value
Value Data: 1
This form is only for KB Feedback/Suggestions, if you need help with the software open a support case