zfs-replicate
https://github.com/alunduil/zfs-replicate
By Alex Brandt alunduil@gmail.com
Description
zfs-replicate sends all Zettabyte File System (ZFS) snapshots to a remote host by SSH. zfs-replicate does not create ZFS snapshots.
zfs-replicate forks autorepl.py used by FreeNAS.
zfs-replicate relates to several other projects, which fit other niches:
- sanoid: A full snapshot management system. Its companion,
syncoid, handles replication with copious options. - zfs-replicate (BASH): A similar project. The major differences include configuration style and system expectations (for example, logging controls). zfs-replicate uses parameters whereas zfs-replicate (BASH) uses a BASH script.
- znapzend: Another scheduling and replicating system.
- zrep: A SH script with several control commands for snapshot replication.
Terms of use
You are free to copy, change, and distribute zfs-replicate with attribution
under the terms of the BSD-2-Clause licence. See the LICENSE for details.
Prerequisites
- A remote system with a ZFS filesystem and the
zfscommand-line tools - If using lz4 compression, local and remote systems must have lz4 in their environments
- SSH access to that remote system
- If you're not using the root user remotely:
- Ensure the user can mount filesystems
- FreeBSD:
sysctl -w vfs.usermount=1
- FreeBSD:
- Add ZFS permissions
- Command:
zfs allow ${USER} ${PERMISSIONS} ${BACKUP_DATASET} - Permissions
clonecreatedestroyholdmountpromotequotareadonlyreceiverenamereservationrollbacksendsnapshot
- Command:
- Ensure the user can mount filesystems
- A local ZFS filesystem and
zfscommand-line tools
N.B., don't use the root user to access your remote system.
How to use zfs-replicate
poetry installpoetry run -- zfs-replicate --help
Documentation
zfs-replicate --help: Help for zfs-replicate.- LICENSE: Licence file explaining usage of zfs-replicate.
- Survey of ZFS Replication Tools: Overview of various ZFS replication tools and their uses.
- Working With Oracle Solaris ZFS Snapshots and Clones: Oracle's guide to working with ZFS snapshots.
- ZFS replication without using Root user: How to configure ZFS replication for a non-root user.
Getting support
- GitHub issues: Report any problems or features requests to GitHub issues.
Metadata
Release files for zfs-replicate 4.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| zfs_replicate-4.1.0.tar.gz | 15.9 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| zfs_replicate-4.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 36.2 kB
Release files / zfs_replicate-4.1.0.tar.gz
| Download URL | zfs_replicate-4.1.0.tar.gz |
|---|---|
| Size | 15.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0535c946ddb87dd7461f0ef765108b8c3f107e842dfa7844227a07271b3d5186
|
|
BLAKE2b-256 checksum How to use checksums |
c362f1da847087a7fbf2228d16308dd48e898464c2bddee553e4049361485e41
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.0 CPython/3.12.3 Linux/6.17.0-1010-azure
|
Release files / zfs_replicate-4.1.0-py3-none-any.whl
| Download URL | zfs_replicate-4.1.0-py3-none-any.whl |
|---|---|
| Size | 20.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8c155e1e704f50d784989c84fbe7ea7d41f0b02bd2709741fc6791dbf17da927
|
|
BLAKE2b-256 checksum How to use checksums |
bd36d2ff73f6cda3c1f0d84cdb688e0063d1f234a71392671caefa43a2d511e2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.0 CPython/3.12.3 Linux/6.17.0-1010-azure
|
Security for zfs-replicate 4.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.