backup adddump - Defines a dump level in the dump hierarchy

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]

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.

Names each dump level to add to the dump hierarchy. Precede full dump level names with a slash (for example, CW/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 CW/full and CW/full/incremental1 must exist when the incremental dump level CW/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 (CW.), 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 (CW" ") when issuing the backup adddump command outside interactive mode. 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>] }

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

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

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

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

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

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 CWroot if the -localauth flag is included.

the backup(8) manpage, the backup_deldump(8) manpage, the backup_deletedump(8) manpage, the backup_listdumps(8) manpage, the backup_setexp(8) manpage

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.