src/WINNT/doc/install/Documentation/en_US/html/CmdRef/auarf072.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3190/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 5 Nov 1999 at 13:58:29                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Fri, 05 Nov 1999 13:58:29">
   8 <META HTTP-EQUIV="review" CONTENT="Sun, 05 Nov 2000 13:58:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Mon, 05 Nov 2001 13:58:29">
  10 </HEAD><BODY>
  11 <!-- (C) IBM Corporation 2000. All Rights Reserved    -->
  12 <BODY bgcolor="ffffff">
  13 <!-- End Header Records  ============================================ -->
  14 <A NAME="Top_Of_Page"></A>
  15 <H1>Administration Reference</H1>
  16 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf071.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf073.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
  17 <P>
  18 <H2><A NAME="HDRBK_DISKRESTORE" HREF="auarf002.htm#ToC_86">backup diskrestore</A></H2>
  19 <A NAME="IDX4296"></A>
  20 <A NAME="IDX4297"></A>
  21 <A NAME="IDX4298"></A>
  22 <A NAME="IDX4299"></A>
  23 <A NAME="IDX4300"></A>
  24 <A NAME="IDX4301"></A>
  25 <P><STRONG>Purpose</STRONG>
  26 <P>Restores the entire contents of a partition
  27 <P><STRONG>Synopsis</STRONG>
  28 <PRE><B>backup diskrestore -server</B> &lt;<VAR>machine&nbsp;to&nbsp;restore</VAR>>
  29                    <B>-partition</B> &lt;<VAR>partition&nbsp;to&nbsp;restore</VAR>>
  30                    [<B>-portoffset</B> &lt;<VAR>TC&nbsp;port&nbsp;offset</VAR>><SUP>+</SUP>]
  31                    [-<B>newserver</B> &lt;<VAR>destination&nbsp;machine</VAR>>]
  32                    [<B>-newpartition</B> &lt;<VAR>destination&nbsp;partition</VAR>>]
  33                    [<B>-extension</B> &lt;<VAR>new&nbsp;volume&nbsp;name&nbsp;extension</VAR>>]
  34                    [<B>-n</B>]  [<B>-localauth</B>]  [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-help</B>]
  35
  36 <B>backup di -s</B> &lt;<VAR>machine&nbsp;to&nbsp;restore</VAR>> <B>-pa</B> &lt;<VAR>partition&nbsp;to&nbsp;restore</VAR>>
  37           [<B>-po</B> &lt;<VAR>TC&nbsp;port&nbsp;offset</VAR>><SUP>+</SUP>]  [<B>-news</B> &lt;<VAR>destination&nbsp;machine</VAR>>]
  38           [<B>-newp</B> &lt;<VAR>destination&nbsp;partition</VAR>>]  [<B>-e</B> &lt;<VAR>new&nbsp;volume&nbsp;name&nbsp;extension</VAR>>]
  39           [<B>-n</B>]  [<B>-l</B>]  [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-h</B>]
  40 </PRE>
  41 <P><STRONG>Description</STRONG>
  42 <P>The <B>backup diskrestore</B> command restores all of the volumes for
  43 which the Volume Location Database (VLDB) lists a read/write site on the
  44 partition specified with the <B>-server</B> and <B>-partition</B>
  45 arguments. It is useful if a disk or machine failure corrupts or
  46 destroys the data on an entire partition. (To restore any read-only or
  47 backup volumes that resided on the partition, use the <B>vos release</B>
  48 and <B>vos backup</B> commands, respectively, after restoring the
  49 read/write version.)
  50 <P>If restoring only selected volumes to a single site, it is usually more
  51 efficient to use the <B>backup volrestore</B> command. To restore
  52 multiple volumes to many different sites, use the <B>backup
  53 volsetrestore</B> command.
  54 <P>(If the <B>FILE YES</B> instruction appears in the
  55 <B>/usr/afs/backup/CFG_</B><VAR>device_name</VAR> file on the Tape
  56 Coordinator machine associated with the specified port offset, then the Backup
  57 System restores data from the backup data file listed for that port offset in
  58 the Tape Coordinator&#39;s <B>/usr/afs/backup/tapeconfig</B> file,
  59 instead of from tape. For the sake of clarity, the following text
  60 refers to tapes only, but the Backup System handles backup data files in much
  61 the same way.)
  62 <P>The Backup System determines whether the read/write or backup version of
  63 each volume was dumped more recently, and restores the dumps of that version,
  64 starting with the most recent full dump. It resets the creation
  65 timestamp of each restored volume to the date and time at which it begins
  66 restoring the volume (the creation timestamp appears in the
  67 <TT>Creation</TT> field of the output from the <B>vos examine</B> and
  68 <B>vos listvol</B> commands).
  69 <P>If all of the full and incremental dumps of all relevant volumes were not
  70 written on compatible tape devices, use the <B>-portoffset</B> argument to
  71 list multiple port offset numbers in the order in which the tapes are needed
  72 (first list the port offset for the full dump, second the port offset for the
  73 level 1 incremental dump, and so on). This implies that the full dumps
  74 of all relevant volumes must have been written to a type of tape that the
  75 first Tape Coordinator can read, the level 1 incremental dumps to a type of
  76 tape the second Tape Coordinator can read, and so on. If dumps are on
  77 multiple incompatible tape types, use the <B>backup volrestore</B> command
  78 to restore individual volumes, or the <B>backup volsetrestore</B> command
  79 after defining groups of volumes that were dumped to compatible tape
  80 types. For further discussion, see the <I>AFS Administration
  81 Guide</I>.
  82 <P>By default, the Backup System restores the contents of the specified
  83 partition to that same partition. To restore the contents to an
  84 alternate site, combine the following options as indicated. The Backup
  85 System removes each volume from the original site, if it still exists, and
  86 records the change of site in the VLDB.
  87 <UL>
  88 <P><LI>To restore to a different partition on the same file server machine,
  89 provide the <B>-newpartition</B> argument.
  90 <P><LI>To restore to the partition with the same name on a different file server
  91 machine, provide the <B>-newserver</B> argument.
  92 <P><LI>To restore to a completely different site, combine the
  93 <B>-newserver</B> and <B>-newpartition</B> arguments.
  94 </UL>
  95 <P>By default, the Backup System overwrites the contents of existing volumes
  96 with the restored data. To create a new volume to house the restored
  97 data instead, use the <B>-extension</B> argument. The Backup System
  98 creates the new volume at the site designated by the <B>-newserver</B> and
  99 <B>-newpartition</B> arguments if they are used or the <B>-server</B>
 100 and <B>-partition</B> arguments otherwise. It derives the volume
 101 name by adding the extension to the read/write base name listed in the VLDB,
 102 and creates a new VLDB entry. The command does not affect the existing
 103 volume in any way. However, if a volume with the specified extension
 104 also already exists, the command overwrites it.
 105 <P>To print out a list of the tapes containing the needed dumps, without
 106 actually performing the restore operation, include the <B>-n</B> flag
 107 along with the other options to be used on the actual command.
 108 <P>The Tape Coordinator&#39;s default response to this command is to access
 109 the first tape it needs by invoking the <B>MOUNT</B> instruction in the
 110 local <B>CFG_</B><VAR>device_name</VAR> file, or by prompting the backup
 111 operator to insert the tape if there is no <B>MOUNT</B>
 112 instruction. However, if the <B>AUTOQUERY NO</B> instruction
 113 appears in the <B>CFG_</B><VAR>device_name</VAR> file, or if the issuer of
 114 the <B>butc</B> command included the <B>-noautoquery</B> flag, the
 115 Tape Coordinator instead expects the tape to be in the device already.
 116 If it is not, or is the wrong tape, the Tape Coordinator invokes the
 117 <B>MOUNT</B> instruction or prompts the operator. It also invokes
 118 the <B>MOUNT</B> instruction or prompts for any additional tapes needed to
 119 complete the restore operation; the backup operator must arrange to
 120 provide them.
 121 <P><STRONG>Cautions</STRONG>
 122 <P>If issuing this command to recover data after a disk crash or other damage,
 123 be sure not to issue the <B>vos syncserv</B> command first. Doing
 124 so destroys the VLDB record of the volumes that resided on the
 125 partition.
 126 <P><STRONG>Options</STRONG>
 127 <DL>
 128 <P><DT><B>-server
 129 </B><DD>Names the file server machine that the VLDB lists as the site of the
 130 volumes that need to be restored.
 131 <P><DT><B>-partition
 132 </B><DD>Names the partition that the VLDB lists as the site of the volumes that
 133 need to be restored.
 134 <P><DT><B>-portoffset
 135 </B><DD>Specifies one or more port offset numbers (up to a maximum of 128), each
 136 corresponding to a Tape Coordinator to use in the operation. If there
 137 is more than one value, the Backup System uses the first one when restoring
 138 the full dump of each volume, the second one when restoring the level 1
 139 incremental dump of each volume, and so on. It uses the final value in
 140 the list when restoring dumps at the corresponding depth in the dump hierarchy
 141 and at all lower levels.
 142 <P>Provide this argument unless the default value of 0 (zero) is appropriate
 143 for all dumps. If <B>0</B> is just one of the values in the list,
 144 provide it explicitly in the appropriate order.
 145 <P><DT><B>-newserver
 146 </B><DD>Names an alternate file server machine to which to restore the
 147 volumes. If this argument is omitted, the volumes are restored to the
 148 file server machine named by the <B>-server</B> argument.
 149 <P><DT><B>-newpartition
 150 </B><DD>Names an alternate partition to which to restore the data. If this
 151 argument is omitted, the volumes are restored to the partition named by the
 152 <B>-partition</B> argument.
 153 <P><DT><B>-extension
 154 </B><DD>Creates a new volume for each volume being restored, to house the restored
 155 data. The Backup System derives the new volume&#39;s name by appending
 156 the specified string to the read/write base name listed in the VLDB, and
 157 creates a new VLDB volume entry. The Backup System preserves the
 158 contents of the volumes on the partition, if any still exist. Any
 159 string other than <B>.readonly</B> or <B>.backup</B> is
 160 acceptable, but the combination of the base name and extension cannot exceed
 161 22 characters in length. To use a period to separate the extension from
 162 the name, specify it as the first character of the string (as in
 163 <B>.rst</B>, for example).
 164 <P><DT><B>-n
 165 </B><DD>Displays a list of the tapes necessary to perform the requested restore,
 166 without actually performing the operation.
 167 <P><DT><B>-localauth
 168 </B><DD>Constructs a server ticket using a key from the local
 169 <B>/usr/afs/etc/KeyFile</B> file. The <B>backup</B> command
 170 interpreter presents it to the Backup Server, Volume Server and VL Server
 171 during mutual authentication. Do not combine this flag with the
 172 <B>-cell</B> argument. For more details, see the introductory
 173 <B>backup</B> reference page.
 174 <P><DT><B>-cell
 175 </B><DD>Names the cell in which to run the command. Do not combine this
 176 argument with the <B>-localauth</B> flag. For more details, see the
 177 introductory <B>backup</B> reference page.
 178 <P><DT><B>-help
 179 </B><DD>Prints the online help for this command. All other valid options
 180 are ignored.
 181 </DL>
 182 <P><STRONG>Output</STRONG>
 183 <P>If a tape error occurs during the restore operation, the Tape Coordinator
 184 displays the following messages&#58;
 185 <PRE>   Restore operation on volume <VAR>name</VAR> failed due to tape error
 186    Do you want to continue (y/n)?
 187
 188 </PRE>
 189 <P>where <VAR>name</VAR> is the name of the volume that was being restored when
 190 the tape error occurred. Enter the value <B>y</B> to continue the
 191 operation without restoring the indicated volume or the value <B>n</B> to
 192 terminate the operation. In the latter case, the operator can then
 193 attempt to determine the cause of the tape error.
 194 <P>If the issuer includes the <B>-n</B> flag with the command, the
 195 following string appears at the head of the list of the tapes necessary to
 196 perform the restore operation&#58;
 197 <PRE>   Tapes needed&#58;
 198
 199 </PRE>
 200 <P><STRONG>Examples</STRONG>
 201 <P>The following command restores the volumes for which the VLDB lists a
 202 read/write site on the <B>/vicepd</B> partition of the machine
 203 <B>fs5.abc.com</B>. The Tape Coordinator associated
 204 with port offset 3 performs the operation.
 205 <PRE>   % <B>backup diskrestore -server fs5.abc.com -partition /vicepd -portoffset 3</B>
 206
 207 </PRE>
 208 <P>The following command restores the volumes for which the VLDB lists a
 209 read/write site on the <B>/vicepb</B> partition of the machine
 210 <B>fs1.abc.com</B> to a new site&#58; the
 211 <B>/vicepa</B> partition on the machine
 212 <B>fs3.abc.com</B>. The Tape Coordinator associated
 213 with port offset 0 performs the operation. (The command appears here on
 214 two lines only for legibility.)
 215 <PRE>   % <B>backup diskrestore  -server fs1.abc.com -partition /vicepb</B>   \
 216                          <B>-newserver fs3.abc.com -newpartition /vicepa</B>
 217
 218 </PRE>
 219 <P>The following command lists the tapes required to restore the volumes for
 220 which the VLDB lists a read/write site on the <B>/vicepm</B> partition of
 221 the machine <B>fs4.abc.com</B>&#58;
 222 <PRE>   % <B>backup diskrestore -server fs4.abc.com -partition /vicepm -n</B>
 223    Tapes needed&#58;
 224    user.sunday1.1
 225    user.sunday1.2
 226    user.monday1.1
 227    user.tuesday1.1
 228    user.wednesday1.1
 229
 230 </PRE>
 231 <P><STRONG>Privilege Required</STRONG>
 232 <P>The issuer must be listed in the <B>/usr/afs/etc/UserList</B> file on
 233 every machine where the Backup Server or Volume Location (VL) Server is
 234 running, and on every file server machine that houses an affected
 235 volume. If the <B>-localauth</B> flag is included, the issuer must
 236 instead be logged on to a server machine as the local superuser
 237 <B>root</B>.
 238 <P><STRONG>Related Information</STRONG>
 239 <P><A HREF="auarf060.htm#HDRBK_INTRO">backup</A>
 240 <P><A HREF="auarf073.htm#HDRBK_DUMP">backup dump</A>
 241 <P><A HREF="auarf091.htm#HDRBK_VOLRESTORE">backup volrestore</A>
 242 <P><A HREF="auarf092.htm#HDRBK_VOLSETRESTORE">backup volsetrestore</A>
 243 <P><A HREF="auarf126.htm#HDRBUTC">butc</A>
 244 <P><A HREF="auarf255.htm#HDRVOS_BACKUP">vos backup</A>
 245 <P><A HREF="auarf261.htm#HDRVOS_EXAMINE">vos examine</A>
 246 <P><A HREF="auarf266.htm#HDRVOS_LISTVOL">vos listvol</A>
 247 <P><A HREF="auarf270.htm#HDRVOS_RELEASE">vos release</A>
 248 <P>
 249 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf071.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf073.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
 250 <!-- Begin Footer Records  ========================================== -->
 251 <P><HR><B>
 252 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 253 </B>
 254 <!-- End Footer Records  ============================================ -->
 255 <A NAME="Bot_Of_Page"></A>
 256 </BODY></HTML>