{ "info": { "author": "Manuel Amador (Rudd-O)", "author_email": "rudd-o@rudd-o.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Console", "Environment :: No Input/Output (Daemon)", "Intended Audience :: System Administrators", "License :: OSI Approved :: GNU General Public License (GPL)", "Operating System :: POSIX :: Linux", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 2 :: Only", "Topic :: Communications :: File Sharing", "Topic :: System :: Archiving :: Backup", "Topic :: System :: Archiving :: Mirroring", "Topic :: System :: Filesystems", "Topic :: Utilities" ], "description": "#ZFS tools\n\n| Donate to support this free software |\n|:------------------------------------:|\n| \"\" |\n| [1Cw9nZu9ygknussPofMWCzmSMveusTbQvN](bitcoin:1Cw9nZu9ygknussPofMWCzmSMveusTbQvN) |\n\nThe ZFS backup tools will help you graft an entire ZFS pool as a filesystem\ninto a backup machine, without having to screw around snapshot names or\ncomplicated shell commands or crontabs.\n\nThe utilities let you do this:\n\n1. zfs-shell: \n a shell that allows remote ZFS administration and nothing more\n\n3. zsnap: \n a command that snapshots a dataset or pool, then deletes old snapshots\n\n4. zreplicate \n a command that replicates an entire dataset tree using ZFS replication\n streams. Best used in combination with zsnap as in:\n \n - zsnap on the local machine\n - zreplicate from the local machine to the destination machine\n\n Obsolete snapshots deleted by zsnap will be automatically purged on\n the destination machine by zreplicate.\n \n Run `zreplicate --help` for a compendium of options you may use.\n\nThe repository, bug tracker and Web site for this tool is at [http://github.com/Rudd-O/zfs-tools](http://github.com/Rudd-O/zfs-tools). Comments to me through rudd-o@rudd-o.com.\n\n##Setting up\n\nSetup is rather complicated. It assumes that you already have ZFS running\nand vaults on both the machine you're going to back up and the machine that\nwill be receiving the backup.\n\n###On the machine to back up\n\n- Install the zfs-shell command \n `cp zfs-shell /usr/local/sbin` \n `chmod 755 /usr/local/sbin/zfs-shell` \n `chown root.root /usr/local/sbin/zfs-shell` \n\n- Create a user with a home directory and shell `zfs-shell` \n `useradd -rUm -b /var/lib -s /usr/local/sbin/zfs-shell zfs`\n\n- Let `sudo` know that the new user can run the zfs command \n `zfs ALL = NOPASSWD: /usr/local/sbin/zfs` \n (ensure you remove the `requiretty` default on `/etc/sudoers`)\n (check `sudoers.zfs-tools` in `contrib/` for an example)\n\n- Set up a cron job to run `zsnap` as frequently as you want to,\n snapshotting the dataset you intend to replicate.\n\n###On the backup machine\n\n- Set up public key authentication for SSH so the backup machine\n may log as the user `zfs` (as laid out above) in the machine to\n be backed up.\n\n- Create a dataset to receive the backup stream.\n\n- Set up a cron job to fetch the dataset snapshotted by zsnap\n from the remote machine into the newly created dataset. You\n will use `zreplicate` for that (see below for examples).\n\n- After the first replication, you may want to set the `mountpoint`\n attributes on the received datasets so they do not automount\n on the backup machine.\n\n###Test\n\nIf all went well, you should be able to do this without issue:\n\n(on the machine to back up)\n\n [root@peter]\n zsnap senderpool\n\n(on the machine to receive)\n\n [root@paul]\n zfs create receiverpool/senderpool # <--- run this ONLY ONCE\n zreplicate -o zfs@paul:senderpool receiverpool/senderpool\n # this should send the entire senderpool with all snapshots\n # over from peter to paul, placing it in receiverpool/senderpool\n\n(on the machine to back up)\n\n [root@peter]\n zsnap senderpool\n\n(on the machine to receive)\n\n [root@paul]\n zreplicate -o zfs@paul:senderpool receiverpool/senderpool\n # this should send an incremental stream of senderpool\n # into receiverpool/senderpool\n\nAnd that's it, really.", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/Rudd-O/zfs-tools", "keywords": "ZFS filesystems backup synchronization snapshot", "license": "GPL", "maintainer": null, "maintainer_email": null, "name": "zfs-tools", "package_url": "https://pypi.org/project/zfs-tools/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/zfs-tools/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://github.com/Rudd-O/zfs-tools" }, "release_url": "https://pypi.org/project/zfs-tools/0.4.0/", "requires_dist": null, "requires_python": null, "summary": "ZFS synchronization and snapshotting tools", "version": "0.4.0" }, "last_serial": 853564, "releases": { "0.4.0": [ { "comment_text": "", "digests": { "md5": "949851ece22fbd2f754d49c9ef8eb6ea", "sha256": "99bb06c1d905916c9485ec66eb9b722fa26370c5c16caf54953918fc1f66c18d" }, "downloads": -1, "filename": "zfs-tools-0.4.0.tar.gz", "has_sig": false, "md5_digest": "949851ece22fbd2f754d49c9ef8eb6ea", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 28197, "upload_time": "2013-08-31T07:33:32", "url": "https://files.pythonhosted.org/packages/05/4c/ca843c4e0281c71b3f8b7a31a6b0ad43266ecbe0fe3f05dd07d14c13724e/zfs-tools-0.4.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "949851ece22fbd2f754d49c9ef8eb6ea", "sha256": "99bb06c1d905916c9485ec66eb9b722fa26370c5c16caf54953918fc1f66c18d" }, "downloads": -1, "filename": "zfs-tools-0.4.0.tar.gz", "has_sig": false, "md5_digest": "949851ece22fbd2f754d49c9ef8eb6ea", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 28197, "upload_time": "2013-08-31T07:33:32", "url": "https://files.pythonhosted.org/packages/05/4c/ca843c4e0281c71b3f8b7a31a6b0ad43266ecbe0fe3f05dd07d14c13724e/zfs-tools-0.4.0.tar.gz" } ] }