amsamba — Amanda Application to interface with smbclient
Amsamba is an Amanda Application API script. It should not be run by users directly. It uses smbclient to backup and restore data.
The diskdevice in the disklist (DLE) must have the form '//CIFSHOST/SHARE/SUBDIR' where CIFSHOST is the CIFS host containing the data to be backed up, SHARE is the share to connect, and subdir is the subdirectory to backup. '/subdir' can be ommited, in which case the complete share is archived.
Unlike most applications, amsamba backs up and restores data located on a different system from that where amsamba itself runs. The host containing the data is the CIFS host. In practice, amsamba is usually run on the same system as the Amanda server, with a DLE like
localhost "//CIFSHOST/SHARENAME" amsamba-dumptype
Include or exclude can be used, but not both. The path for 'exclude list' or 'include list' must be absolute path on the CIFS host. The estimate calculates the complete size of the share, without regard for include or exclude directives. It will be larger than the actual dump if you use include or exclude. Using 'estimate server' in the dumptype could give better estimate.
This section lists the properties that control amsamba's functionality. See amanda-applications(7) for information on application properties and how they are configured.
Sharename User%Password DomainSharename is '//HOST/SHARE' without the SUBDIR. Sharename can be quoted, it can be '*' to match all share, it can be '//pc-host/*' to match all share on pc-host. User is the username use to connect to the share. Password is the password use to connect to the share. '%Password' is optional if the user can connect to the share without password. 'User%Password' is optional, the user 'guest' without password is use to connect to the share. Domain is optional. Example:
//another-pc/share otheruser%otherpw domain //another-pc/share otheruser%otherpw //another-pc/share myuser mydomain //another-pc/share myuser //another-pc/share
This application supplies exclude lists via the
smbclient -TX
option. Normal shell-style
wildcard expressions, using * and ?, are not supported. All expressions are
matched only from the base directory of the DLE. Expressions that match a
directory may have a leading or trailing "/". Example expressions:
./temp-files # exclude top-level dir "temp-files" entirely ./temp-files/ # same /temp-files # same temp-files # same ./temp-files/* # BAD: does nothing *.iso # BAD: does nothing proxy/local/cache # exclude "cache" in dir "proxy/local"
Include lists are supported only if excludes are not given. They are
handled via the smbclient -TI
option.
Include matching is identical to the exclude matching described above.
define application app_amsamba { property "SMBCLIENT-PATH" "/usr/bin/smbclient" property "GNUTAR-PATH" "/bin/tar" property "AMANDAPASS" /etc/amandapass" property "ALLOW-ANONYMOUS" "guest" }
This manual page was written by
.