mirror of
https://git.openafs.org/openafs.git
synced 2025-01-21 00:10:15 +00:00
190 lines
9.7 KiB
HTML
190 lines
9.7 KiB
HTML
|
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
|
||
|
|
<HTML><HEAD>
|
||
|
|
<TITLE>Administration Reference</TITLE>
|
||
|
|
<!-- Begin Header Records ========================================== -->
|
||
|
|
<!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID -->
|
||
|
|
<!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30 -->
|
||
|
|
<META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
|
||
|
|
<META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
|
||
|
|
<META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
|
||
|
|
</HEAD><BODY>
|
||
|
|
<!-- (C) IBM Corporation 2000. All Rights Reserved -->
|
||
|
|
<BODY bgcolor="ffffff">
|
||
|
|
<!-- End Header Records ============================================ -->
|
||
|
|
<A NAME="Top_Of_Page"></A>
|
||
|
|
<H1>Administration Reference</H1>
|
||
|
|
<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="auarf062.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="auarf064.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>
|
||
|
|
<P>
|
||
|
|
<H2><A NAME="HDRBK_ADDVOLENTRY" HREF="auarf002.htm#ToC_77">backup addvolentry</A></H2>
|
||
|
|
<A NAME="IDX4239"></A>
|
||
|
|
<A NAME="IDX4240"></A>
|
||
|
|
<A NAME="IDX4241"></A>
|
||
|
|
<A NAME="IDX4242"></A>
|
||
|
|
<A NAME="IDX4243"></A>
|
||
|
|
<A NAME="IDX4244"></A>
|
||
|
|
<A NAME="IDX4245"></A>
|
||
|
|
<A NAME="IDX4246"></A>
|
||
|
|
<A NAME="IDX4247"></A>
|
||
|
|
<A NAME="IDX4248"></A>
|
||
|
|
<A NAME="IDX4249"></A>
|
||
|
|
<A NAME="IDX4250"></A>
|
||
|
|
<A NAME="IDX4251"></A>
|
||
|
|
<A NAME="IDX4252"></A>
|
||
|
|
<P><STRONG>Purpose</STRONG>
|
||
|
|
<P>Defines a volume entry in a volume set
|
||
|
|
<P><STRONG>Synopsis</STRONG>
|
||
|
|
<PRE><B>backup addvolentry -name</B> <<VAR>volume set name</VAR>> <B>-server</B> <<VAR>machine name</VAR>>
|
||
|
|
<B>-partition</B> <<VAR>partition name</VAR>>
|
||
|
|
<B>-volumes</B> <<VAR>volume name (regular expression)</VAR>>
|
||
|
|
[<B>-localauth</B>] [<B>-cell</B> <<VAR>cell name</VAR>>] [<B>-help</B>]
|
||
|
|
|
||
|
|
<B>backup addvole -n</B> <<VAR>volume set name</VAR>> <B>-s</B> <<VAR>machine name</VAR>> <B>-p</B> <<VAR>partition name</VAR>>
|
||
|
|
<B>-v</B> <<VAR>volume name (regular expression)</VAR>>
|
||
|
|
[<B>-l</B>] [<B>-c</B> <<VAR>cell name</VAR>>] [<B>-h</B>]
|
||
|
|
</PRE>
|
||
|
|
<P><STRONG>Description</STRONG>
|
||
|
|
<P>The <B>backup addvolentry</B> command adds a volume entry definition to
|
||
|
|
the existing volume set named by the <B>-name</B> argument. A
|
||
|
|
volume entry definition can match one or more volumes, depending on the
|
||
|
|
combination of the <B>-server</B>, <B>-partition</B>, and
|
||
|
|
<B>-volumes</B> arguments.
|
||
|
|
<P>For the <B>-server</B> and <B>-partition</B> arguments, provide
|
||
|
|
either
|
||
|
|
<UL>
|
||
|
|
<P><LI>The name of one machine or partition
|
||
|
|
<P><LI>The metacharacter expression <B>.*</B> (period and asterisk),
|
||
|
|
which matches every machine name or partition name in the Volume Location
|
||
|
|
Database (VLDB).
|
||
|
|
</UL>
|
||
|
|
<P>For the <B>-volumes</B> argument, specify a combination of alphanumeric
|
||
|
|
characters and one or more metacharacters to wildcard part or all of the
|
||
|
|
volume name. The <B>Options</B> section lists the acceptable
|
||
|
|
metacharacters.
|
||
|
|
<P><STRONG>Cautions</STRONG>
|
||
|
|
<P>It is best to issue this command in interactive mode. If issuing it
|
||
|
|
at the shell prompt, enclose any strings containing metacharacters in double
|
||
|
|
quotes, or escape the metacharacters with other delimiters, to prevent the
|
||
|
|
shell from interpreting them. Adding volume entries to a temporary
|
||
|
|
volume set is possible only within the interactive session in which the volume
|
||
|
|
set was created.
|
||
|
|
<P><STRONG>Options</STRONG>
|
||
|
|
<DL>
|
||
|
|
<P><DT><B>-name
|
||
|
|
</B><DD>Names the volume set to which to add this volume entry definition.
|
||
|
|
The volume set must already exist (use the <B>backup addvolset</B> command
|
||
|
|
to create it).
|
||
|
|
<P><DT><B>-server
|
||
|
|
</B><DD>Defines the set of one or more file server machines that house the volumes
|
||
|
|
in the volume entry. Provide either one fully-qualified hostname (such
|
||
|
|
as <B>fs1.abc.com</B>) or the metacharacter expression
|
||
|
|
<B>.*</B> (period and asterisk), which matches all machine names in
|
||
|
|
the VLDB.
|
||
|
|
<P><DT><B>-partition
|
||
|
|
</B><DD>Defines the set of one or more partitions that house the volumes in the
|
||
|
|
volume entry. Provide either one complete partition name (such as
|
||
|
|
<B>/vicepa</B>) or the metacharacter expression <B>.*</B>
|
||
|
|
(period and asterisk), which matches all partition names.
|
||
|
|
<P><DT><B>-volumes
|
||
|
|
</B><DD>Defines the set of one or more volumes included in the volume
|
||
|
|
entry. Specify the volumes by name, by using any combination of regular
|
||
|
|
alphanumeric characters and one or more of the following metacharacter
|
||
|
|
expressions:
|
||
|
|
<A NAME="IDX4253"></A>
|
||
|
|
<A NAME="IDX4254"></A>
|
||
|
|
<DL>
|
||
|
|
<P><DT><B>.
|
||
|
|
</B><DD>The period matches any single character.
|
||
|
|
<P><DT><B>*
|
||
|
|
</B><DD>The asterisk matches zero or more instances of the preceding
|
||
|
|
character. Combine it with any other alphanumeric character or
|
||
|
|
metacharacter.
|
||
|
|
<P><DT><B>[ ]
|
||
|
|
</B><DD>Square brackets around a list of characters match a single instance of any
|
||
|
|
of the characters, but no other characters; for example, <B>[abc]</B>
|
||
|
|
matches a single <B>a</B> or <B>b</B> or <B>c</B>, but not
|
||
|
|
<B>d</B> or <B>A</B>. This expression can be combined with the
|
||
|
|
asterisk.
|
||
|
|
<P><DT><B>^
|
||
|
|
</B><DD>The caret, when used as the first character in a square-bracketed set,
|
||
|
|
designates a match with any single character <I>except</I> the characters
|
||
|
|
that follow it; for example, <B>[^a]</B> matches any single character
|
||
|
|
except lowercase <B>a</B>. This expression can be combined with the
|
||
|
|
asterisk.
|
||
|
|
<P><DT><B>\
|
||
|
|
</B><DD>A backslash preceding any of the metacharacters in this list makes it
|
||
|
|
match its literal value only. For example, the expression
|
||
|
|
<B>\.</B> (backslash and period) matches a single period,
|
||
|
|
<B>\*</B> a single asterisk, and <B>\\</B> a single backslash.
|
||
|
|
Such expressions can be combined with the asterisk (for example,
|
||
|
|
<B>\.*</B> matches any number of periods).
|
||
|
|
</DL>
|
||
|
|
<P>
|
||
|
|
<P>Perhaps the most common metacharacter expression is the period followed by
|
||
|
|
an asterisk (<B>.*</B>). This expression matches any string
|
||
|
|
of any length, because the period matches any character and the asterisk means
|
||
|
|
any number of that character. As mentioned, it is the only acceptable
|
||
|
|
metacharacter expression for the <B>-server</B> and <B>-partition</B>
|
||
|
|
arguments. In a volume definition it can stand alone (in which case it
|
||
|
|
matches every volume listed in the VLDB), or can combine with regular
|
||
|
|
characters. The following example matches any volume name that begins
|
||
|
|
with the string <B>user</B> and ends with <B>backup</B>:
|
||
|
|
<PRE> <B>user.*backup</B>
|
||
|
|
|
||
|
|
</PRE>
|
||
|
|
<P><DT><B>-localauth
|
||
|
|
</B><DD>Constructs a server ticket using a key from the local
|
||
|
|
<B>/usr/afs/etc/KeyFile</B> file. The <B>backup</B> command
|
||
|
|
interpreter presents it to the Backup Server, Volume Server and VL Server
|
||
|
|
during mutual authentication. Do not combine this flag with the
|
||
|
|
<B>-cell</B> argument. For more details, see the introductory
|
||
|
|
<B>backup</B> reference page.
|
||
|
|
<P><DT><B>-cell
|
||
|
|
</B><DD>Names the cell in which to run the command. Do not combine this
|
||
|
|
argument with the <B>-localauth</B> flag. For more details, see the
|
||
|
|
introductory <B>backup</B> reference page.
|
||
|
|
<P><DT><B>-help
|
||
|
|
</B><DD>Prints the online help for this command. All other valid options
|
||
|
|
are ignored.
|
||
|
|
</DL>
|
||
|
|
<P><STRONG>Examples</STRONG>
|
||
|
|
<P>The following command adds a volume entry to the volume set called
|
||
|
|
<B>sys</B>. The entry matches all volumes on any machine or
|
||
|
|
partition whose names begin with the string <B>sun4x_56</B> followed by a
|
||
|
|
period:
|
||
|
|
<PRE> backup> <B>addvolentry sys .* .* sun4x_56\..*</B>
|
||
|
|
|
||
|
|
</PRE>
|
||
|
|
<P>The following command adds a volume entry to the volume set called
|
||
|
|
<B>fs2</B>, to match all volumes on the <B>/vicepb</B> partition of
|
||
|
|
file server machine <B>fs2.abc.com</B>. Because it is
|
||
|
|
issued at the shell prompt, double quotes surround the metacharacters in the
|
||
|
|
<B>-volumes</B> argument. (The command is shown here on two lines
|
||
|
|
only for legibility reasons.)
|
||
|
|
<PRE> % <B>backup addvolentry -name fs2 -server fs2.abc.com \
|
||
|
|
-partition /vicepb -volumes ".*"</B>
|
||
|
|
|
||
|
|
</PRE>
|
||
|
|
<P>The chapter in the <I>IBM AFS Administration Guide</I> about
|
||
|
|
configuring the AFS Backup System presents additional examples as well as
|
||
|
|
advice on grouping volumes.
|
||
|
|
<P><STRONG>Privilege Required</STRONG>
|
||
|
|
<P>The issuer must be listed in the <B>/usr/afs/etc/UserList</B> file on
|
||
|
|
every machine where the Backup Server is running, or must be logged onto a
|
||
|
|
server machine as the local superuser <B>root</B> if the
|
||
|
|
<B>-localauth</B> flag is included.
|
||
|
|
<P><STRONG>Related Information</STRONG>
|
||
|
|
<P><A HREF="auarf060.htm#HDRBK_INTRO">backup</A>
|
||
|
|
<P><A HREF="auarf064.htm#HDRBK_ADDVOLSET">backup addvolset</A>
|
||
|
|
<P><A HREF="auarf070.htm#HDRBK_DELVOLENTRY">backup delvolentry</A>
|
||
|
|
<P><A HREF="auarf071.htm#HDRBK_DELVOLSET">backup delvolset</A>
|
||
|
|
<P><A HREF="auarf082.htm#HDRBK_LISTVOLSETS">backup listvolsets</A>
|
||
|
|
<P>
|
||
|
|
<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="auarf062.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="auarf064.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>
|
||
|
|
<!-- Begin Footer Records ========================================== -->
|
||
|
|
<P><HR><B>
|
||
|
|
<br>© <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A> All Rights Reserved
|
||
|
|
</B>
|
||
|
|
<!-- End Footer Records ============================================ -->
|
||
|
|
<A NAME="Bot_Of_Page"></A>
|
||
|
|
</BODY></HTML>
|