2005-12-08 12:14:33 +00:00
|
|
|
=head1 NAME
|
|
|
|
|
2007-11-11 22:54:56 +00:00
|
|
|
backup_addvolentry - Defines a volume entry in a volume set
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
2006-03-01 05:02:29 +00:00
|
|
|
=for html
|
|
|
|
<div class="synopsis">
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2006-03-01 05:02:29 +00:00
|
|
|
B<backup addvolentry> S<<< B<-name> <I<volume set name>> >>>
|
2009-10-08 22:01:39 +01:00
|
|
|
S<<< B<-server> <I<machine name>> >>>
|
|
|
|
S<<< B<-partition> <I<partition name>> >>>
|
2006-03-01 05:02:29 +00:00
|
|
|
S<<< B<-volumes> <I<volume name (regular expression)>> >>>
|
|
|
|
[B<-localauth>] S<<< [B<-cell> <I<cell name>>] >>> [B<-help>]
|
|
|
|
|
2009-10-08 22:01:39 +01:00
|
|
|
B<backup addvole> S<<< B<-n> <I<volume set name>> >>>
|
|
|
|
S<<< B<-s> <I<machine name>> >>>
|
|
|
|
S<<< B<-p> <I<partition name>> >>>
|
|
|
|
S<<< B<-v> <I<volume name (regular expression)>> >>>
|
2006-03-01 05:02:29 +00:00
|
|
|
[B<-l>] S<<< [B<-c> <I<cell name>>] >>> [B<-h>]
|
|
|
|
|
|
|
|
=for html
|
|
|
|
</div>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The B<backup addvolentry> command adds a volume entry definition to the
|
|
|
|
existing volume set named by the B<-name> argument. A volume entry
|
|
|
|
definition can match one or more volumes, depending on the combination of
|
|
|
|
the B<-server>, B<-partition>, and B<-volumes> arguments.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
For the B<-server> and B<-partition> arguments, provide either
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
|
|
|
=item *
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The name of one machine or partition.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=item *
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The metacharacter expression .* (period and asterisk), which matches every
|
|
|
|
machine name or partition name in the Volume Location Database (VLDB).
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=back
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
For the B<-volumes> argument, specify a combination of alphanumeric
|
2005-12-08 12:14:33 +00:00
|
|
|
characters and one or more metacharacters to wildcard part or all of the
|
2011-06-10 02:14:05 +01:00
|
|
|
volume name. L</OPTIONS> lists the acceptable metacharacters.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
=head1 CAUTIONS
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
It is best to issue this command in interactive mode. If issuing it at the
|
|
|
|
shell prompt, enclose any strings containing metacharacters in double
|
2005-12-08 12:14:33 +00:00
|
|
|
quotes, or escape the metacharacters with other delimiters, to prevent the
|
2005-12-13 19:21:13 +00:00
|
|
|
shell from interpreting them. Adding volume entries to a temporary volume
|
|
|
|
set is possible only within the interactive session in which the volume
|
2005-12-08 12:14:33 +00:00
|
|
|
set was created.
|
|
|
|
|
|
|
|
=head1 OPTIONS
|
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-name> <I<volume set name>>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Names the volume set to which to add this volume entry definition. The
|
|
|
|
volume set must already exist (use the B<backup addvolset> command to
|
|
|
|
create it).
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-server> <I<machine name>>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Defines the set of one or more file server machines that house the volumes
|
2005-12-13 19:21:13 +00:00
|
|
|
in the volume entry. Provide either one fully-qualified hostname (such as
|
doc: replace hostnames with IETF example hostnames
There were several different real and made-up hostnames and company names used
throughout our documentation examples.
The IETF has reserved "example.com" and other "example" TLDs for use in
examples (RFC 2606). Replace almost all references to ABC Corporation, DEF
Corporation, and State University, as well as "abc.com", "bigcell.com",
"def.com", "def.gov", "ghi.com", "ghi.gov", "jkl.com", "mit.edu",
"stanford.edu", "state.edu", "stateu.edu", "uncc.edu", and "xyz.com".
Standardize on "Example Corporation", "Example Network", "Example
Organization" (example.com, example.net, and example.org).
The Scout documentation in the Admin Guide contains PNG images that contain
the old cell names, so I left those references until the images can be
replaced.
Change-Id: I4e44815b2d2ffe204810b7fd850842248f67c367
Reviewed-on: http://gerrit.openafs.org/6697
Reviewed-by: Jeffrey Altman <jaltman@secure-endpoints.com>
Tested-by: Jeffrey Altman <jaltman@secure-endpoints.com>
2012-02-11 16:43:30 +00:00
|
|
|
C<fs1.example.com>) or the metacharacter expression C<.*> (period and
|
2005-12-13 19:21:13 +00:00
|
|
|
asterisk), which matches all machine names in the VLDB.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-partition> <I<partition name>>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Defines the set of one or more partitions that house the volumes in the
|
|
|
|
volume entry. Provide either one complete partition name (such as
|
2005-12-13 19:21:13 +00:00
|
|
|
C</vicepa>) or the metacharacter expression C<.*> (period and asterisk),
|
|
|
|
which matches all partition names.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-volumes> <I<volume name>>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
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:
|
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
2013-05-01 04:59:32 +01:00
|
|
|
=item C<.>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
The period matches any single character.
|
|
|
|
|
2013-05-01 04:59:32 +01:00
|
|
|
=item C<*>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The asterisk matches zero or more instances of the preceding character.
|
|
|
|
Combine it with any other alphanumeric character or metacharacter.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2013-05-01 04:59:32 +01:00
|
|
|
=item C<[ ]>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Square brackets around a list of characters match a single instance of any
|
2005-12-13 19:21:13 +00:00
|
|
|
of the characters, but no other characters; for example, C<[abc]> matches
|
|
|
|
a single C<a> or C<b> or C<c>, but not C<d> or C<A>. This expression can
|
|
|
|
be combined with the asterisk.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2013-05-01 04:59:32 +01:00
|
|
|
=item C<^>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
The caret, when used as the first character in a square-bracketed set,
|
2005-12-13 19:21:13 +00:00
|
|
|
designates a match with any single character I<except> the characters that
|
|
|
|
follow it; for example, C<[^a]> matches any single character except
|
|
|
|
lowercase C<a>. This expression can be combined with the asterisk.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2013-05-01 04:59:32 +01:00
|
|
|
=item C<\>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
A backslash preceding any of the metacharacters in this list makes it
|
2005-12-13 19:21:13 +00:00
|
|
|
match its literal value only. For example, the expression C<\.> (backslash
|
|
|
|
and period) matches a single period, C<\*> a single asterisk, and C<\\> a
|
|
|
|
single backslash. Such expressions can be combined with the asterisk (for
|
|
|
|
example, C<\.*> matches any number of periods).
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
Perhaps the most common metacharacter expression is the period followed by
|
2005-12-13 19:21:13 +00:00
|
|
|
an asterisk (C<.*>). 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> and B<-partition> 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 C<user> and
|
|
|
|
ends with C<backup>:
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
user.*backup
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-localauth>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Constructs a server ticket using a key from the local
|
2005-12-13 19:21:13 +00:00
|
|
|
F</usr/afs/etc/KeyFile> file. The B<backup> 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> argument. For
|
|
|
|
more details, see L<backup(8)>.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-cell> <I<cell name>>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Names the cell in which to run the command. Do not combine this argument
|
|
|
|
with the B<-localauth> flag. For more details, see L<backup(8)>.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-help>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Prints the online help for this command. All other valid options are
|
|
|
|
ignored.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
=head1 EXAMPLES
|
|
|
|
|
|
|
|
The following command adds a volume entry to the volume set called
|
2005-12-13 19:21:13 +00:00
|
|
|
C<sys>. The entry matches all volumes on any machine or partition whose
|
|
|
|
names begin with the string C<sun4x_56> followed by a period:
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
backup> addvolentry sys .* .* sun4x_56\..*
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The following command adds a volume entry to the volume set called C<fs2>,
|
|
|
|
to match all volumes on the F</vicepb> partition of file server machine
|
doc: replace hostnames with IETF example hostnames
There were several different real and made-up hostnames and company names used
throughout our documentation examples.
The IETF has reserved "example.com" and other "example" TLDs for use in
examples (RFC 2606). Replace almost all references to ABC Corporation, DEF
Corporation, and State University, as well as "abc.com", "bigcell.com",
"def.com", "def.gov", "ghi.com", "ghi.gov", "jkl.com", "mit.edu",
"stanford.edu", "state.edu", "stateu.edu", "uncc.edu", and "xyz.com".
Standardize on "Example Corporation", "Example Network", "Example
Organization" (example.com, example.net, and example.org).
The Scout documentation in the Admin Guide contains PNG images that contain
the old cell names, so I left those references until the images can be
replaced.
Change-Id: I4e44815b2d2ffe204810b7fd850842248f67c367
Reviewed-on: http://gerrit.openafs.org/6697
Reviewed-by: Jeffrey Altman <jaltman@secure-endpoints.com>
Tested-by: Jeffrey Altman <jaltman@secure-endpoints.com>
2012-02-11 16:43:30 +00:00
|
|
|
C<fs2.example.com>. Because it is issued at the shell prompt, double quotes
|
2005-12-13 19:21:13 +00:00
|
|
|
surround the metacharacters in the B<-volumes> argument. (The command is
|
|
|
|
shown here on two lines only for legibility reasons.)
|
2005-12-08 12:14:33 +00:00
|
|
|
|
doc: replace hostnames with IETF example hostnames
There were several different real and made-up hostnames and company names used
throughout our documentation examples.
The IETF has reserved "example.com" and other "example" TLDs for use in
examples (RFC 2606). Replace almost all references to ABC Corporation, DEF
Corporation, and State University, as well as "abc.com", "bigcell.com",
"def.com", "def.gov", "ghi.com", "ghi.gov", "jkl.com", "mit.edu",
"stanford.edu", "state.edu", "stateu.edu", "uncc.edu", and "xyz.com".
Standardize on "Example Corporation", "Example Network", "Example
Organization" (example.com, example.net, and example.org).
The Scout documentation in the Admin Guide contains PNG images that contain
the old cell names, so I left those references until the images can be
replaced.
Change-Id: I4e44815b2d2ffe204810b7fd850842248f67c367
Reviewed-on: http://gerrit.openafs.org/6697
Reviewed-by: Jeffrey Altman <jaltman@secure-endpoints.com>
Tested-by: Jeffrey Altman <jaltman@secure-endpoints.com>
2012-02-11 16:43:30 +00:00
|
|
|
% backup addvolentry -name fs2 -server fs2.example.com \
|
2005-12-08 12:14:33 +00:00
|
|
|
-partition /vicepb -volumes ".*"
|
|
|
|
|
2010-05-26 18:20:57 +01:00
|
|
|
The chapter in the I<OpenAFS Administration Guide> about configuring the
|
2005-12-13 19:21:13 +00:00
|
|
|
AFS Backup System presents additional examples as well as advice on
|
|
|
|
grouping volumes.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 PRIVILEGE REQUIRED
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The issuer must be listed in the F</usr/afs/etc/UserList> file on every
|
|
|
|
machine where the Backup Server is running, or must be logged onto a
|
|
|
|
server machine as the local superuser C<root> if the B<-localauth> flag is
|
|
|
|
included.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
L<backup(8)>,
|
|
|
|
L<backup_addvolset(8)>,
|
|
|
|
L<backup_delvolentry(8)>,
|
|
|
|
L<backup_delvolset(8)>,
|
|
|
|
L<backup_listvolsets(8)>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
|
|
|
|
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
|
|
|
|
|
|
|
|
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.
|