src/man/vos_syncserv.1

   1 vos syncserv               AFS Commands            vos syncserv
   2
   3
   4 NAME
   5
   6    vos  syncserv -- synchronize  VLDB  entries  that mention a
   7
   8                        given site with volume headers.
   9
  10
  11    vos syncserv  -server <machine name>  [-partition <partition
  12    name>]       [-cell <cell name>]  [-noauth]  [-localauth]
  13    [-verbose]
  14    [-help]
  15
  16 ACCEPTABLE ABBREVIATIONS/ALIASES
  17
  18    vos syncs  -s <machine name>  [-p <partition name>]
  19    [-c <cell name>]  [-n]  [-l]  [-v]  [-h]
  20
  21 DESCRIPTION
  22
  23    Finds and inspects the VLDB entries for volumes  (ReadWrite,
  24    ReadOnly  and  Backup)  residing  on the file server machine
  25    specified by -serverMEITHER all of the volumes OR  only  the
  26    volumes  on  the optionally specified -partition.  It checks
  27    that everything in the VLDB entry is correct, including  the
  28    reported  sites  of  all  copies  (even though that requires
  29    looking at volumes on servers other than  -server).    There
  30    are several possible changes it can make:
  31
  32       - If  a  volume  header  is marked Off-line, but the
  33         corresponding  VLDB  entry  is  normal,  then  the
  34         volume is brought on-line. (Note that the Off-line
  35         flag does not indicate the volume is corrupted.)
  36
  37       - If there are two  copies  of  a  given  volume  at
  38         different  sites,  both marked Off-line, the newer
  39         volume is brought on-line and  the  older  one  is
  40         deleted  from  its  site  and  the  VLDB.    (This
  41         situation  could  arise  if  the  execution  of  a
  42         vos move command were interrupted).
  43
  44       - If a volume recorded in the VLDB does not exist at
  45         the  indicated  site,  then  the  VLDB  entry   is
  46         changed.  In the case of ReadWrite, Backup and the
  47         last site for ReadOnly, that  means  changing  the
  48         appropriate VLDB status flag to invalid.
  49
  50    Run  this  command,  preferably on all file server machines,
  51    after vos syncvldb has been run on all file server machines.
  52
  53 ARGUMENTS
  54
  55    -server         names the file server machine for  which  to
  56                    check  entries  in  the  VLDB.   Abbreviated
  57                    forms  of  machine  names  may  be   allowed
  58                    depending on the naming service available at
  59                    the time the command is issued; see page xii
  60                    in   the   introductory  About  This  Manual
  61                    chapter.  -partition
  62                    names  the partition for which to check VLDB
  63                    entries.  In addition to  the  full  /vicepx
  64                    form  of  a  partition  name,  three shorter
  65
  66
  67
  68                    forms are acceptable; see page  xii  in  the
  69                    introductory   About  This  Manual  chapter.
  70                    -cell
  71                    specifies  the  cell  in  which  to  run the
  72                    command.  See section 8.3 in  the  Reference
  73                    Manual for more details.  -noauth
  74                    tells the Volume and Volume Location Servers
  75                    to  assign  the  identity  anonymous  to the
  76                    issuer.  See section 8.3  in  the  Reference
  77                    Manual for more details.  -localauth
  78                    constructs a server ticket using a key  from
  79                    /usr/afs/etc/KeyFile.    See  section 8.3 in
  80                    the  Reference  Manual  for  more   details.
  81                    -verbose
  82                    tells the Volume and Volume Location Servers
  83                    to  report  on  what  they are doing as they
  84                    execute the command.  See section 8.3 in the
  85                    Reference Manual for more details.  -help
  86                    prints the online help for this command.  Do
  87                    not  provide  any  other  arguments or flags
  88                    with this one.    See  section  8.3  in  the
  89                    Reference Manual for more details.
  90
  91 EXAMPLE
  92
  93    The  following alters the VLDB entries of volumes whose site
  94    definitions mention fs3.transarc.com  to  match  the  volume
  95    header.
  96
  97    % vos syncserv fs3.transarc.com
  98
  99 PRIVILEGE REQUIRED
 100
 101    Issuer must be listed in /usr/afs/etc/UserList on -server.
 102
 103 MORE INFORMATION
 104
 105    vos move vos syncvldb