2005-12-08 12:14:33 +00:00
|
|
|
=head1 NAME
|
|
|
|
|
|
|
|
vos syncserv - Verifies VLDB entries that mention a specified site
|
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
B<vos syncserv> B<-server> <I<machine name>>
|
|
|
|
[B<-partition> <I<partition name>>] [B<-cell> <I<cell name>>]
|
|
|
|
[B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>]
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-21 00:41:17 +00:00
|
|
|
B<vos syncs> B<-s> <I<machine name>> [B<-p> <I<partition name>>]
|
2005-12-09 14:48:56 +00:00
|
|
|
[B<-c> <I<cell name>>] [B<-n>] [B<-l>] [B<-v>] [B<-h>]
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
The B<vos syncserv> command verifies that each volume mentioned in a VLDB
|
|
|
|
entry actually exists at the site indicated in the entry. It checks all
|
|
|
|
VLDB entries that mention a read/write, read-only, or backup site either
|
|
|
|
on any partition on the file server machine specified by the B<-server>
|
|
|
|
argument, or on the one partition specified by the B<-server> and
|
|
|
|
B<-partition> arguments. Note that the command can end up inspecting sites
|
|
|
|
other than those specified by the B<-server> and B<-partition> arguments,
|
|
|
|
if there are versions of the volume at sites other than the one specified.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
The command alters any incorrect information in the VLDB, unless there is
|
|
|
|
an irreconcilable conflict with other VLDB entries. In that case, it
|
2005-12-09 14:48:56 +00:00
|
|
|
writes a message to the standard error stream instead. The command never
|
|
|
|
removes volumes from file server machines.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
To achieve complete VLDB consistency, first run the B<vos syncvldb>
|
|
|
|
command on all file server machines in the cell, then run this command on
|
|
|
|
all file server machines in the cell.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 OPTIONS
|
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
=item B<-server> <I<server name>>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Identifies the file server machine mentioned in each VLDB entry to
|
2005-12-09 14:48:56 +00:00
|
|
|
check. Provide the machine's IP address or its host name (either fully
|
|
|
|
qualified or using an unambiguous abbreviation). For details, see
|
|
|
|
L<vos(1)>.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
=item B<-partition> <I<partition name>>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
Identifies the partition mentioned in each VLDB entry to check. Provide
|
|
|
|
the partition's complete name with preceding slash (for example,
|
|
|
|
C</vicepa>) or use one of the three acceptable abbreviated forms. For
|
|
|
|
details, see L<vos(1)>.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
=item B<-cell> <I<cell name>>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +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<vos(1)>.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
=item B<-noauth>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
Assigns the unprivileged identity C<anonymous> to the issuer. Do not
|
|
|
|
combine this flag with the B<-localauth> flag. For more details, see
|
|
|
|
L<vos(1)>.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +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-09 14:48:56 +00:00
|
|
|
F</usr/afs/etc/KeyFile> file. The B<vos> command interpreter presents it
|
|
|
|
to the Volume Server and Volume Location Server during mutual
|
|
|
|
authentication. Do not combine this flag with the B<-cell> argument or
|
|
|
|
B<-noauth> flag. For more details, see L<vos(1)>.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
=item B<-verbose>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
Produces on the standard output stream a detailed trace of the command's
|
|
|
|
execution. If this argument is omitted, only warnings and error messages
|
|
|
|
appear.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
=item B<-help>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +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 example verifies the VLDB entries in which a site definition
|
2005-12-09 14:48:56 +00:00
|
|
|
mentions the file server machine C<fs3.abc.com>.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
% vos syncserv -server fs3.abc.com
|
|
|
|
|
|
|
|
=head1 PRIVILEGE REQUIRED
|
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
The issuer must be listed in the F</usr/afs/etc/UserList> file on the
|
|
|
|
machine specified with the B<-server> argument and on each database server
|
|
|
|
machine. If the B<-localauth> flag is included, the issuer must instead be
|
|
|
|
logged on to a server machine as the local superuser C<root>.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
|
|
|
|
L<vos(1)>,
|
|
|
|
L<vos_syncvldb(1)>
|
|
|
|
|
|
|
|
=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.
|