backup_adddump 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_ADDDUMP(8)	     AFS Command Reference	     BACKUP_ADDDUMP(8)

NAME
       backup_adddump - Defines a dump level in the dump hierarchy

SYNOPSIS
       backup adddump -dump <dump level name>+
	   [-expires <expiration date>+]
	   [-localauth] [-cell <cell name>] [-help]

       backup addd -d <dump level name>+
	   [-e <expiration date>+]
	   [-l] [-c <cell name>] [-h]

DESCRIPTION
       The backup adddump command creates one or more dump levels in the dump
       hierarchy stored in the Backup Database, and optionally assigns an
       expiration date to each one. All of the dump levels in the Backup
       Database collectively constitute the dump hierarchy.

       Use the -expires argument to associate an expiration date with each
       dump level. When the Backup System subsequently creates a dump at the
       dump level, it uses the specified value to derive the dump's expiration
       date, which it records on the label of the tape (or backup data file).
       The Backup System refuses to overwrite a tape until after the latest
       expiration date of any dump that the tape contains, unless the backup
       labeltape command is used to relabel the tape. If a dump level does not
       have an expiration date, the Backup System treats dumps created at the
       level as expired as soon as it creates them.

       (Note that the Backup System does not automatically remove a dump's
       record from the Backup Database when the dump reaches its expiration
       date, but only if the tape that contains the dump is recycled or
       relabeled. To remove expired and other obsolete dump records, use the
       backup deletedump command.)

       Define either an absolute or relative expiration date:

       ·   An absolute expiration date defines the month/day/year (and,
	   optionally, hour and minutes) at which a dump expires. If the
	   expiration date predates the dump creation time, the Backup System
	   immediately treats the dump as expired.

       ·   A relative date defines the number of years, months, or days (or a
	   combination of the three) after the dump's creation that it
	   expires. When the Backup System creates a dump at the dump level,
	   it calculates an actual expiration date by adding the relative date
	   to the start time of the dump operation.

OPTIONS
       -dump <dump level name>+
	   Names each dump level to add to the dump hierarchy. Precede full
	   dump level names with a slash (for example, "/full"). Indicate an
	   incremental dump level by preceding it with an ordered list of the
	   dump levels directly above it in the hierarchy (its parent dump
	   levels); use the slash as a separator. The parent dump levels must
	   already exist. For example, the dump levels "/full" and
	   "/full/incremental1" must exist when the incremental dump level
	   "/full/incremental1/incremental2" is created.

	   Dump level names can have any number of levels, but cannot exceed
	   256 characters in length, including the slashes. The maximum length
	   for any single level (the text between slashes) is 28 characters,
	   not including the preceding slash.

	   All alphanumeric characters are allowed in dump level names. Do not
	   use the period ("."), however, because it is the separator between
	   the volume set name and dump level name in the dump name assigned
	   automatically by the backup dump command. It is best not to include
	   other metacharacters either; if using them, enclose them in double
	   quotes (" ") when issuing the backup adddump command outside
	   interactive mode.

       -expires <expiration date>+
	   Defines the absolute or relative expiration date to associate with
	   each dump level named by the -dump argument. Absolute expiration
	   dates have the following format:

	      [at] {NEVER | <mm>/<dd>/<yyyy> [<hh>:<MM>] }

	   where the optional word at is followed either by the string
	   "NEVER", which indicates that dumps created at the dump level never
	   expire, or by a date value with a required portion (<mm> for month,
	   <dd> for day, and <yyyy> for year) and an optional portion (<hh>
	   for hours and <MM> for minutes).

	   Omit the hh:MM portion to use the default of midnight (00:00
	   hours), or provide a value in 24-hour format (for example, "20:30"
	   is 8:30 p.m.).  Valid values for the year 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 later dates to the maximum value.

	   Relative expiration dates have the following format:

	      [in] [<years>y] [<months>m] [<days>d]

	   where the optional word in is followed by at least one of a number
	   of years (maximum 9999) followed by the letter "y", a number of
	   months (maximum 12) followed by the letter "m", or a number of days
	   (maximum 31) followed by the letter "d". If providing more than one
	   of the three, list them in the indicated order. If the date that
	   results from adding the relative expiration value to a dump's
	   creation time is later than the latest possible date in the UNIX
	   time representation, the Backup System automatically reduces it to
	   that date.

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

EXAMPLES
       The following command defines a full dump called "/1999" with a
       relative expiration date of one year:

	  % backup adddump -dump /1999 -expires in 1y

       The following command defines an incremental dump called
       "/sunday1/monday"1 with a relative expiration date of 13 days:

	  % backup adddump -dump /sunday1/monday1 -expires in 13d

       The following command defines two dump incremental dump levels,
       "/Monthly/Week1" and "/Monthly/Week2". Their parent, the full dump
       level "/Monthly", must already exist. The expiration date for both
       levels is 12:00 a.m. on 1 January 2000.

	  % backup adddump -dump /Monthly/Week1 /Monthly/Week2 -expires at 01/01/2000

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_deldump(8), backup_deletedump(8),
       backup_listdumps(8), backup_setexp(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_ADDDUMP(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