mirror of
https://git.openafs.org/openafs.git
synced 2025-01-19 15:30:14 +00:00
330 lines
18 KiB
XML
330 lines
18 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<refentry id="backup_diskrestore8">
|
|
<refmeta>
|
|
<refentrytitle>backup diskrestore</refentrytitle>
|
|
<manvolnum>8</manvolnum>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>backup diskrestore</refname>
|
|
<refpurpose>Restores the entire contents of a partition</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Synopsis</title>
|
|
<para><emphasis role="bold">backup diskrestore</emphasis> <emphasis role="bold">-server</emphasis> <<emphasis>machine to restore</emphasis>>
|
|
<emphasis role="bold">-partition</emphasis> <<emphasis>partition to restore</emphasis>>
|
|
[<emphasis role="bold">-portoffset</emphasis> <<emphasis>TC port offset</emphasis>>+]
|
|
[<emphasis role="bold">-newserver</emphasis> <<emphasis>destination machine</emphasis>>]
|
|
[<emphasis role="bold">-newpartition</emphasis> <<emphasis>destination partition</emphasis>>]
|
|
[<emphasis role="bold">-extension</emphasis> <<emphasis>new volume name extension</emphasis>>]
|
|
[<emphasis role="bold">-n</emphasis>] [<emphasis role="bold">-localauth</emphasis>] [<emphasis role="bold">-cell</emphasis> <<emphasis>cell name</emphasis>>] [<emphasis role="bold">-help</emphasis>]</para>
|
|
|
|
<para><emphasis role="bold">backup di</emphasis> <emphasis role="bold">-s</emphasis> <<emphasis>machine to restore</emphasis>> <emphasis role="bold">-pa</emphasis> <<emphasis>partition to restore</emphasis>>
|
|
[<emphasis role="bold">-po</emphasis> <<emphasis>TC port offset</emphasis>>+] [<emphasis role="bold">-news</emphasis> <<emphasis>destination machine</emphasis>>]
|
|
[<emphasis role="bold">-newp</emphasis> <<emphasis>destination partition</emphasis>>]
|
|
[<emphasis role="bold">-e</emphasis> <<emphasis>new volume name extension</emphasis>>] [<emphasis role="bold">-n</emphasis>] [<emphasis role="bold">-l</emphasis>]
|
|
[<emphasis role="bold">-c</emphasis> <<emphasis>cell name</emphasis>>] [<emphasis role="bold">-h</emphasis>]</para>
|
|
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<para>The <emphasis role="bold">backup diskrestore</emphasis> command restores all of the volumes for which
|
|
the Volume Location Database (VLDB) lists a read/write site on the
|
|
partition specified with the <emphasis role="bold">-server</emphasis> and <emphasis role="bold">-partition</emphasis> 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 <emphasis role="bold">vos release</emphasis> and <emphasis role="bold">vos backup</emphasis> commands,
|
|
respectively, after restoring the read/write version.)</para>
|
|
|
|
<para>If restoring only selected volumes to a single site, it is usually more
|
|
efficient to use the <emphasis role="bold">backup volrestore</emphasis> command. To restore multiple
|
|
volumes to many different sites, use the <emphasis role="bold">backup volsetrestore</emphasis> command.</para>
|
|
|
|
<para>(If the <computeroutput>FILE YES</computeroutput> instruction appears in the
|
|
<replaceable>/usr/afs/backup/CFG_</replaceable><emphasis>device_name</emphasis><replaceable></replaceable> 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 <replaceable>/usr/afs/backup/tapeconfig</replaceable> 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.)</para>
|
|
|
|
<para>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 <computeroutput>Creation</computeroutput>
|
|
field of the output from the <emphasis role="bold">vos examine</emphasis> and <emphasis role="bold">vos listvol</emphasis> commands).</para>
|
|
|
|
<para>If all of the full and incremental dumps of all relevant volumes were not
|
|
written on compatible tape devices, use the <emphasis role="bold">-portoffset</emphasis> 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 <emphasis role="bold">backup
|
|
volrestore</emphasis> command to restore individual volumes, or the <emphasis role="bold">backup
|
|
volsetrestore</emphasis> command after defining groups of volumes that were dumped
|
|
to compatible tape types. For further discussion, see the <emphasis>IBM AFS
|
|
Administration Guide</emphasis>.</para>
|
|
|
|
<para>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.</para>
|
|
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>To restore to a different partition on the same file server machine,
|
|
provide the <emphasis role="bold">-newpartition</emphasis> argument.</para>
|
|
|
|
</listitem>
|
|
<listitem>
|
|
<para>To restore to the partition with the same name on a different file server
|
|
machine, provide the <emphasis role="bold">-newserver</emphasis> argument.</para>
|
|
|
|
</listitem>
|
|
<listitem>
|
|
<para>To restore to a completely different site, combine the <emphasis role="bold">-newserver</emphasis> and
|
|
<emphasis role="bold">-newpartition</emphasis> arguments.</para>
|
|
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>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 <emphasis role="bold">-extension</emphasis> argument. The Backup System creates the new
|
|
volume at the site designated by the <emphasis role="bold">-newserver</emphasis> and <emphasis role="bold">-newpartition</emphasis>
|
|
arguments if they are used or the <emphasis role="bold">-server</emphasis> and <emphasis role="bold">-partition</emphasis> 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.</para>
|
|
|
|
<para>To print out a list of the tapes containing the needed dumps, without
|
|
actually performing the restore operation, include the <emphasis role="bold">-n</emphasis> flag along
|
|
with the other options to be used on the actual command.</para>
|
|
|
|
<para>The Tape Coordinator's default response to this command is to access the
|
|
first tape it needs by invoking the <computeroutput>MOUNT</computeroutput> instruction in the local
|
|
<replaceable>CFG_</replaceable><emphasis>device_name</emphasis><replaceable></replaceable> file, or by prompting the backup operator to insert
|
|
the tape if there is no <computeroutput>MOUNT</computeroutput> instruction. However, if the <computeroutput>AUTOQUERY
|
|
NO</computeroutput> instruction appears in the <replaceable>CFG_</replaceable><emphasis>device_name</emphasis><replaceable></replaceable> file, or if the
|
|
issuer of the <emphasis role="bold">butc</emphasis> command included the <emphasis role="bold">-noautoquery</emphasis> 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 <computeroutput>MOUNT</computeroutput>
|
|
instruction or prompts the operator. It also invokes the <computeroutput>MOUNT</computeroutput>
|
|
instruction or prompts for any additional tapes needed to complete the
|
|
restore operation; the backup operator must arrange to provide them.</para>
|
|
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>Cautions</title>
|
|
<para>If issuing this command to recover data after a disk crash or other
|
|
damage, be sure not to issue the <emphasis role="bold">vos syncserv</emphasis> command first. Doing so
|
|
destroys the VLDB record of the volumes that resided on the partition.</para>
|
|
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>Options</title>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><emphasis role="bold">-server</emphasis> <<emphasis>machine to restore</emphasis>></term>
|
|
<listitem>
|
|
<para>Names the file server machine that the VLDB lists as the site of the
|
|
volumes that need to be restored.</para>
|
|
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><emphasis role="bold">-partition</emphasis> <<emphasis>partition to restore</emphasis>></term>
|
|
<listitem>
|
|
<para>Names the partition that the VLDB lists as the site of the volumes that
|
|
need to be restored.</para>
|
|
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><emphasis role="bold">-portoffset</emphasis> <<emphasis>TC port offset</emphasis>>+</term>
|
|
<listitem>
|
|
<para>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.</para>
|
|
|
|
<para>Provide this argument unless the default value of 0 (zero) is appropriate
|
|
for all dumps. If <computeroutput>0</computeroutput> is just one of the values in the list, provide it
|
|
explicitly in the appropriate order.</para>
|
|
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><emphasis role="bold">-newserver</emphasis> <<emphasis>destination machine</emphasis>></term>
|
|
<listitem>
|
|
<para>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 <emphasis role="bold">-server</emphasis> argument.</para>
|
|
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><emphasis role="bold">-newpartition</emphasis> <<emphasis>destination partition</emphasis>></term>
|
|
<listitem>
|
|
<para>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 <emphasis role="bold">-partition</emphasis> argument.</para>
|
|
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><emphasis role="bold">-extension</emphasis> <<emphasis>new volume name extension</emphasis>></term>
|
|
<listitem>
|
|
<para>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
|
|
<computeroutput>.readonly</computeroutput> or <computeroutput>.backup</computeroutput> 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 <computeroutput>.rst</computeroutput>, for example).</para>
|
|
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><emphasis role="bold">-n</emphasis></term>
|
|
<listitem>
|
|
<para>Displays a list of the tapes necessary to perform the requested restore,
|
|
without actually performing the operation.</para>
|
|
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><emphasis role="bold">-localauth</emphasis></term>
|
|
<listitem>
|
|
<para>Constructs a server ticket using a key from the local
|
|
<replaceable>/usr/afs/etc/KeyFile</replaceable> file. The <emphasis role="bold">backup</emphasis> command interpreter presents
|
|
it to the Backup Server, Volume Server and VL Server during mutual
|
|
authentication. Do not combine this flag with the <emphasis role="bold">-cell</emphasis> argument. For
|
|
more details, see <link linkend="backup8">backup(8)</link>.</para>
|
|
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><emphasis role="bold">-cell</emphasis> <<emphasis>cell name</emphasis>></term>
|
|
<listitem>
|
|
<para>Names the cell in which to run the command. Do not combine this argument
|
|
with the <emphasis role="bold">-localauth</emphasis> flag. For more details, see <link linkend="backup8">backup(8)</link>.</para>
|
|
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><emphasis role="bold">-help</emphasis></term>
|
|
<listitem>
|
|
<para>Prints the online help for this command. All other valid options are
|
|
ignored.</para>
|
|
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>Output</title>
|
|
<para>If a tape error occurs during the restore operation, the Tape Coordinator
|
|
displays the following messages:</para>
|
|
|
|
<programlisting>
|
|
Restore operation on volume I&lt;name&gt; failed due to tape error
|
|
Do you want to continue (y/n)?
|
|
|
|
</programlisting>
|
|
<para>where <emphasis>name</emphasis> is the name of the volume that was being restored when the
|
|
tape error occurred. Enter the value <emphasis role="bold">y</emphasis> to continue the operation
|
|
without restoring the indicated volume or the value <computeroutput>n</computeroutput> to terminate the
|
|
operation. In the latter case, the operator can then attempt to determine
|
|
the cause of the tape error.</para>
|
|
|
|
<para>If the issuer includes the <emphasis role="bold">-n</emphasis> flag with the command, the following
|
|
string appears at the head of the list of the tapes necessary to perform
|
|
the restore operation:</para>
|
|
|
|
<programlisting>
|
|
Tapes needed:
|
|
|
|
</programlisting>
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>Examples</title>
|
|
<para>The following command restores the volumes for which the VLDB lists a
|
|
read/write site on the <replaceable>/vicepd</replaceable> partition of the machine
|
|
<computeroutput>fs5.abc.com</computeroutput>. The Tape Coordinator associated with port offset 3
|
|
performs the operation.</para>
|
|
|
|
<programlisting>
|
|
% backup diskrestore -server fs5.abc.com -partition /vicepd -portoffset 3
|
|
|
|
</programlisting>
|
|
<para>The following command restores the volumes for which the VLDB lists a
|
|
read/write site on the <replaceable>/vicepb</replaceable> partition of the machine <computeroutput>fs1.abc.com</computeroutput>
|
|
to a new site: the <replaceable>/vicepa</replaceable> partition on the machine <computeroutput>fs3.abc.com</computeroutput>. The
|
|
Tape Coordinator associated with port offset 0 performs the
|
|
operation. (The command appears here on two lines only for legibility.)</para>
|
|
|
|
<programlisting>
|
|
% backup diskrestore -server fs1.abc.com -partition /vicepb \
|
|
-newserver fs3.abc.com -newpartition /vicepa
|
|
|
|
</programlisting>
|
|
<para>The following command lists the tapes required to restore the volumes for
|
|
which the VLDB lists a read/write site on the <replaceable>/vicepm</replaceable> partition of the
|
|
machine <computeroutput>fs4.abc.com</computeroutput>:</para>
|
|
|
|
<programlisting>
|
|
% 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
|
|
|
|
</programlisting>
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>Privilege Required</title>
|
|
<para>The issuer must be listed in the <replaceable>/usr/afs/etc/UserList</replaceable> 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
|
|
<emphasis role="bold">-localauth</emphasis> flag is included, the issuer must instead be logged on to a
|
|
server machine as the local superuser <computeroutput>root</computeroutput>.</para>
|
|
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>See Also</title>
|
|
<para><link linkend="butc5">butc(5)</link>,
|
|
<link linkend="backup8">backup(8)</link>,
|
|
<link linkend="backup_dump8">backup_dump(8)</link>,
|
|
<link linkend="backup_volrestore8">backup_volrestore(8)</link>,
|
|
<link linkend="backup_volsetrestore8">backup_volsetrestore(8)</link>,
|
|
<link linkend="butc8">butc(8)</link>,
|
|
<link linkend="vos_backup1">vos_backup(1)</link>,
|
|
<link linkend="vos_examine1">vos_examine(1)</link>,
|
|
<link linkend="vos_listvol1">vos_listvol(1)</link>,
|
|
<link linkend="vos_release1">vos_release(1)</link></para>
|
|
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>Copyright</title>
|
|
<para>IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.</para>
|
|
|
|
<para>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.</para>
|
|
|
|
</refsect1>
|
|
</refentry>
|