git.gag.com Git - debian/amanda/blob - man/xml-source/amflush.8.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
   3                    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
   4 [
   5   <!-- entities files to use -->
   6   <!ENTITY % global_entities SYSTEM '../entities/global.entities'>
   7   %global_entities;
   8 ]>
   9
  10 <!-- lifted from troff+man by doclifter -->
  11 <refentry id='amflush.8'>
  12
  13 <refmeta>
  14 <refentrytitle>amflush</refentrytitle>
  15 <manvolnum>8</manvolnum>
  16 </refmeta>
  17 <refnamediv>
  18 <refname>amflush</refname>
  19 <refpurpose>flush &A; backup files from holding disk to tape</refpurpose>
  20 </refnamediv>
  21 <!-- body begins here -->
  22 <refsynopsisdiv>
  23 <cmdsynopsis>
  24   <command>amflush</command>
  25     <arg choice='opt'>-b </arg>
  26     <arg choice='opt'>-f </arg>
  27     <arg choice='opt'>-s </arg>
  28     <arg choice='opt' rep='repeat'><arg choice='plain'>-D </arg><arg choice='plain'><replaceable>datestamp</replaceable></arg></arg>
  29
  30     <arg choice='plain'><replaceable>config</replaceable></arg>
  31     <arg choice='opt' rep='repeat'><arg choice='plain'><replaceable>host</replaceable></arg><arg choice='opt' rep='repeat'><replaceable>disk</replaceable></arg></arg>
  32
  33 </cmdsynopsis>
  34 </refsynopsisdiv>
  35
  36
  37 <refsect1><title>DESCRIPTION</title>
  38 <para><emphasis remap='B'>Amflush</emphasis>
  39 writes &A; backups from the holding disks to tape,
  40 and updates the &A; info database and tapelist accordingly.
  41 Backups may stay in a holding disk when something is wrong with the tape
  42 at the time
  43 <emphasis remap='B'>amdump</emphasis>
  44 is run.
  45 When this happens, the problem must be corrected and
  46 <command>amflush</command>
  47 run by hand.</para>
  48 </refsect1>
  49
  50 <refsect1><title>OPTIONS</title>
  51 <variablelist remap='TP'>
  52   <varlistentry>
  53   <term><option>-b</option></term>
  54   <listitem>
  55 <para>Run
  56 <command>amflush</command>
  57 in batch mode. All datestamps are selected unless specified.
  58 The flush is started without confirmation.</para>
  59   </listitem>
  60   </varlistentry>
  61   <varlistentry>
  62   <term><option>-f</option></term>
  63   <listitem>
  64 <para>Run
  65 <command>amflush</command>
  66 in foreground.
  67 <emphasis remap='B'>Amflush</emphasis>
  68 normally detaches itself from the tty and runs as a background process.
  69 With the
  70 <option>-f</option>
  71 option,
  72 <command>amflush</command>
  73 stays in the foreground.
  74 This is useful if
  75 <command>amflush</command>
  76 is run as part of another script that, for example, advances the tape
  77 after the flush is completed.</para>
  78   </listitem>
  79   </varlistentry>
  80   <varlistentry>
  81   <term><option>-s</option></term>
  82   <listitem>
  83 <para>Write log to stdout/stderr instead of the amflush log file. Requires the
  84 <option>-f</option>
  85 option.</para>
  86   </listitem>
  87   </varlistentry>
  88   <varlistentry>
  89   <term><option>-D datestamp</option></term>
  90   <listitem>
  91 <para>specify a  datestamp expression you want to flush, see the
  92 &quot;DATESTAMP EXPRESSION&quot; section of
  93 <citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>
  94 for a description.
  95 <option>-D 20001225-7</option>
  96 will flush all
  97 dumps from 25 december 2000 to 27 december 2000.</para>
  98   </listitem>
  99   </varlistentry>
 100 </variablelist>
 101
 102 <para>You can specify many host/disk expressions, only disks that
 103 match an expression will be flushed. All disks are flushed if no
 104 expressions are given. see the &quot;HOST &amp; DISK EXPRESSION&quot; section of
 105 <citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>
 106 for a description.</para>
 107
 108 <para><emphasis remap='B'>Amflush</emphasis>
 109 will look in the holding disks specified by the
 110 <emphasis remap='I'>amanda.conf</emphasis>
 111 file in /usr/local/etc/amanda/<emphasis remap='I'>config</emphasis>
 112 for any non-empty &A; work directories.
 113 It then prompts you to select a directory
 114 or to process all of the directories.
 115 The work directories in the holding disks are named by the date at the time
 116 <emphasis remap='B'>amdump</emphasis>
 117 was run, e.g.
 118 <literal>19910215</literal>.</para>
 119
 120 <para>See the
 121 <citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>
 122 man page for more details about &A;.</para>
 123 </refsect1>
 124
 125 <refsect1><title>EXAMPLE</title>
 126 <para><emphasis remap='B'>Amflush</emphasis>
 127 will search for holding areas associated with the
 128 <emphasis remap='I'>daily</emphasis>
 129 configuration.
 130 After you select which holding area to flush,
 131 <command>amflush</command>
 132 writes the data to tape, updates the databases and sends
 133 a mail report similar to
 134 <citerefentry><refentrytitle>amdump</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
 135
 136 <programlisting>
 137 % amflush daily
 138 Scanning /amanda-hold...
 139   20001113: found &A; directory.
 140   20001114: found &A; directory.
 141
 142 Multiple &A; directories, please pick one by letter:
 143   A. 20001113
 144   B. 20001114
 145 Select directories to flush [A..B]: [ALL] all
 146
 147 Flushing dumps in 20001113, 20001114,
 148 today: 20001117
 149 to tape drive /dev/rmt/0mn.
 150 Expecting tape DMP014 or a new tape.  (The last dumps were to tape DMP013)
 151 Are you sure you want to do this? yes
 152 Running in background, you can log off now.
 153 You'll get mail when amflush is finished.
 154 </programlisting>
 155 </refsect1>
 156
 157 <refsect1><title>AUTHOR</title>
 158 <para>James da Silva, &email.jds; : Original text</para>
 159 <para>&maintainer.sgw;: XML-conversion</para>
 160 </refsect1>
 161
 162 <refsect1><title>SEE ALSO</title>
 163 <para><citerefentry><refentrytitle>amanda</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 164 <citerefentry><refentrytitle>amdump</refentrytitle><manvolnum>8</manvolnum></citerefentry></para>
 165 </refsect1>
 166 </refentry>
 167