doc/man-pages/pod1/vos_syncvldb.pod.in

   1 =head1 NAME
   2
   3 vos_syncvldb - Verifies VLDB entries for volumes residing at specified site
   4
   5 =head1 SYNOPSIS
   6
   7 =for html
   8 <div class="synopsis">
   9
  10 B<vos syncvldb> S<<< [B<-server> <I<machine name>>] >>>
  11     S<<< [B<-partition> <I<partition name>>] >>>
  12     S<<< [B<-volume> <I<volume name or ID>>] >>>
  13     [B<-dryrun>] S<<< [B<-cell> <I<cell name>>] >>>
  14     [B<-noauth>] [B<-localauth>]
  15     [B<-verbose>] [B<-encrypt>] [B<-noresolve>]
  16     S<<< [B<-config> <I<config directory>>] >>>
  17     [B<-help>]
  18
  19 B<vos syncv> S<<< [B<-s> <I<machine name>>] >>>
  20     S<<< [B<-p> <I<partition name>>] >>>
  21     S<<< [B<-vo> <I<volume name or ID>>] >>>
  22     [B<-d>] S<<< [B<-c> <I<cell name>>] >>>
  23     [B<-noa>] [B<-l>] [B<-ve>] [B<-e>] [B<-nor>]
  24     S<<< [B<-co> <I<config directory>>] >>>
  25     [B<-h>]
  26
  27 =for html
  28 </div>
  29
  30 =head1 DESCRIPTION
  31
  32 The B<vos syncvldb> command verifies that the status of the volumes housed
  33 either on all partitions on the file server machine specified by the
  34 B<-server> argument, or on the single partition specified by the
  35 B<-server> and B<-partition> arguments, is recorded correctly in the
  36 VLDB. If the B<-volume> argument is included to indicate a single volume,
  37 the command compares only its status on the file server machine with its
  38 VLDB entry.
  39
  40 If the B<-volume> argument is not included, the command interpreter
  41 obtains from the Volume Server a list of the volumes that reside on each
  42 partition, then changes information in the VLDB as necessary to reflect
  43 their state on the partition. For example, it creates or updates a VLDB
  44 entry when it finds a volume for which the VLDB entry is missing or
  45 incomplete. However, if there is already a VLDB entry that defines a
  46 different location for the volume, or there are irreconcilable conflicts
  47 with other VLDB entries, it instead writes a message about the conflict to
  48 the standard error stream. The command never removes volumes from the file
  49 server machine.
  50
  51 To achieve complete VLDB consistency, run this command on all file server
  52 machines in the cell, and then run the B<vos syncserv> command on all file
  53 server machines in the cell.
  54
  55 Using the B<-volume> argument basically combines the effects of this
  56 command with those of the B<vos syncserv> command, for a single
  57 volume. The command not only verifies that the VLDB entry is correct for
  58 the specified volume type (read/write, backup, or read-only), but also
  59 checks that any related volume types mentioned in the VLDB entry actually
  60 exist at the site listed in the entry. It is not necessary to provide the
  61 B<-server> argument (and optionally, B<-partition> argument); if one or
  62 both is provided, the results are reliable only if they specify the actual
  63 location of the volume indicated by the B<-volume> argument.
  64
  65 =head1 OPTIONS
  66
  67 =over 4
  68
  69 =item B<-server> <I<server name>>
  70
  71 Identifies the file server machine housing the volumes for which to verify
  72 VLDB entries. Provide the machine's IP address or its host name (either
  73 fully qualified or using an unambiguous abbreviation). For details, see
  74 L<vos(1)>.
  75
  76 =item B<-partition> <I<partition name>>
  77
  78 Identifies the partition housing the volumes for which to verify VLDB
  79 entries. Provide the B<-server> argument along with this one. Provide the
  80 partition's complete name with preceding slash (for example, C</vicepa>)
  81 or use one of the three acceptable abbreviated forms. For details, see
  82 L<vos(1)>.
  83
  84 =item B<-volume> <I<volume name or ID>>
  85
  86 Specifies the name or volume ID number of a single volume for which to
  87 verify the VLDB entry. This argument can be combined with the B<-server>
  88 (and optionally, the B<-partition>) argument.
  89
  90 =item B<-dryrun>
  91
  92 Show the actions which would be taken, but do not make changes.
  93
  94 =include fragments/vos-common.pod
  95
  96 =back
  97
  98 =head1 EXAMPLES
  99
 100 The following example command verifies the VLDB entry for each volume
 101 stored on the file server machine C<fs4.example.com>.
 102
 103    % vos syncvldb fs4.example.com
 104
 105 =head1 PRIVILEGE REQUIRED
 106
 107 The issuer must be listed in the F</usr/afs/etc/UserList> file on the
 108 machine specified with the B<-server> argument and on each database server
 109 machine. If the B<-localauth> flag is included, the issuer must instead be
 110 logged on to a server machine as the local superuser C<root>.
 111
 112 =head1 SEE ALSO
 113
 114 L<vos(1)>,
 115 L<vos_syncserv(1)>
 116
 117 =head1 COPYRIGHT
 118
 119 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
 120
 121 This documentation is covered by the IBM Public License Version 1.0.  It was
 122 converted from HTML to POD by software written by Chas Williams and Russ
 123 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.