backup_deletedump man page on Scientific

Man page or keyword search:  
man Server   26626 pages
apropos Keyword Search (all sections)
Output format
Scientific logo
[printable version]

BACKUP_DELETEDUMP(8)	     AFS Command Reference	  BACKUP_DELETEDUMP(8)

NAME
       backup_deletedump - Deletes one or more dump records from the Backup
       Database

SYNOPSIS
       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).

	   Provide either this argument or the -to (and optionally -from)
	   argument.

       -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.

	   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.

       -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.

	   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, or the -dumpid 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).

       -localauth
	   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 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:
	       653777462

       The 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 /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.

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.

OpenAFS				  2013-10-09		  BACKUP_DELETEDUMP(8)
[top]

List of man pages available for Scientific

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net