backup addvolentry - Defines a volume entry in a volume set

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]

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. the OPTIONS manpage lists the acceptable metacharacters.

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.

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). 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 CWfs1.abc.com) or the metacharacter expression CW.* (period and asterisk), which matches all machine names in the VLDB. Defines the set of one or more partitions that house the volumes in the volume entry. Provide either one complete partition name (such as CW/vicepa) or the metacharacter expression CW.* (period and asterisk), which matches all partition names. 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, CW[abc] matches a single CWa or CWb or CWc, but not CWd or CWA. 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, CW[^a] matches any single character except lowercase CWa. 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 CW\. (backslash and period) matches a single period, CW\* a single asterisk, and CW\\ a single backslash. Such expressions can be combined with the asterisk (for example, CW\.* matches any number of periods). Perhaps the most common metacharacter expression is the period followed by an asterisk (CW.*). 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 CWuser and ends with CWbackup:

   user.*backup

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

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

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

The issuer must be listed in the /etc/openafs/server/UserList file on every machine where the Backup Server is running, or must be logged onto a server machine as the local superuser CWroot if the -localauth flag is included.

the backup(8) manpage, the backup_addvolset(8) manpage, the backup_delvolentry(8) manpage, the backup_delvolset(8) manpage, the backup_listvolsets(8) manpage

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.