src/man/vos_syncvldb.1

   1 vos syncvldb               AFS Commands            vos syncvldb
   2
   3
   4 NAME
   5
   6    vos  syncvldb -- synchronize VLDB entry with volume headers
   7
   8                        at given site.
   9
  10
  11    vos syncvldb  -server <machine name>  [-partition <partition
  12    name>]       [-cell <cell name>]  [-noauth]  [-localauth]
  13    [-verbose]
  14    [-help]
  15
  16 ACCEPTABLE ABBREVIATIONS/ALIASES
  17
  18    vos syncv  -s <machine name>  [-p <partition name>]  [-c
  19    <cell name>]
  20    [-n]  [-l]  [-v]  [-h]
  21
  22 DESCRIPTION
  23
  24    Inspects the volumes  housed  on  the  file  server  machine
  25    indicated with -serverMEITHER all of the volumes OR only the
  26    volumes on the optionally specified -partition.   It  checks
  27    that  the  VLDB  properly  records every volume whose volume
  28    header is marked On-line.  In case  of  discrepancies,  this
  29    command  alters  VLDB  entries to reflect the true status of
  30    volumes on -server.  It has other side effects:
  31
  32       - If it finds a Backup volume whose ReadWrite source
  33         no  longer exists at the same site, it removes the
  34         Backup.  The  VLDB  status  flag  for  the  Backup
  35         changes to invalid.  The issuer will have to issue
  36         the vos backup command to create a new  Backup  if
  37         desired.
  38
  39       - The  VL  Server  keeps track of the next available
  40         volumeID number with  a  counter.    This  command
  41         changes the counter to the highest volumeID number
  42         found.
  43
  44       - If it encounters multiple  ReadOnly  copies  of  a
  45         volume  at  the  same  site,  or  multiple  Backup
  46         copies, it removes all  but  the  newest  one  (as
  47         determined  by  the  Creation  Date  field  in the
  48         volume header) from that site.
  49
  50    After running this command, execute vos syncserv, preferably
  51    on all file server machines in the cell.
  52
  53 ARGUMENTS
  54
  55    -server         names  the file server machine from which to
  56                    compare    volumes    to    VLDB    entries.
  57                    Abbreviated  forms  of  machine names may be
  58                    allowed  depending  on  the  naming  service
  59                    available at the time the command is issued;
  60                    see page xii in the introductory About  This
  61                    Manual chapter.  -partition
  62                    names the partition from  which  to  compare
  63                    volumes to VLDB entries.  In addition to the
  64                    full /vicepx form of a partition name, three
  65
  66
  67
  68                    shorter  forms  are acceptable; see page xii
  69                    in  the  introductory  About   This   Manual
  70                    chapter.
  71
  72    -cell           specifies  the  cell  in  which  to  run the
  73                    command.  See section 8.3 in  the  Reference
  74                    Manual for more details.  -noauth
  75                    tells the Volume and Volume Location Servers
  76                    to  assign  the  identity  anonymous  to the
  77                    issuer.  See section 8.3  in  the  Reference
  78                    Manual for more details.  -localauth
  79                    constructs a server ticket using a key  from
  80                    /usr/afs/etc/KeyFile.    See  section 8.3 in
  81                    the  Reference  Manual  for  more   details.
  82                    -verbose
  83                    tells the Volume and Volume Location Servers
  84                    to  report  on  what  they are doing as they
  85                    execute the command.  See section 8.3 in the
  86                    Reference Manual for more details.  -help
  87                    prints the online help for this command.  Do
  88                    not  provide  any  other  arguments or flags
  89                    with this one.    See  section  8.3  in  the
  90                    Reference Manual for more details.
  91
  92 EXAMPLE
  93
  94    The  following  makes  sure that the VLDB matches the volume
  95    headers found at sites on fs4.transarc.com.
  96
  97    % vos syncvldb fs4.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 backup vos syncserv