dumpnet.host.fstab.dump - backup a single filesystems using dump
- BACKUP MODE
-
dumpnet.host.fstab.dump [-N] [-t] [-S] [-n DIRNAME] [-c COMPRESSION] [-l LEVEL] [-s SESSIONID] [-d DUMPNET_CONFIG] MOUNT_POINT HOST_CONFIG
- RESOTRE MODE
-
dumpnet.host.fstab.dump -R [-S] [-v] [-f FILE] [-n DIRNAME] [-d DUMPNET_CONFIG] MOUNT_POINT HOST_CONFIG
dumpnet.host.fstab.dump does a backup of a single filesystem specified by MOUNT_POINT using dump(8). It will call dumpnet.host.userdefined.cmd to do most of the job. All command options are the same as for dumpnet.host.fstab.tar(8) and dumpnet.host.fstab.rsync.
If you already have an entry for the filesystem to backup in a dumpnet.fstab.conf file it is recommended to call dumpnet.host.fstab and grep the specific line you need into it. Please see the EXAMPLES section in dumpnet.host.fstab(8).
dumpnet.host.fstab.dump will use dump's -T option to produce incremental backups - not explicit numerical levels. This is because the use of explicit levels would make dump dependent on the file /etc/dumpdates on the target host. If someone tampered with that file we would end up with an inconsitant backup. You could therefore theoretically use two different dumpnet hosts to backup the same target host. A welcome side-effect is that you can use dumpnet.host.fstab.dump also for backups of directories that are not a filesystem root.
- 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).
- -t
-
Create a separate file to store the TOC (Table Of Contents). It will be named like the dump file with the extension .toc appended. To generate a TOC, the restore utility will be used. Its location can be specified by the $local_restore variable in dumpnet.conf(8).
- -S
-
Use sudo to run the command that creates the dump.
- -n DIRNAME
-
The name of the sub-directory where the dumps are to be stored: $backupDir/$host/$dirname. When backing up a top-level mount point (like /usr or /var) it is recommended to use the name of the backuped directory (``usr'' or ``var''). If this option is not specified the dirname is generated by replacing all slashes (`/') in MOUNT_POINT. For example /home/jdoe/somedir would become ``homejdoesomedir''.
- -c COMPRESSION
-
Compression of the dump: ``remote'', ``local'' or ``none''.
- remote
-
Does the compression on the target host before transferring the data. This requires more CPU-resources on the target host but is fastest on slow connections. It is recommended for use over the Internet.
- local
-
Does the compression on the backup machine after transferring the data. This is easyier to handle for the target host but requires a fast connection and a lot of CPU-power on the backup machine.
- none
-
Does no compression at all. Choose this option if the data is already compressed or if you always need it to be available in uncrompressed form for some reason.
- -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.
- MOUNT_POINT
-
The mountpoint of the filesystem to backup.
- 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.
- -S
-
sudo was used to run the command that created the dump.
- -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.
- -n DIRNAME
-
The name of the sub-directory where the dumps are stored: $backupDir/$host/$dirname. If this option is not specified the dirname is generated by replacing all slashes (`/') in MOUNT_POINT. For example /home/jdoe/somedir would become ``homejdoesomedir''.
- -d DUMPNET_CONFIG
-
Use DUMPNET_CONFIG instead of the default $DUMPNET_HOME/conf/dumpnet.conf.
- MOUNT_POINT
-
The mountpoint of the filesystem to restore.
- 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.
Do a dump of the filesystem 192.168.1.10:/usr
dumpnet.host.fstab.dump /usr conf/192.168.1.10/dumpnet.HOST.conf
Do a backup of 192.168.1.11:/ compress it remotly and save it in $backupDir/$host/ROOT/
dumpnet.host.fstab.dump -n ROOT -c remote / conf/192.168.1.11/dumpnet.HOST.conf
Like the previous but force the use of level 0, generate a TOC and do not update dumpnet.cmddates:
dumpnet.host.fstab.dump -Ntn ROOT -c remote -l 0 / conf/192.168.1.11/dumpnet.HOST.conf
List the files I need to restore 192.168.1.10:/usr (dumps stored in the subdir usr)
dumpnet.host.fstab.dump -R /usr conf/192.168.1.10/dumpnet.HOST.conf
Find the dump of 192.168.1.10:/home I need to restore /home/jdoe/somefile.txt.
dumpnet.host.fstab.dump -Rf home/jdoe/somefile.txt /home conf/192.168.1.10/dumpnet.HOST.conf
dumpnet.host.fstab.dump will return a zero exit status if the call to dumpnet.host.userdefined.cmd exits with 0. In any other case it will return 1.
dumpnet(8)
dumpnet.host(8)
dumpnet.host.fstab(8)
Lukas Feiler <lukas.feiler@lukasfeiler.com>
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.