sintomo
Un processo di backup o copia di backup non riesce con il seguente messaggio di errore:
Errore: funzione errata. L'agente non è riuscito a elaborare il metodo {ReFs.SetFileIntegrity}.
Causa
Soluzione
È stato osservato che questo problema si verifica in due diversi scenari:
Scenario 1: il processo ha come destinazione un repository SMB/CIFS
Quando un repository SMB Share viene aggiunto a Veeam Backup & Replication, se tale SMB Share dichiara di essere in grado di eseguire determinate funzionalità, Veeam Backup & Replication contrassegnerà il repository come compatibile con Fast Clone . Sebbene le condivisioni SMB siano supportate per Fast Clone, ci sono alcuni requisiti specifici . In rari casi, Veeam Backup & Replication può presumere, in base alle funzionalità segnalate di una condivisione SMB, che la condivisione SMB sia compatibile con Fast Clone quando in realtà lo storage sottostante del NAS non è effettivamente compatibile con Fast Clone.
È stato osservato che questo problema si verifica più spesso con i dispositivi Synology, anche se altri dispositivi NAS potrebbero essere interessati.
Impostazione del Registro di sistema per disabilitare la clonazione rapida per SMB
Il seguente valore di registro impone a Veeam Backup & Replication di non utilizzare mai Fast Clone con condivisioni SMB.
Deve essere creato sul Veeam Backup Server .
Posizione chiave: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication\
Nome valore: UseCifsVirtualSynthetic
Tipo valore: DWORD (32 bit) Valore
Dati valore:
0 = Disabilita l’uso di Fast Clone con condivisione SMB
1 = Abilita l’uso di Fast Clone con condivisioni SMB
Nota:
- Questo valore ha effetto sulla successiva esecuzione del lavoro. Non è necessario riavviare i servizi Veeam.
- Questa impostazione disabiliterà la funzionalità Fast Clone per tutti i repository SMB.
Cmdlet di PowerShell per creare un valore di registro per disabilitare Fast Clone per SMB
Scenario 2: il processo ha come destinazione un repository Windows
Quando un repository Windows viene aggiunto a Veeam Backup & Replication, il software verifica se il filesystem è ReFS e, in tal caso, lo contrassegna come compatibile con Fast Clone. Se per qualsiasi motivo, il file system sottostante viene successivamente modificato in NTFS, i processi destinati a tale repository continueranno a tentare di utilizzare Fast Clone (abilitare ReFS Integrity Streams).
Risolvi il problema forzando Veeam Backup & Replication a ricontrollare la compatibilità di Fast Clone:
- Modifica il repository .
- Fare clic sul pulsante Fine.
Dopo aver modificato il repository e aver consentito a Veeam Backup & Replication di ricontrollare il filesystem e la compatibilità di Fast Clone, il job smetterà di tentare di abilitare ReFS Integrity Streams.
Maggiori informazioni
Il valore di registro riportato di seguito viene documentato in questa KB poiché viene spesso trovato durante la ricerca del messaggio di errore “L’agente non è riuscito a elaborare il metodo {ReFs.SetFileIntegrity}”. L’intento di documentarlo qui non è quello di approvarne l’uso, ma piuttosto di chiarirne lo scopo e prevenire l’uso improprio.
Questo valore di registro controlla esclusivamente se Veeam Backup & Replication tenterà di utilizzare Fast Clone con i repository Windows e non ha nulla a che fare con i repository SMB/CIFS. È stato creato per quelle rare situazioni in cui è in uso un repository supportato da ReFS e un utente non desidera affatto che Veeam Backup & Replication utilizzi Fast Clone.
Per la stragrande maggioranza delle situazioni, questo valore di registro non dovrebbe essere creato , poiché Veeam Backup & Replication tenterà di utilizzare Fast Clone solo se rileva che un volume ReFS è stato aggiunto come repository Windows. Come documentato nella sezione Soluzione sopra (Scenario 2), la semplice modifica del repository di Windows e facendo clic su Fine causerà una nuova valutazione delle funzionalità di Clonazione rapida.
Posizione chiave: HKLM\SOFTWARE\Veeam\Veeam Backup and Replication\
Nome valore: RefsVirtualSyntheticDisabled
Tipo valore: DWORD (32 bit)
Dati valore valore: [0= Predefinito, 1=Disabilita clonazione rapida]