backup_addvolentry man page on Scientific

Man page or keyword search:  
man Server   26626 pages
apropos Keyword Search (all sections)
Output format
Scientific logo
[printable version]

BACKUP_ADDVOLENTRY(8)	     AFS Command Reference	 BACKUP_ADDVOLENTRY(8)

NAME
       backup_addvolentry - Defines a volume entry in a volume set

SYNOPSIS
       backup addvolentry -name <volume set name>
	   -server <machine name>
	   -partition <partition name>
	   -volumes <volume name (regular expression)>
	   [-localauth] [-cell <cell name>] [-help]

       backup addvole -n <volume set name>
	   -s <machine name>
	   -p <partition name>
	   -v <volume name (regular expression)>
	   [-l] [-c <cell name>] [-h]

DESCRIPTION
       The backup addvolentry command adds a volume entry definition to the
       existing volume set named by the -name argument. A volume entry
       definition can match one or more volumes, depending on the combination
       of the -server, -partition, and -volumes arguments.

       For the -server and -partition arguments, provide either

       ·   The name of one machine or partition.

       ·   The metacharacter expression .* (period and asterisk), which
	   matches every machine name or partition name in the Volume Location
	   Database (VLDB).

       For the -volumes argument, specify a combination of alphanumeric
       characters and one or more metacharacters to wildcard part or all of
       the volume name. OPTIONS lists the acceptable metacharacters.

CAUTIONS
       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.

OPTIONS
       -name <volume set name>
	   Names the volume set to which to add this volume entry definition.
	   The volume set must already exist (use the backup addvolset command
	   to create it).

       -server <machine name>
	   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 "fs1.abc.com") or the metacharacter expression
	   ".*" (period and asterisk), which matches all machine names in the
	   VLDB.

       -partition <partition name>
	   Defines the set of one or more partitions that house the volumes in
	   the volume entry. Provide either one complete partition name (such
	   as "/vicepa") or the metacharacter expression ".*" (period and
	   asterisk), which matches all partition names.

       -volumes <volume name>
	   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:

	   "." The period matches any single character.

	   "*" The asterisk matches zero or more instances of the preceding
	       character.  Combine it with any other alphanumeric character or
	       metacharacter.

	   "[ ]"
	       Square brackets around a list of characters match a single
	       instance of any of the characters, but no other characters; for
	       example, "[abc]" matches a single "a" or "b" or "c", but not
	       "d" or "A". This expression can be combined with the asterisk.

	   "^" The caret, when used as the first character in a square-
	       bracketed set, designates a match with any single character
	       except the characters that follow it; for example, "[^a]"
	       matches any single character except lowercase "a". This
	       expression can be combined with the asterisk.

	   "\" A backslash preceding any of the metacharacters in this list
	       makes it match its literal value only. For example, the
	       expression "\." (backslash and period) matches a single period,
	       "\*" a single asterisk, and "\\" a single backslash.  Such
	       expressions can be combined with the asterisk (for example,
	       "\.*" matches any number of periods).

	   Perhaps the most common metacharacter expression is the period
	   followed by an asterisk (".*"). 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 -server and
	   -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 "user" and ends with
	   "backup":

	      user.*backup

       -localauth
	   Constructs a server ticket using a key from the local
	   /usr/afs/etc/KeyFile file. The backup command interpreter presents
	   it to the Backup Server, Volume Server and VL Server during mutual
	   authentication. Do not combine this flag with the -cell argument.
	   For more details, see backup(8).

       -cell <cell name>
	   Names the cell in which to run the command. Do not combine this
	   argument with the -localauth flag. For more details, see backup(8).

       -help
	   Prints the online help for this command. All other valid options
	   are ignored.

EXAMPLES
       The following command adds a volume entry to the volume set called
       "sys". The entry matches all volumes on any machine or partition whose
       names begin with the string "sun4x_56" followed by a period:

	  backup> addvolentry sys .* .* sun4x_56\..*

       The following command adds a volume entry to the volume set called
       "fs2", to match all volumes on the /vicepb partition of file server
       machine "fs2.abc.com". Because it is issued at the shell prompt, double
       quotes surround the metacharacters in the -volumes argument. (The
       command is shown here on two lines only for legibility reasons.)

	  % backup addvolentry -name fs2 -server fs2.abc.com \
			       -partition /vicepb -volumes ".*"

       The chapter in the OpenAFS Administration Guide about configuring the
       AFS Backup System presents additional examples as well as advice on
       grouping volumes.

PRIVILEGE REQUIRED
       The issuer must be listed in the /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 "root" if the -localauth flag is
       included.

SEE ALSO
       backup(8), backup_addvolset(8), backup_delvolentry(8),
       backup_delvolset(8), backup_listvolsets(8)

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.

OpenAFS				  2013-10-09		 BACKUP_ADDVOLENTRY(8)
[top]

List of man pages available for Scientific

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net