Table of Contents
- Common problems you might encounter
- It keeps asking for my SSH password
- "cannot receive incremental stream: destination has been modified since most recent snapshot"
- "cannot receive incremental stream: invalid backup stream"
- "internal error: Invalid argument"
- zfs receive fails, but snapshot seems to be received successful.
- "cannot receive incremental stream: kernel modules must be upgraded to receive this stream."
- "dataset is busy"
- Other problems
Common problems you might encounter
It keeps asking for my SSH password
You forgot to setup automatic login via SSH keys, look in the example how to do this.
"cannot receive incremental stream: destination has been modified since most recent snapshot"
This means your target dataset has been modified somehow.
Make sure you read how Mounting works.
- You can use
--rollbackto automatically rollback such changes. - Set the
readonlyproperty of the target filesystem to on. This prevents all modifications on the target side. Note that readonly prevents changes to the CONTENTS of the dataset directly. Its still possible to receive new datasets and manipulate properties etc. - Always use
--clear-mountpoint, see Mounting
"cannot receive incremental stream: invalid backup stream"
This usually means you've created a new snapshot on the target side during a backup. If you restart zfs-autobackup, it will automaticly abort the invalid partially received snapshot and start over.
"internal error: Invalid argument"
In some cases (Linux -> FreeBSD) this means certain properties are not fully supported on the target system.
Try using something like: --filter-properties xattr or --ignore-transfer-errors.
zfs receive fails, but snapshot seems to be received successful.
This happens if you transfer between different Operating systems/zfs versions or feature sets.
Try using the --ignore-transfer-errors option. This will ignore the error. It will still check if the snapshot is actually received correctly.
"cannot receive incremental stream: kernel modules must be upgraded to receive this stream."
This happens if you forget to use --encrypt, while the target datasets are already encrypted. (Very strange error message indeed)
"dataset is busy"
If you try to destroy a snapshot and its busy, there might be multiple reasons, but dont forget to check if the snapshot has holds with:
zfs holds
zpool/fs1@snapshot1
Release it with zfs release.
Use --no-holds in zfs-autobackup if you dont want to use holds.
Other problems
-
Feel free to ask questions about zfs-autobackup here: https://github.com/psy0rz/zfs_autobackup/discussions
-
If you found a bug or want to request a feature: https://github.com/psy0rz/zfs_autobackup/issues
-
For more general questions go to the excellent subreddit at https://reddit.com/r/zfs
zfs-autobackup:
- Introduction (README.md)
- Getting started
- Full manual
- Mounting backup datasets
- Performance tips (recommended)
- Common problems and errors
- Thinning out obsolete snapshots
- Common snapshot and holds
- Handling ZFS encryption
- Transfer buffering, compression and rate limiting.
- Custom Pre- and post-snapshot commands
- Monitoring
Examples:
Sponsored by: JetBrains