table of contents
other versions
- wheezy 1.6.1-3+deb7u5
- wheezy-backports 1.6.9-2+deb8u4~bpo70+1
- jessie 1.6.9-2+deb8u5
- jessie-backports 1.6.18.2-1~bpo8+1
- testing 1.6.20-2
- unstable 1.6.20-2
- experimental 1.8.0~pre1-5
BACKUP_DELETEDUMP(8) | AFS Command Reference | BACKUP_DELETEDUMP(8) |
NAME¶
backup_deletedump - Deletes one or more dump records from the Backup DatabaseSYNOPSIS¶
backup deletedump [-dumpid <dump id>+][ -from <date time>+]
[ -to <date time>+]
[ -port <TC port offset>]
[ -groupid <group ID>]
[ -dbonly] [-force] [-noexecute] [-localauth]
[ -cell <cell name>]
[ -help] backup dele [-d <dump id>+]
[ -fr <date time>+]
[-t < date time>+]
[ -p <TC port offset>]
[ -g <group ID>]
[ -db] [-fo] [-n] [-l]
[ -c <cell name>]
[ -h]
DESCRIPTION¶
The backup deletedump command deletes one or more dump records from the Backup Database. Either use the -dumpid argument to specify the dump ID number of one or more dumps, or use the -from and -to arguments to delete the records for all regular dumps created during the time period bracketed by the specified values. Use this command to remove dump records that are incorrect (possibly because a dump operation was interrupted or failed), or that correspond to dumps that are expired or otherwise no longer needed.CAUTIONS¶
The only way to remove the dump record for an appended dump is to remove the record for its initial dump, and doing so removes the records for all of the initial dump's associated appended dumps. The only way to remove the record for a Backup Database dump (created with the backup savedb command) is to specify its dump ID number with the -dumpid argument. Using the -from and -to arguments never removes database dump records. Removing records of a dump makes it impossible to restore data from the corresponding tapes or from any dump that refers to the deleted dump as its parent, directly or indirectly. That is, restore operations must begin with the full dump and continue with each incremental dump in order. If the records for a specific dump are removed, it is not possible to restore data from later incremental dumps unless the deleted records are restored by running the backup scantape command with the -dbadd flag. If a dump set contains any dumps that were created outside the time range specified by the -from and -to arguments, the command does not delete any of the records associated with the dump set, even if some of them represent dumps created during the time range.OPTIONS¶
- -dumpid <dump id>+
- Specifies the dump ID of each dump record to delete. The
corresponding dumps must be initial dumps; it is not possible to delete
appended dump records directly, but only by deleting the record of their
associated initial dump. Using this argument is the only way to delete
records of Backup Database dumps (created with the backup savedb
command).
- -from <date time>+
- Specifies the beginning of a range of dates; the record for
any dump created during the indicated period of time is deleted.
- -to <date time>+
- Specifies the end of a range of dates; the record of any
dump created during the range is deleted from the Backup Database.
- -localauth
- Constructs a server ticket using a key from the local /etc/openafs/server/KeyFile file. The backup command interpreter presents it to the Backup Server, Volume Server and VL Server during mutual authentication. Do not combine this flag with the -cell argument. For more details, see backup(8).
- -cell <cell name>
- Names the cell in which to run the command. Do not combine this argument with the -localauth flag. For more details, see backup(8).
- -help
- Prints the online help for this command. All other valid options are ignored.
OUTPUT¶
At the conclusion of processing, the output lists the dump IDs of all dump records deleted in the following format:The following dumps were deleted: dump ID 1 dump ID 2 etc.
EXAMPLES¶
The following command deletes the dump record with dump ID 653777462, and for any appended dumps associated with it:% backup deletedump -dumpid 653777462 The following dumps were deleted: 653777462The following command deletes the Backup Database record of all dumps created between midnight on 1 January 1997 and 23:59:59 hours on 31 December 1997:
% backup deletedump -from 01/01/1997 -to 12/31/1997 The following dumps were deleted: 598324045 598346873 ... ... 653777523 653779648
PRIVILEGE REQUIRED¶
The issuer must be listed in the /etc/openafs/server/UserList file on every machine where the Backup Server is running, or must be logged onto a server machine as the local superuser "root" if the -localauth flag is included.SEE ALSO¶
backup(8), backup_dumpinfo(8), backup_scantape(8)COPYRIGHT¶
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved. This documentation is covered by the IBM Public License Version 1.0. It was converted from HTML to POD by software written by Chas Williams and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.2014-06-12 | OpenAFS |