|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
|
|
Packit Service |
392537 |
[
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
%global_entities;
|
|
Packit Service |
392537 |
]>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<refentry id='amadmin.8'>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<refmeta>
|
|
Packit Service |
392537 |
<refentrytitle>amadmin</refentrytitle>
|
|
Packit Service |
392537 |
<manvolnum>8</manvolnum>
|
|
Packit Service |
392537 |
&rmi.source;
|
|
Packit Service |
392537 |
&rmi.version;
|
|
Packit Service |
392537 |
&rmi.manual.8;
|
|
Packit Service |
392537 |
</refmeta>
|
|
Packit Service |
392537 |
<refnamediv>
|
|
Packit Service |
392537 |
<refname>amadmin</refname>
|
|
Packit Service |
392537 |
<refpurpose>administrative interface to control Amanda backups</refpurpose>
|
|
Packit Service |
392537 |
</refnamediv>
|
|
Packit Service |
392537 |
<refentryinfo>
|
|
Packit Service |
392537 |
&author.jds;
|
|
Packit Service |
392537 |
&author.sgw.xml;
|
|
Packit Service |
392537 |
</refentryinfo>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<refsynopsisdiv>
|
|
Packit Service |
392537 |
<cmdsynopsis>
|
|
Packit Service |
392537 |
<command>amadmin</command>
|
|
Packit Service |
392537 |
<arg choice='opt'>--version</arg>
|
|
Packit Service |
392537 |
<arg choice='opt'>--no-default</arg>
|
|
Packit Service |
392537 |
<arg choice='opt'>--print-source</arg>
|
|
Packit Service |
392537 |
<arg choice='opt'>--exact-match</arg>
|
|
Packit Service |
392537 |
&configoverride.synopsis;
|
|
Packit Service |
392537 |
<arg choice='plain'><replaceable>config</replaceable></arg>
|
|
Packit Service |
392537 |
<arg choice='plain'><replaceable>command</replaceable></arg>
|
|
Packit Service |
392537 |
<arg choice='opt' rep='repeat'><replaceable>command_options</replaceable></arg>
|
|
Packit Service |
392537 |
</cmdsynopsis>
|
|
Packit Service |
392537 |
</refsynopsisdiv>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<refsect1><title>DESCRIPTION</title>
|
|
Packit Service |
392537 |
<para><emphasis remap='B'>Amadmin</emphasis>
|
|
Packit Service |
392537 |
performs various administrative tasks on the
|
|
Packit Service |
392537 |
<emphasis remap='I'>config</emphasis>
|
|
Packit Service |
392537 |
Amanda configuration.</para>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<para>See the
|
|
Packit Service |
392537 |
<manref name="amanda" vol="8"/>
|
|
Packit Service |
392537 |
man page for more details about Amanda.</para>
|
|
Packit Service |
392537 |
</refsect1>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<refsect1><title>OPTIONS</title>
|
|
Packit Service |
392537 |
<variablelist remap='TP'>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><option>--version</option></term>
|
|
Packit Service |
392537 |
<listitem><para>Print the version and exit.</para></listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><option>--no-default</option></term>
|
|
Packit Service |
392537 |
<listitem><para>Do not print default values for <emphasis remap='B'>config</emphasis>
|
|
Packit Service |
392537 |
and <emphasis remap='B'>disklist</emphasis> commands.</para></listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><option>--print-source</option></term>
|
|
Packit Service |
392537 |
<listitem><para>Print where a value is defined for <emphasis remap='B'>config</emphasis>
|
|
Packit Service |
392537 |
and <emphasis remap='B'>disklist</emphasis> commands.</para></listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><option>--exact-match</option></term>
|
|
Packit Service |
392537 |
<listitem><para>The host and disk are parsed as exact values</para></listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
</variablelist>
|
|
Packit Service |
392537 |
</refsect1>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<refsect1><title>COMMANDS</title>
|
|
Packit Service |
392537 |
<para>Commands that take a <emphasis remap='I'>hostname</emphasis> [ <emphasis remap='I'>disks</emphasis> ]
|
|
Packit Service |
392537 |
parameter pair operate on all disks in the &disklist; for that
|
|
Packit Service |
392537 |
<emphasis remap='I'>hostname</emphasis> if no disks are specified. Where
|
|
Packit Service |
392537 |
<emphasis remap='I'>hostname</emphasis> is also marked as being optional,
|
|
Packit Service |
392537 |
the command operates on all hosts and disks in the &disklist; when no hostname is given.
|
|
Packit Service |
392537 |
Both <emphasis remap='I'>hostname</emphasis> and <emphasis remap='I'>disks</emphasis>
|
|
Packit Service |
392537 |
are match expressions; see <manref name="amanda-match" vol="7"/> for a description.</para>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<variablelist remap='TP'>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>version</emphasis></term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>Show the current version and some compile time and runtime parameters.
|
|
Packit Service |
392537 |
The
|
|
Packit Service |
392537 |
<emphasis remap='I'>config</emphasis>
|
|
Packit Service |
392537 |
parameter must be present but is ignored.</para>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>estimate</emphasis> [ <emphasis remap='I'>hostname</emphasis> [ <emphasis remap='I'>disks</emphasis> ]* ]*</term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>Print the server estimate for the dles, each output lines have the following format:</para>
|
|
Packit Service |
392537 |
<programlisting>
|
|
Packit Service |
392537 |
hostname diskname level size
|
|
Packit Service |
392537 |
</programlisting>
|
|
Packit Service |
392537 |
<variablelist remap='TP'>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term>hostname</term>
|
|
Packit Service |
392537 |
<listitem>The quoted hostname
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term>diskname</term>
|
|
Packit Service |
392537 |
<listitem>The quoted diskname
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term>level</term>
|
|
Packit Service |
392537 |
<listitem>The level of the estimate
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term>size</term>
|
|
Packit Service |
392537 |
<listitem>The estimate size in kbytes
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
</variablelist>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>force-bump</emphasis> [ <emphasis remap='I'>hostname</emphasis> [ <emphasis remap='I'>disks</emphasis> ]* ]+</term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>Force the
|
|
Packit Service |
392537 |
<emphasis remap='I'>disks</emphasis>
|
|
Packit Service |
392537 |
on
|
|
Packit Service |
392537 |
<emphasis remap='I'>hostname</emphasis>
|
|
Packit Service |
392537 |
to bump to a new incremental level during the next Amanda run.</para>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>force-no-bump</emphasis> [ <emphasis remap='I'>hostname</emphasis> [ <emphasis remap='I'>disks</emphasis> ]* ]+</term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>Force the
|
|
Packit Service |
392537 |
<emphasis remap='I'>disks</emphasis>
|
|
Packit Service |
392537 |
on
|
|
Packit Service |
392537 |
<emphasis remap='I'>hostname</emphasis>
|
|
Packit Service |
392537 |
to not bump to a new incremental level during the next Amanda run.</para>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>unforce-bump</emphasis> [ <emphasis remap='I'>hostname</emphasis> [ <emphasis remap='I'>disks</emphasis> ]* ]+</term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>Undo a previous
|
|
Packit Service |
392537 |
<emphasis remap='B'>force-bump</emphasis>
|
|
Packit Service |
392537 |
or
|
|
Packit Service |
392537 |
<emphasis remap='B'>force-no-bump</emphasis>
|
|
Packit Service |
392537 |
command.</para>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>force</emphasis> [ <emphasis remap='I'>hostname</emphasis> [ <emphasis remap='I'>disks</emphasis> ]* ]+</term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>Force the
|
|
Packit Service |
392537 |
<emphasis remap='I'>disks</emphasis>
|
|
Packit Service |
392537 |
on
|
|
Packit Service |
392537 |
<emphasis remap='I'>hostname</emphasis>
|
|
Packit Service |
392537 |
to do a full (level 0) backup during the next Amanda run.</para>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>force-level-1</emphasis> [ <emphasis remap='I'>hostname</emphasis> [ <emphasis remap='I'>disks</emphasis> ]* ]+</term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>Force the
|
|
Packit Service |
392537 |
<emphasis remap='I'>disks</emphasis>
|
|
Packit Service |
392537 |
on
|
|
Packit Service |
392537 |
<emphasis remap='I'>hostname</emphasis>
|
|
Packit Service |
392537 |
to do a level 1 backup during the next Amanda run.</para>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>unforce</emphasis> [ <emphasis remap='I'>hostname</emphasis> [ <emphasis remap='I'>disks</emphasis> ]* ]+</term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>Undo a previous
|
|
Packit Service |
392537 |
<emphasis remap='B'>force</emphasis> or
|
|
Packit Service |
392537 |
<emphasis remap='B'>force-level-1</emphasis>
|
|
Packit Service |
392537 |
command.</para>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>retention</emphasis> <emphasis remap='I'>[ tapelabel</emphasis> ... ]</term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>Print the retention for each tapes.</para>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>reuse</emphasis> <emphasis remap='I'>tapelabel</emphasis> [ ... ]</term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>The tapes listed
|
|
Packit Service |
392537 |
will be available for reuse at their point in the tape cycle.</para>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>no-reuse</emphasis> <emphasis remap='I'>tapelabel</emphasis> [ ... ]</term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>The tapes listed
|
|
Packit Service |
392537 |
will not be reused when their turn comes up again in the tape cycle.
|
|
Packit Service |
392537 |
Note that if this causes the number of reusable tapes to drop below the
|
|
Packit Service |
392537 |
<emphasis remap='B'>amanda.conf</emphasis>
|
|
Packit Service |
392537 |
<emphasis remap='I'>tapecycle</emphasis>
|
|
Packit Service |
392537 |
value, Amanda will request new tapes until the count is satisfied again.</para>
|
|
Packit Service |
392537 |
<para>Tape marked <emphasis remap='I'>no-reuse</emphasis> are available
|
|
Packit Service |
392537 |
for recovery, marking them <emphasis remap='I'>no-reuse</emphasis> is a
|
|
Packit Service |
392537 |
security to be sure amanda will not overwrite them.</para>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>due</emphasis> [ <emphasis remap='I'>hostname</emphasis> [ <emphasis remap='I'>disks</emphasis> ]* ]*</term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>Show when the next full dump is due.</para>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>find</emphasis> [ <option>--sort</option> <replaceable>hkdlspbfw</replaceable> ]<emphasis remap='B'></emphasis> [ <emphasis remap='I'>hostname</emphasis> [ <emphasis remap='I'>disks</emphasis> ]* ]*</term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>Display all backups currently on tape or in the holding disk.
|
|
Packit Service |
392537 |
The storage name, tape label or holding disk filename,
|
|
Packit Service |
392537 |
file number,
|
|
Packit Service |
392537 |
and status are displayed.</para>
|
|
Packit Service |
392537 |
<para>The <option>--sort</option> option changes the sort order using the following flags:
|
|
Packit Service |
392537 |
<programlisting>
|
|
Packit Service |
392537 |
<emphasis>h</emphasis>: host name
|
|
Packit Service |
392537 |
<emphasis>k</emphasis>: disk name
|
|
Packit Service |
392537 |
<emphasis>d</emphasis>: dump timestamp
|
|
Packit Service |
392537 |
<emphasis>l</emphasis>: backup level
|
|
Packit Service |
392537 |
<emphasis>p</emphasis>: dump part
|
|
Packit Service |
392537 |
<emphasis>b</emphasis>: tape label
|
|
Packit Service |
392537 |
<emphasis>s</emphasis>: storage name
|
|
Packit Service |
392537 |
<emphasis>f</emphasis>: filenum on tape
|
|
Packit Service |
392537 |
<emphasis>w</emphasis>: write timestamp
|
|
Packit Service |
392537 |
</programlisting></para>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<para>An uppercase letter reverses the sort order for that key.
|
|
Packit Service |
392537 |
The default sort order is <emphasis remap='B'>hkdlspbfw</emphasis>.</para>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>holding delete</emphasis> <emphasis remap="I">hostname</emphasis> [ <emphasis remap="I">disk</emphasis> [ <emphasis remap="I">datestamp</emphasis> [ .. ] ] ]</term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<para>Delete holding files matching the given specification. At least
|
|
Packit Service |
392537 |
a hostname must be provided.</para>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>holding list</emphasis> [-l] [-d] [ <emphasis remap="I">hostname</emphasis> [ <emphasis remap="I">disk</emphasis> [ <emphasis remap="I">datestamp</emphasis> [ .. ] ] ] ]</term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<para>List holding files matching the given dump specification, or all
|
|
Packit Service |
392537 |
holding files if no specification is provided. See
|
|
Packit Service |
392537 |
name="amanda-match" vol="7"/> for more information on dump
|
|
Packit Service |
392537 |
specifications. With '-l', additional information (size, level, and
|
|
Packit Service |
392537 |
whether the dump is outdated) is provided. With '-d', only outdated
|
|
Packit Service |
392537 |
dumps are shown.</para>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<para>An outdated holding file is one which is not required for a
|
|
Packit Service |
392537 |
restore of the <emphasis>most recent</emphasis> dump. Note that
|
|
Packit Service |
392537 |
outdated dumps may still be required for restores at earlier dates.
|
|
Packit Service |
392537 |
For example, assume that a DLE had a level 0 on Monday, level
|
|
Packit Service |
392537 |
1's Tuesday through Thursday, and a level 2 on Friday. Then the
|
|
Packit Service |
392537 |
files required for a restore of Fridays (the most recent) dump
|
|
Packit Service |
392537 |
are those from Monday (level 0), Thursday (level 1), and Friday
|
|
Packit Service |
392537 |
(level 2). Tuesday and Wednesday's files are outdated. </para>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>delete</emphasis> [ <emphasis remap='I'>hostname</emphasis> [ <emphasis remap='I'>disks</emphasis> ]* ]+</term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>Delete the specified
|
|
Packit Service |
392537 |
<emphasis remap='I'>disks</emphasis>
|
|
Packit Service |
392537 |
on
|
|
Packit Service |
392537 |
<emphasis remap='I'>hostname</emphasis>
|
|
Packit Service |
392537 |
from the Amanda database.</para>
|
|
Packit Service |
392537 |
<note><para>If you do not also remove the disk from the &disklist;
|
|
Packit Service |
392537 |
file, Amanda will treat it as a new disk during the next run.</para>
|
|
Packit Service |
392537 |
</note>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>tape</emphasis> [ <option>--days</option> <replaceable><num></replaceable> ]</term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>Display the tape(s) Amanda expects to write to during the next run.
|
|
Packit Service |
392537 |
See also
|
|
Packit Service |
392537 |
<manref name="amcheck" vol="8"/>.</para>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>bumpsize</emphasis></term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>Display the current bump threshold parameters, calculated for all backup
|
|
Packit Service |
392537 |
levels.</para>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>balance</emphasis> [ <option>--days</option> <replaceable><num></replaceable> ]</term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>Display the distribution of full backups throughout the dump schedule.</para>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>export</emphasis> [ <emphasis remap='I'>hostname</emphasis> [ <emphasis remap='I'>disks</emphasis> ]* ]*</term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>Convert records from the Amanda database
|
|
Packit Service |
392537 |
to a text format that may be transmitted to another Amanda machine and
|
|
Packit Service |
392537 |
<emphasis remap='B'>import</emphasis>ed.</para>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>import</emphasis></term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>Convert
|
|
Packit Service |
392537 |
<emphasis remap='B'>export</emphasis>ed
|
|
Packit Service |
392537 |
records read from standard input to a form Amanda uses
|
|
Packit Service |
392537 |
and insert them into the database on this machine.</para>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>config</emphasis></term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>Dump the full internal representation of this config, in text format.
|
|
Packit Service |
392537 |
</para>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>disklist</emphasis> [ <emphasis remap='I'>hostname</emphasis> [ <emphasis remap='I'>disks</emphasis> ]* ]*</term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>Display the &disklist;
|
|
Packit Service |
392537 |
information for each of the
|
|
Packit Service |
392537 |
<emphasis remap='I'>disks</emphasis>
|
|
Packit Service |
392537 |
on
|
|
Packit Service |
392537 |
<emphasis remap='I'>hostname</emphasis>
|
|
Packit Service |
392537 |
(or all hosts).
|
|
Packit Service |
392537 |
Mostly used for debugging.</para>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>hosts</emphasis></term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>Output a list of distinct hosts in the &disklist;, one per line, for easy use in shell scripts.</para>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>dles</emphasis></term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>Output a list of distinct DLEs in the &disklist;, one per line with host and diskname separated by a space, for easy use in shell scripts.</para>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
<varlistentry>
|
|
Packit Service |
392537 |
<term><emphasis remap='B'>info</emphasis> [ <emphasis remap='I'>hostname</emphasis> [ <emphasis remap='I'>disks</emphasis> ]* ]*</term>
|
|
Packit Service |
392537 |
<listitem>
|
|
Packit Service |
392537 |
<para>Display the
|
|
Packit Service |
392537 |
database record for each of the
|
|
Packit Service |
392537 |
<emphasis remap='I'>disks</emphasis>
|
|
Packit Service |
392537 |
on
|
|
Packit Service |
392537 |
<emphasis remap='I'>hostname</emphasis>
|
|
Packit Service |
392537 |
(or all hosts).
|
|
Packit Service |
392537 |
Mostly used for debugging.</para>
|
|
Packit Service |
392537 |
</listitem>
|
|
Packit Service |
392537 |
</varlistentry>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
&configoverride.varlistentry;
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
</variablelist>
|
|
Packit Service |
392537 |
</refsect1>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<refsect1><title>EXAMPLES</title>
|
|
Packit Service |
392537 |
<para>Request three specific file systems on
|
|
Packit Service |
392537 |
<emphasis remap='I'>machine-a</emphasis>
|
|
Packit Service |
392537 |
get a full level 0 backup during the next Amanda run.</para>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<programlisting>
|
|
Packit Service |
392537 |
$ amadmin daily force machine-a / /var /usr
|
|
Packit Service |
392537 |
amadmin: machine-a:/ is set to a forced level 0 tonight.
|
|
Packit Service |
392537 |
amadmin: machine-a:/var is set to a forced level 0 tonight.
|
|
Packit Service |
392537 |
amadmin: machine-a:/usr is set to a forced level 0 tonight.
|
|
Packit Service |
392537 |
</programlisting>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<para>Request all file systems on
|
|
Packit Service |
392537 |
<emphasis remap='I'>machine-b</emphasis>
|
|
Packit Service |
392537 |
get a full level 0 backup during the next Amanda run.</para>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<programlisting>
|
|
Packit Service |
392537 |
$ amadmin daily force machine-b
|
|
Packit Service |
392537 |
amadmin: machine-b:/ is set to a forced level 0 tonight.
|
|
Packit Service |
392537 |
amadmin: machine-b:/var is set to a forced level 0 tonight.
|
|
Packit Service |
392537 |
amadmin: machine-b:/usr is set to a forced level 0 tonight.
|
|
Packit Service |
392537 |
amadmin: machine-b:/home is set to a forced level 0 tonight.
|
|
Packit Service |
392537 |
</programlisting>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<para>Undo the previous
|
|
Packit Service |
392537 |
<emphasis remap='B'>force</emphasis>
|
|
Packit Service |
392537 |
request for
|
|
Packit Service |
392537 |
<filename>/home</filename>
|
|
Packit Service |
392537 |
on
|
|
Packit Service |
392537 |
<emphasis remap='I'>machine-b</emphasis>.
|
|
Packit Service |
392537 |
The other file systems will still get a full level 0 backup.</para>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<programlisting>
|
|
Packit Service |
392537 |
$ amadmin daily unforce machine-b /home
|
|
Packit Service |
392537 |
amadmin: force command for machine-b:/home cleared.
|
|
Packit Service |
392537 |
</programlisting>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<para>Locate backup images of
|
|
Packit Service |
392537 |
<filename>/var</filename>
|
|
Packit Service |
392537 |
from
|
|
Packit Service |
392537 |
<emphasis remap='I'>machine-c</emphasis>.
|
|
Packit Service |
392537 |
The
|
|
Packit Service |
392537 |
<emphasis remap='I'>tape or file</emphasis>
|
|
Packit Service |
392537 |
column displays either a tape label or a filename depending on whether
|
|
Packit Service |
392537 |
the image is on tape or is still in the holding disk.
|
|
Packit Service |
392537 |
If the image is on tape, the
|
|
Packit Service |
392537 |
<emphasis remap='I'>file</emphasis>
|
|
Packit Service |
392537 |
column tells you which file on the tape has the image
|
|
Packit Service |
392537 |
(file number zero is a tape label).
|
|
Packit Service |
392537 |
This column shows zero and is not meaningful if the image
|
|
Packit Service |
392537 |
is still in the holding disk.
|
|
Packit Service |
392537 |
The
|
|
Packit Service |
392537 |
<emphasis remap='I'>status</emphasis>
|
|
Packit Service |
392537 |
column tells you whether the backup was successful or had
|
|
Packit Service |
392537 |
some type of error.</para>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<programlisting>
|
|
Packit Service |
392537 |
$ amadmin daily find machine-c /var
|
|
Packit Service |
392537 |
date host disk lv tape or file file part status
|
|
Packit Service |
392537 |
2000-11-09 machine-c /var 0 000110 9 -- OK
|
|
Packit Service |
392537 |
2000-11-08 machine-c /var 2 000109 2 -- OK
|
|
Packit Service |
392537 |
2000-11-07 machine-c /var 2 /amanda/20001107/machine-c._var.2 0 OK
|
|
Packit Service |
392537 |
2000-11-06 machine-c /var 2 000107 2 -- OK
|
|
Packit Service |
392537 |
2000-11-05 machine-c /var 2 000106 3 -- OK
|
|
Packit Service |
392537 |
2000-11-04 machine-c /var 2 000105 2 -- OK
|
|
Packit Service |
392537 |
2000-11-03 machine-c /var 2 000104 2 -- OK
|
|
Packit Service |
392537 |
2000-11-02 machine-c /var 2 000103 2 -- OK
|
|
Packit Service |
392537 |
2000-11-01 machine-c /var 1 000102 5 -- OK
|
|
Packit Service |
392537 |
2000-10-31 machine-c /var 1 000101 3 -- OK
|
|
Packit Service |
392537 |
</programlisting>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<para>Forget about the
|
|
Packit Service |
392537 |
<filename>/workspace</filename>
|
|
Packit Service |
392537 |
disk on
|
|
Packit Service |
392537 |
<emphasis remap='I'>machine-d</emphasis>.
|
|
Packit Service |
392537 |
If you do not also remove the disk from the &disklist;
|
|
Packit Service |
392537 |
file, Amanda will treat it as a new disk during the next run.</para>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<programlisting remap='.nf'>
|
|
Packit Service |
392537 |
$ amadmin daily delete machine-d /workspace
|
|
Packit Service |
392537 |
amadmin: machine-d:/workspace deleted from database.
|
|
Packit Service |
392537 |
amadmin: NOTE: you'll have to remove these from the &disklist; yourself.
|
|
Packit Service |
392537 |
</programlisting>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<para>Find the next tape Amanda will use (in this case, <literal>123456</literal>).</para>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<programlisting>
|
|
Packit Service |
392537 |
$ amadmin daily tape
|
|
Packit Service |
392537 |
The next Amanda run should go onto tape 123456 or a new tape.
|
|
Packit Service |
392537 |
</programlisting>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<para>Show how well full backups are balanced across the dump cycle.
|
|
Packit Service |
392537 |
The
|
|
Packit Service |
392537 |
<emphasis remap='I'>due-date</emphasis>
|
|
Packit Service |
392537 |
column is the day the backups are due for a full backup.
|
|
Packit Service |
392537 |
<emphasis remap='I'>#fs</emphasis>
|
|
Packit Service |
392537 |
shows the number of filesystems doing full backups that night, and
|
|
Packit Service |
392537 |
<emphasis remap='I'>orig KB</emphasis>
|
|
Packit Service |
392537 |
and
|
|
Packit Service |
392537 |
<emphasis remap='I'>out KB</emphasis>
|
|
Packit Service |
392537 |
show the estimated total size of the backups
|
|
Packit Service |
392537 |
before and after any compression, respectively.</para>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<para>The
|
|
Packit Service |
392537 |
<emphasis remap='I'>balance</emphasis>
|
|
Packit Service |
392537 |
column shows how far off that night's backups are from the average size
|
|
Packit Service |
392537 |
(shown at the bottom of the balance column).
|
|
Packit Service |
392537 |
Amanda tries to keep the backups within +/- 5%,
|
|
Packit Service |
392537 |
but since the amount of data on each filesystem is always changing,
|
|
Packit Service |
392537 |
and Amanda will never delay backups just to rebalance the schedule,
|
|
Packit Service |
392537 |
it is common for the schedule to fluctuate by larger percentages.
|
|
Packit Service |
392537 |
In particular, in the case of a tape or backup failure, a bump will occur the following night,
|
|
Packit Service |
392537 |
which will not be smoothed out until the next pass through the schedule.</para>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<para>The last line also shows an estimate of how many Amanda runs will be
|
|
Packit Service |
392537 |
made between full backups for a file system.
|
|
Packit Service |
392537 |
In the example, a file system will probably have a full backup done
|
|
Packit Service |
392537 |
every eight times Amanda is run (e.g. every eight days).</para>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<programlisting>
|
|
Packit Service |
392537 |
$ amadmin daily balance
|
|
Packit Service |
392537 |
due-date #fs orig KB out KB balance
|
|
Packit Service |
392537 |
-------------------------------------------
|
|
Packit Service |
392537 |
11/10 Mon 21 930389 768753 +5.1%
|
|
Packit Service |
392537 |
11/11 Tue 29 1236272 733211 +0.2%
|
|
Packit Service |
392537 |
11/12 Wed 31 1552381 735796 +0.6%
|
|
Packit Service |
392537 |
11/13 Thu 23 1368447 684552 -6.4%
|
|
Packit Service |
392537 |
11/14 Fri 32 1065603 758155 +3.6%
|
|
Packit Service |
392537 |
11/15 Sat 14 1300535 738430 +0.9%
|
|
Packit Service |
392537 |
11/16 Sun 31 1362696 740365 +1.2%
|
|
Packit Service |
392537 |
11/17 Mon 30 1427936 773397 +5.7%
|
|
Packit Service |
392537 |
11/18 Tue 11 1059191 721786 -1.3%
|
|
Packit Service |
392537 |
11/19 Wed 19 1108737 661867 -9.5%
|
|
Packit Service |
392537 |
-------------------------------------------
|
|
Packit Service |
392537 |
TOTAL 241 12412187 7316312 731631 (estimated 8 runs per dumpcycle)
|
|
Packit Service |
392537 |
</programlisting>
|
|
Packit Service |
392537 |
</refsect1>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
<seealso>
|
|
Packit Service |
392537 |
<manref name="amanda" vol="8"/>,
|
|
Packit Service |
392537 |
<manref name="amcheck" vol="8"/>,
|
|
Packit Service |
392537 |
<manref name="amdump" vol="8"/>,
|
|
Packit Service |
392537 |
<manref name="amrestore" vol="8"/>,
|
|
Packit Service |
392537 |
<manref name="amfetchdump" vol="8"/>
|
|
Packit Service |
392537 |
<manref name="amanda-match" vol="7"/>,
|
|
Packit Service |
392537 |
</seealso>
|
|
Packit Service |
392537 |
|
|
Packit Service |
392537 |
</refentry>
|