VolSync limitations
Limits
Section titled “Limits”- Restic only. bret reads
spec.resticof theReplicationSource. rclone, rsync and syncthing movers are not supported. - No point in time across PVCs. Each PVC syncs on its own. The restored PVCs of one run can be minutes apart. See Point in time across PVCs.
- The newest sync is the backup. VolSync keeps no object per backup. To test an older restic
snapshot, create a
Restoreby hand withrestoreAsOf. - Repository Secret next to the Restore. The Secret must be in the
Restorenamespace. - One mover UID per volume. All restored files belong to that UID.
- Labels must match one ReplicationSource. A
backupSelectorthat matches more blocks the test.
Troubleshooting
Section titled “Troubleshooting”VolSync mover: permission denied on the data directory
Section titled “VolSync mover: permission denied on the data directory”- Cause: the mover runs as the default non-database UID.
- Fix: set
moverSecurityContextin theReplicationSourceto the owner UID, and thebret.linogics.io/mover-uidannotation on the check for the restore.
VolSync: permission denied after changing the mover UID
Section titled “VolSync: permission denied after changing the mover UID”- Cause: the cache PVC was created by the old mover UID.
- Fix: delete the cache PVC. VolSync creates a new one.
RestoreTest stops at BackupSelectorAmbiguous
Section titled “RestoreTest stops at BackupSelectorAmbiguous”- Cause: the
labelsof a source match more than oneReplicationSource. - Fix: use
backupSelector.name, or labels that only oneReplicationSourcecarries. Reason:BackupSelectorAmbiguous.
Restore fails with RepositoryMissing
Section titled “Restore fails with RepositoryMissing”- Cause: the
ReplicationSourcehas nospec.restic.repository, or its Secret is not in theRestorenamespace. - Fix: keep the repository Secret next to the
Restore. Reason:RepositoryMissing.
Restore fails with SourceMismatch
Section titled “Restore fails with SourceMismatch”- Cause:
spec.sourcePVCof theReplicationSourceis not thesourcePVCof the source. - Fix: point
backupReforbackupSelectorat theReplicationSourceof that PVC. Reason:SourceMismatch.
Restore fails with BackupNotFound and restoreAsOf
Section titled “Restore fails with BackupNotFound and restoreAsOf”- Cause: restic has no snapshot at or before
restoreAsOf. The mover exits 0 but restores nothing, and bret fails the attempt instead of checking an empty volume. - Fix: pick a later
restoreAsOf, or checkrestic snapshotsin the repository. Reason:BackupNotFound.
