| Release Notes | ||
|---|---|---|
| <<< Previous | Reference Pages | Next >>> |
Deletes one or more dump records from the Backup Database
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 [-du <dump id>+] [-fr <date time>+] [-t <date time>+]
[-p <TC port offset>] [-g <group ID>] [-db] [-fo] [-n]
[-l] [-c <cell name>] [-h] |
The backup deletedump command deletes one or more dump records from the Backup Database. Using this command is appropriate when dump records are incorrect (possibly because a dump operation was interrupted or failed), or when they represent dumps that are expired or otherwise no longer needed.
To specify the records to delete, use one of the following arguments or combinations of arguments:
The -dumpid argument deletes the record for each specified dump ID number.
The -groupid argument deletes each record with the specified group ID number. A group ID number is associated with a record if the GROUPID instruction appears in the Tape Coordinator's /usr/afs/backup/CFG_tcid file when the dump is created. To display a dump set's group ID, include the -verbose and -id options to the backup dumpinfo command; the group ID appears in the output's Group id field.
The -from and -to arguments delete the records for all regular dumps created during the time period bracketed by the specified values. The -from argument can be omitted, in which case the command deletes records created before the time specified by the -to argument.
The combination of the -groupid, -to and optionally -from arguments deletes the records for all regular dumps created during the specified time period that are also marked with the specified group ID number.
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 dumps appended to the initial dump.
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 a dump's record makes it impossible to restore data from it or from any dump that refers to the deleted dump as its parent, directly or indirectly. That is, restore operations must begin with a 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. If necessary, use the -dbadd flag to the backup scantape command to regenerate a dump record so that the dump can act as a parent again.
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.
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).
Provide either this argument, the -to (and optionally -from) argument, or the -groupid argument.
Specifies the beginning of a range of dates; the record for any dump created during the indicated period of time is deleted.
Omit this argument to indicate the default of midnight (00:00 hours) on 1 January 1970 (UNIX time zero), or provide a date value in the format mm/dd/yyyy [hh:MM]. The month (mm), day (dd), and year (yyyy) are required. The hour and minutes (hh:MM) are optional, but if provided must be in 24-hour format (for example, the value 14:36 represents 2:36 p.m.). If omitted, the time defaults to midnight (00:00 hours).
The -to argument must be provided along with this one.
Specifies the end of a range of dates; the record of any regular dump created during the range is deleted from the Backup Database. Provide either the value NOW to indicate the current date and time, or a date value in the same format as for the -from argument. Valid values for the year (yyyy) range from 1970 to 2037; higher values are not valid because the latest possible date in the standard UNIX representation is in February 2038. The command interpreter automatically reduces any later date to the maximum value.
If the time portion (hh:MM) is omitted, it defaults to 59 seconds after midnight (00:00:59 hours). Similarly, the backup command interpreter automatically adds 59 seconds to any time value provided. In both cases, adding 59 seconds compensates for how the Backup Database and backup dumpinfo command represent dump creation times in hours and minutes only. For example, the Database records a creation timestamp of 20:55 for any dump operation that begins between 20:55:00 and 20:55:59.
Automatically adding 59 seconds to a time thus includes the records for all dumps created during that minute.
Provide either this argument, the -dumpid argument, or the -groupid argument, or combine this argument and the -groupid argument. This argument is required if the -from argument is provided.
Caution: Specifying the value NOW for this argument when the -from argument is omitted deletes all dump records from the Backup Database (except for Backup Database dump records created with the backup savedb command).
Specifies the port offset number of the Tape Coordinator that communicates with the XBSA server that maintains the records to delete. It must be the Tape Coordinator that transferred AFS data to the XBSA server when the dump was created. The corresponding records in the Backup Database are also deleted.
This argument is meaningful only when deleting records maintained by an XBSA server. Do not combine it with the -dbonly flag.
If this argument is omitted when other options pertinent to an XBSA server are included, the Tape Coordinator with port offset 0 (zero) is used.
Specifies the group ID number that is associated with the records to delete. The Tape Coordinator ignores group IDs if this argument is omitted.
Provide either this argument, the -dumpid argument, or the -to argument, or combine this argument and the -to argument with any options other than the -dumpid argument.
Deletes records from the Backup Database without attempting to delete the corresponding records maintained by an XBSA server. Do not combine this flag with the -port argument or the -force flag.
Deletes the specified records from the Backup Database even when the attempt to delete the corresponding records maintained by an XBSA server fails. Do not combine this flag with the -dbonly flag. To identify the Tape Coordinator when this argument is used, either provide the -port argument or omit it to specify the Tape Coordinator with port offset 0 (zero).
Displays a list of the dump records to be deleted, without actually deleting them. Combine it with the options to be included on the actual command.
Constructs a server ticket using a key from the local /usr/afs/etc/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 the introductory backup reference page.
Names the cell in which to run the command. Do not combine this argument with the -localauth flag. For more details, see the introductory backup reference page.
Prints the online help for this command. All other valid options are ignored.
If the -noexecute flag is not included, the output generated at the conclusion of processing lists the dump IDs of all deleted dump records, in the following format:
The following dumps were deleted:
dump ID 1
dump ID 2
etc. |
The following dumps would have been deleted:
dump ID 1
dump ID 2
etc. |
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:
653777462 |
% backup deletedump -from 01/01/1999 -to 12/31/1999
The following dumps were deleted:
598324045
598346873
...
...
653777523
653779648 |
The issuer must be listed in the /usr/afs/etc/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.
| <<< Previous | Home | Next >>> |
| NetRestrict (server version) | Up | backup dumpinfo |