backup_diskrestore 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_DISKRESTORE(8)	     AFS Command Reference	 BACKUP_DISKRESTORE(8)

NAME
       backup_diskrestore - Restores the entire contents of a partition

SYNOPSIS
       backup diskrestore -server <machine to restore>
	   -partition <partition to restore>
	   [-portoffset <TC port offset>+]
	   [-newserver <destination machine>]
	   [-newpartition <destination partition>]
	   [-extension <new volume name extension>]
	   [-n] [-localauth] [-cell <cell name>] [-help]

       backup di -s <machine to restore>
	   -pa <partition to restore>
	   [-po <TC port offset>+]
	   [-news <destination machine>]
	   [-newp <destination partition>]
	   [-e <new volume name extension>] [-n] [-l]
	   [-c <cell name>] [-h]

DESCRIPTION
       The backup diskrestore command restores all of the volumes for which
       the Volume Location Database (VLDB) lists a read/write site on the
       partition specified with the -server and -partition arguments. It is
       useful if a disk or machine failure corrupts or destroys the data on an
       entire partition. (To restore any read-only or backup volumes that
       resided on the partition, use the vos release and vos backup commands,
       respectively, after restoring the read/write version.)

       If restoring only selected volumes to a single site, it is usually more
       efficient to use the backup volrestore command. To restore multiple
       volumes to many different sites, use the backup volsetrestore command.

       (If the "FILE YES" instruction appears in the
       /usr/afs/backup/CFG_device_name file on the Tape Coordinator machine
       associated with the specified port offset, then the Backup System
       restores data from the backup data file listed for that port offset in
       the Tape Coordinator's /usr/afs/backup/tapeconfig file, instead of from
       tape. For the sake of clarity, the following text refers to tapes only,
       but the Backup System handles backup data files in much the same way.)

       The Backup System determines whether the read/write or backup version
       of each volume was dumped more recently, and restores the dumps of that
       version, starting with the most recent full dump. It resets the
       creation timestamp of each restored volume to the date and time at
       which it begins restoring the volume (the creation timestamp appears in
       the "Creation" field of the output from the vos examine and vos listvol
       commands).

       If all of the full and incremental dumps of all relevant volumes were
       not written on compatible tape devices, use the -portoffset argument to
       list multiple port offset numbers in the order in which the tapes are
       needed (first list the port offset for the full dump, second the port
       offset for the level 1 incremental dump, and so on). This implies that
       the full dumps of all relevant volumes must have been written to a type
       of tape that the first Tape Coordinator can read, the level 1
       incremental dumps to a type of tape the second Tape Coordinator can
       read, and so on. If dumps are on multiple incompatible tape types, use
       the backup volrestore command to restore individual volumes, or the
       backup volsetrestore command after defining groups of volumes that were
       dumped to compatible tape types. For further discussion, see the
       OpenAFS Administration Guide.

       By default, the Backup System restores the contents of the specified
       partition to that same partition. To restore the contents to an
       alternate site, combine the following options as indicated. The Backup
       System removes each volume from the original site, if it still exists,
       and records the change of site in the VLDB.

       ·   To restore to a different partition on the same file server
	   machine, provide the -newpartition argument.

       ·   To restore to the partition with the same name on a different file
	   server machine, provide the -newserver argument.

       ·   To restore to a completely different site, combine the -newserver
	   and -newpartition arguments.

       By default, the Backup System overwrites the contents of existing
       volumes with the restored data. To create a new volume to house the
       restored data instead, use the -extension argument. The Backup System
       creates the new volume at the site designated by the -newserver and
       -newpartition arguments if they are used or the -server and -partition
       arguments otherwise. It derives the volume name by adding the extension
       to the read/write base name listed in the VLDB, and creates a new VLDB
       entry. The command does not affect the existing volume in any way.
       However, if a volume with the specified extension also already exists,
       the command overwrites it.

       To print out a list of the tapes containing the needed dumps, without
       actually performing the restore operation, include the -n flag along
       with the other options to be used on the actual command.

       The Tape Coordinator's default response to this command is to access
       the first tape it needs by invoking the "MOUNT" instruction in the
       local CFG_device_name file, or by prompting the backup operator to
       insert the tape if there is no "MOUNT" instruction. However, if the
       "AUTOQUERY NO" instruction appears in the CFG_device_name file, or if
       the issuer of the butc command included the -noautoquery flag, the Tape
       Coordinator instead expects the tape to be in the device already.  If
       it is not, or is the wrong tape, the Tape Coordinator invokes the
       "MOUNT" instruction or prompts the operator. It also invokes the
       "MOUNT" instruction or prompts for any additional tapes needed to
       complete the restore operation; the backup operator must arrange to
       provide them.

CAUTIONS
       If issuing this command to recover data after a disk crash or other
       damage, be sure not to issue the vos syncserv command first. Doing so
       destroys the VLDB record of the volumes that resided on the partition.

OPTIONS
       -server <machine to restore>
	   Names the file server machine that the VLDB lists as the site of
	   the volumes that need to be restored.

       -partition <partition to restore>
	   Names the partition that the VLDB lists as the site of the volumes
	   that need to be restored.

       -portoffset <TC port offset>+
	   Specifies one or more port offset numbers (up to a maximum of 128),
	   each corresponding to a Tape Coordinator to use in the operation.
	   If there is more than one value, the Backup System uses the first
	   one when restoring the full dump of each volume, the second one
	   when restoring the level 1 incremental dump of each volume, and so
	   on. It uses the final value in the list when restoring dumps at the
	   corresponding depth in the dump hierarchy and at all lower levels.

	   Provide this argument unless the default value of 0 (zero) is
	   appropriate for all dumps. If 0 is just one of the values in the
	   list, provide it explicitly in the appropriate order.

       -newserver <destination machine>
	   Names an alternate file server machine to which to restore the
	   volumes. If this argument is omitted, the volumes are restored to
	   the file server machine named by the -server argument.

       -newpartition <destination partition>
	   Names an alternate partition to which to restore the data. If this
	   argument is omitted, the volumes are restored to the partition
	   named by the -partition argument.

       -extension <new volume name extension>
	   Creates a new volume for each volume being restored, to house the
	   restored data. The Backup System derives the new volume's name by
	   appending the specified string to the read/write base name listed
	   in the VLDB, and creates a new VLDB volume entry. The Backup System
	   preserves the contents of the volumes on the partition, if any
	   still exist. Any string other than ".readonly" or ".backup" is
	   acceptable, but the combination of the base name and extension
	   cannot exceed 22 characters in length. To use a period to separate
	   the extension from the name, specify it as the first character of
	   the string (as in ".rst", for example).

       -n  Displays a list of the tapes necessary to perform the requested
	   restore, without actually performing the operation.

       -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
       If a tape error occurs during the restore operation, the Tape
       Coordinator displays the following messages:

	  Restore operation on volume I<name> failed due to tape error
	  Do you want to continue (y/n)?

       where name is the name of the volume that was being restored when the
       tape error occurred. Enter the value y to continue the operation
       without restoring the indicated volume or the value "n" to terminate
       the operation. In the latter case, the operator can then attempt to
       determine the cause of the tape error.

       If the issuer includes the -n flag with the command, the following
       string appears at the head of the list of the tapes necessary to
       perform the restore operation:

	  Tapes needed:

EXAMPLES
       The following command restores the volumes for which the VLDB lists a
       read/write site on the /vicepd partition of the machine "fs5.abc.com".
       The Tape Coordinator associated with port offset 3 performs the
       operation.

	  % backup diskrestore -server fs5.abc.com -partition /vicepd -portoffset 3

       The following command restores the volumes for which the VLDB lists a
       read/write site on the /vicepb partition of the machine "fs1.abc.com"
       to a new site: the /vicepa partition on the machine "fs3.abc.com". The
       Tape Coordinator associated with port offset 0 performs the operation.
       (The command appears here on two lines only for legibility.)

	  % backup diskrestore	-server fs1.abc.com -partition /vicepb	 \
				-newserver fs3.abc.com -newpartition /vicepa

       The following command lists the tapes required to restore the volumes
       for which the VLDB lists a read/write site on the /vicepm partition of
       the machine "fs4.abc.com":

	  % backup diskrestore -server fs4.abc.com -partition /vicepm -n
	  Tapes needed:
	  user.sunday1.1
	  user.sunday1.2
	  user.monday1.1
	  user.tuesday1.1
	  user.wednesday1.1

PRIVILEGE REQUIRED
       The issuer must be listed in the /usr/afs/etc/UserList file on every
       machine where the Backup Server or Volume Location (VL) Server is
       running, and on every file server machine that houses an affected
       volume. If the -localauth flag is included, the issuer must instead be
       logged on to a server machine as the local superuser "root".

SEE ALSO
       butc(5), backup(8), backup_dump(8), backup_volrestore(8),
       backup_volsetrestore(8), butc(8), vos_backup(1), vos_examine(1),
       vos_listvol(1), vos_release(1)

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_DISKRESTORE(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