'\" t
.\"     Title: amzfs-sendrecv
.\"    Author: Jean-Louis Martineau <martineau@zmanda.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot_8273 <http://docbook.sf.net/>
.\"      Date: 11/05/2009
.\"    Manual: System Administration Commands
.\"    Source: Amanda 2.6.1p2
.\"  Language: English
.\"
.TH "AMZFS\-SENDRECV" "8" "11/05/2009" "Amanda 2\&.6\&.1p2" "System Administration Commands"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
amzfs-sendrecv \- Amanda script to create zfs sendrecv
.SH "DESCRIPTION"
.PP
amzfs\-sendrecv is an
\fIAmanda\fR
application implementing the Application API\&. It should not be run by users directly\&. It create a zfs snapshot of the filesystem and backup the snapshot with \'zfs send\'\&. Snapshot are kept after the backup is done, this increase the disk space use on the client but it is neccesary to be able do to incremental backup\&. If you want only full backup, you can disable this feature by setting the KEEP\-SNAPSHOT property to \'NO\'\&. Only the restoration of the complete backup is allowed, it is impossible to restore a single file\&.
.PP
The application is run as the amanda user, it must have many zfs priviledge:
.sp
.nf
    zfs allow \-ldu AMANDA_USER mount,create,rename,snapshot,destroy,send,receive FILESYSTEM
.fi
.PP
Some system doesn\'t have "zfs allow", but you can give the Amanda backup user the rights to manipulate ZFS filesystems by using the following command:
.sp
.nf
usermod \-P "ZFS File System Management,ZFS Storage Management" AMANDA_USER
.fi
This will require that your run zfs under pfexec, set the PFEXEC property to YES\&.
.PP
The format of the DLE must be one of:
.sp
.nf
Desciption              Example
\-\-\-\-\-\-\-\-\-\-              \-\-\-\-\-\-\-
Mountpoint              /data
ZFS pool name           datapool
ZFS filesystem          datapool/database
ZFS logical volume      datapool/dbvol
.fi
.PP
The filesystem doesn\'t need to be mounted\&.
.SH "PROPERTIES"
.PP
This section lists the properties that control amzfs\-sendrecv\'s functionality\&. See
\fBamanda-applications\fR(7)
for information on the Application API, application configuration\&.
.PP
DF\-PATH
.RS 4

Path to the \'df\' binary, search in $PATH by default\&.
.RE
.PP
KEEP\-SNAPSHOT
.RS 4

If "YES" (the default), snapshot are kept after the backup, if set to "NO" then snapshot are no kept and incremental backup will fail\&.
.RE
.PP
ZFS\-PATH
.RS 4

Path to the \'zfs\' binary, search in $PATH by default\&.
.RE
.PP
PFEXEC\-PATH
.RS 4

Path to the \'pfexec\' binary, search in $PATH by default\&.
.RE
.PP
PFEXEC
.RS 4

If "NO" (the default), pfexec is not used, if set to "YES" then pfexec is used\&.
.RE
.SH "EXAMPLE"


In this example, a dumptype is defined to use amzfs\-sendrecv application to backup a zfs filesystem\&.
.nf
 define application\-tool amzfs_sendrecv {
   comment "amzfs\-sendrecv"
   plugin "amzfs\-sendrecv"
   #property "DF\-PATH"  "/usr/sbin/df"
   #property "KEEP\-SNAPSHOT" "YES"
   #property "ZFS\-PATH" "/usr/sbin/zfs"
   #property "PFEXEC\-PATH" "/usr/sbin/pfexec"
   #property "PFEXEC" "NO"
 }

 define dumptype user\-zfs\-sendrecv {
   program "APPLICATAION"
   application "amzfs_sendrecv"
 }
.fi
.SH "SEE ALSO"
.PP

\fBamanda.conf\fR(5),
\fBamanda-client.conf\fR(5),
\fBamanda-applications\fR(7)
.SH "AUTHOR"
.PP
\fBJean\-Louis Martineau\fR <\&martineau@zmanda\&.com\&>
.RS 4
Zmanda, Inc\&. (http://www\&.zmanda\&.com)
.RE