src/WINNT/doc/install/Documentation/en_US/html/CmdRef/auarf089.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="auarf088.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="auarf090.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_STATUS" HREF="auarf002.htm#ToC_103">backup status</A></H2>
  19 <A NAME="IDX4412"></A>
  20 <A NAME="IDX4413"></A>
  21 <A NAME="IDX4414"></A>
  22 <A NAME="IDX4415"></A>
  23 <P><STRONG>Purpose</STRONG>
  24 <P>Reports a Tape Coordinator&#39;s status
  25 <P><STRONG>Synopsis</STRONG>
  26 <PRE><B>backup status</B> [<B>-portoffset</B> &lt;<VAR>TC&nbsp;port&nbsp;offset</VAR>>]
  27               [<B>-localauth</B>]  [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-help</B>]
  28
  29 <B>backup st</B> [<B>-p</B> &lt;<VAR>TC&nbsp;port&nbsp;offset</VAR>>]  [<B>-l</B>]  [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-h</B>]
  30 </PRE>
  31 <P><STRONG>Description</STRONG>
  32 <P>The <B>backup status</B> command displays which operation, if any, the
  33 indicated Tape Coordinator is currently executing.
  34 <P><STRONG>Options</STRONG>
  35 <DL>
  36 <P><DT><B>-portoffset
  37 </B><DD>Specifies the port offset number of the Tape Coordinator for which to
  38 report the status.
  39 <P><DT><B>-localauth
  40 </B><DD>Constructs a server ticket using a key from the local
  41 <B>/usr/afs/etc/KeyFile</B> file. The <B>backup</B> command
  42 interpreter presents it to the Backup Server, Volume Server and VL Server
  43 during mutual authentication. Do not combine this flag with the
  44 <B>-cell</B> argument. For more details, see the introductory
  45 <B>backup</B> reference page.
  46 <P><DT><B>-cell
  47 </B><DD>Names the cell in which to run the command. Do not combine this
  48 argument with the <B>-localauth</B> flag. For more details, see the
  49 introductory <B>backup</B> reference page.
  50 <P><DT><B>-help
  51 </B><DD>Prints the online help for this command. All other valid options
  52 are ignored.
  53 </DL>
  54 <P><STRONG>Output</STRONG>
  55 <P>The following message indicates that the Tape Coordinator is not currently
  56 performing an operation&#58;
  57 <PRE>   Tape coordinator is idle
  58 </PRE>
  59 <P>Otherwise, the output includes a message of the following format for each
  60 running or pending operation&#58;
  61 <PRE>   Task <VAR>task_ID</VAR>&#58;  <VAR>operation</VAR>&#58;   <VAR>status</VAR>
  62 </PRE>
  63 <P>where
  64 <DL>
  65 <P><DT><B><VAR>task_ID</VAR>
  66 </B><DD>Is a task identification number assigned by the Tape Coordinator.
  67 It begins with the Tape Coordinator&#39;s port offset number.
  68 <P><DT><B><VAR>operation</VAR>
  69 </B><DD>Identifies the operation the Tape Coordinator is performing, which is
  70 initiated by the indicated command&#58;
  71 <UL>
  72 <P><LI><TT>Dump</TT> (the <B>backup dump</B> command)
  73 <P><LI><TT>Restore</TT> (the <B>backup diskrestore</B>, <B>backup
  74 volrestore</B>, or <B>backup volsetrestore</B> commands)
  75 <P><LI><TT>Labeltape</TT> (the <B>backup labeltape</B> command)
  76 <P><LI><TT>Scantape</TT> (the <B>backup scantape</B> command)
  77 <P><LI><TT>SaveDb</TT> (the <B>backup savedb</B> command)
  78 <P><LI><TT>RestoreDb</TT> (the <B>backup restoredb</B> command)
  79 </UL>
  80 <P><DT><B><VAR>status</VAR>
  81 </B><DD>Indicates the job&#39;s current status in one of the following
  82 messages.
  83 <DL>
  84 <P><DT><B><VAR>number</VAR> <TT>Kbytes transferred, volume</TT> <VAR>volume_name</VAR>
  85 </B><DD>For a running dump operation, indicates the number of kilobytes copied to
  86 tape or a backup data file so far, and the volume currently being
  87 dumped.
  88 <P><DT><B><VAR>number</VAR> <TT>Kbytes, restore.volume</TT>
  89 </B><DD>For a running restore operation, indicates the number of kilobytes copied
  90 into AFS from a tape or a backup data file so far.
  91 <P><DT><B><TT>[abort requested]</TT>
  92 </B><DD>The <B>(backup) kill</B> command was issued, but the termination
  93 signal has yet to reach the Tape Coordinator.
  94 <P><DT><B><TT>[abort sent]</TT>
  95 </B><DD>The operation is canceled by the <B>(backup) kill</B> command.
  96 Once the Backup System removes an operation from the queue or stops it from
  97 running, it no longer appears at all in the output from the command.
  98 <P><DT><B><TT>[butc contact lost]</TT>
  99 </B><DD>The <B>backup</B> command interpreter cannot reach the Tape
 100 Coordinator. The message can mean either that the Tape Coordinator
 101 handling the operation was terminated or failed while the operation was
 102 running, or that the connection to the Tape Coordinator timed out.
 103 <P><DT><B><TT>[done]</TT>
 104 </B><DD>The Tape Coordinator has finished the operation.
 105 <P><DT><B><TT>[drive wait]</TT>
 106 </B><DD>The operation is waiting for the specified tape drive to become
 107 free.
 108 <P><DT><B><TT>[operator wait]</TT>
 109 </B><DD>The Tape Coordinator is waiting for the backup operator to insert a tape
 110 in the drive.
 111 </DL>
 112 </DL>
 113 <P><STRONG>Examples</STRONG>
 114 <P>The following example shows that the Tape Coordinator with port offset 4
 115 has so far dumped about 1.5 MB of data for the current dump operation,
 116 and is currently dumping the volume named
 117 <B>user.pat.backup</B>&#58;
 118 <PRE>   % <B>backup status -portoffset 4</B>
 119    Task 4001&#58;  Dump&#58;   1520 Kbytes transferred,  volume user.pat.backup
 120
 121 </PRE>
 122 <P><STRONG>Privilege Required</STRONG>
 123 <P>The issuer must be listed in the <B>/usr/afs/etc/UserList</B> file on
 124 every machine where the Backup Server is running, or must be logged onto a
 125 server machine as the local superuser <B>root</B> if the
 126 <B>-localauth</B> flag is included.
 127 <P><STRONG>Related Information</STRONG>
 128 <P><A HREF="auarf060.htm#HDRBK_INTRO">backup</A>
 129 <P><A HREF="auarf126.htm#HDRBUTC">butc</A>
 130 <P>
 131 <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="auarf088.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="auarf090.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>
 132 <!-- Begin Footer Records  ========================================== -->
 133 <P><HR><B>
 134 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 135 </B>
 136 <!-- End Footer Records  ============================================ -->
 137 <A NAME="Bot_Of_Page"></A>
 138 </BODY></HTML>