NAME

dumpnet.host.fstab - backup multiple filesystems and/or directories using dump, tar and rsync

SYNOPSIS

BACKUP MODE

dumpnet.host.fstab [-N] [-l LEVEL] [-s SESSIONID] [-d DUMPNET_CONFIG] [-C FSTAB_CONFIG] HOST_CONFIG

RESOTRE MODE

dumpnet.host.fstab -R [-v] [-f FILE] [-d DUMPNET_CONFIG] [-C FSTAB_CONFIG] HOST_CONFIG

DESCRIPTION

dumpnet.host.fstab does a backup of the directories and filesystems specified in the configuration file dumpnet.fstab.conf placed in a host configuration directory. It will call dumpnet.host.fstab.dump, dumpnet.host.fstab.tar and dumpnet.host.fstab.rsync to do the actual backup.

OPTIONS

BACKUP MODE

-N

Do not update dumpnet.cmddates. This is useful for an irregular backup. Keep in mind that a backup created with the -N switch will not be listed in restore mode. See dumpnet.cmddates(8).

-l LEVEL

Set level to LEVEL. This can be a numerical level (0-9) or a level mode. See the sections LEVELS and LEVEL MODES in dumpnet(8) for details.

-s SESSIONID

Set sessionId to SESSIONID. If you don't know if you need this option, you don't! Read the SESSIONID section in dumpnet(8) before using it!

-d DUMPNET_CONFIG

Use DUMPNET_CONFIG instead of the default $DUMPNET_HOME/conf/dumpnet.conf.

-C FSTAB_CONFIG

Use FSTAB_CONFIG as the fstab configuration file (the default is ``dumpnet.fstab.conf''). FSTAB_CONFIG can be the path to the configuration file or `-' to read the fstab configuration from STDIN.

HOST_CONFIG

The host configuration file. For the target host 192.168.1.10 it could be conf/192.168.1.10/dumpnet.HOST.conf.

RESTORE MODE

-R

Restore mode. This will not actually do the restore but will list the files you will need to perform it manually.

-v

Be verbose.

-f FILE

Find the files that are needed to restore FILE. FILE will be used as a pattern to grep in the TOC-files. Please note that entries in the tar TOC-files do not contain a leading slash.

-d DUMPNET_CONFIG

Use DUMPNET_CONFIG instead of the default $DUMPNET_HOME/conf/dumpnet.conf.

-C FSTAB_CONFIG

Use FSTAB_CONFIG as the fstab configuration file (the default is ``dumpnet.fstab.conf''). FSTAB_CONFIG can be the path to the configuration file or `-' to read the fstab configuration from STDIN.

HOST_CONFIG

The host configuration file. For the target host 192.168.1.10 it could be conf/192.168.1.10/dumpnet.HOST.conf.

EXAMPLES

Just do a backup of 192.168.1.10 configured in /usr/local/dumpnet/conf/192.168.1.10/dumpnet.HOST.conf with the default fstab config file dumpnet.fstab.conf - if you don't know what you want, you want something like this:

        dumpnet.host.fstab /usr/local/dumpnet/conf/192.168.1.10/dumpnet.HOST.conf

Do a backup of 192.168.1.11 configured in conf/192.168.1.11/dumpnet.HOST.conf with a fstab config of conf/192.168.1.11/dumpnet.fstab2.conf

        dumpnet.host.fstab -C conf/192.168.1.11/dumpnet.fstab2.conf conf/192.168.1.11/dumpnet.HOST.conf

Backup only the filesystem /usr, that is configured in conf/192.168.1.11/dumpnet.fstab.conf. Keep in mind that this way, none of the ``option'' and ``extends'' statements in dumpnet.fstab.conf will make it to the STDIN of dumpnet.host.fstab.

        grep /usr conf/192.168.1.11/dumpnet.fstab.conf | dumpnet.host.fstab -C - conf/192.168.1.11/dumpnet.HOST.conf

Force the use of level 0 and do not update dumpnet.cmddates:

        dumpnet.host.fstab -Nl 0 /usr/local/dumpnet/conf/example.com/dumpnet.HOST.conf

List the files I need to restore all filesystems/directories of 192.168.1.10:

        dumpnet.host.fstab -R /usr/local/dumpnet/conf/192.168.1.10/dumpnet.HOST.conf

Find the backup, I need to restore /home/jdoe/somefile.txt. Please note that the leading slash must be removed. This is because the tar TOC-files do not contain a leading slash (only the dump TOC-files do).

        dumpnet.host.fstab -Rf home/jdoe/somefile.txt /usr/local/dumpnet/conf/192.168.1.10/dumpnet.HOST.conf

EXIT STATUS

dumpnet.host.fstab will return a zero exit status if all calls to dumpnet.host.fstab.dump, dumpnet.host.fstab.tar and dumpnet.host.fstab.rsync exit with 0. In any other case it will return 1.

FILES

 $DUMPNET_HOME/conf/_defaults/dumpnet.fstab.conf
 $DUMPNET_HOME/conf/$host/dumpnet.fstab.conf

SEE ALSO

 dumpnet(8)
 dumpnet.host(8)
 dumpnet.host.fstab.dump(8)
 dumpnet.host.fstab.tar(8)
 dumpnet.host.fstab.rsync(8)
 dumpnet.fstab.conf(8)

AUTHOR

 Lukas Feiler <lukas.feiler@lukasfeiler.com>

COPYRIGHT AND LICENSE

dumpnet is published under the LGPL (GNU LESSER GENERAL PUBLIC LICENSE). Please see the LICENSE file contained in the installation tarball for details. The official web site is http://dumpnet.sourceforge.net.