Man Linux: Main Page and Category List

NAME

       update_indexes - clean indexes from erased tapes

SYNOPSIS

       update_indexes [ -v ]  [ -c <configuration-file> ] [ -h <backuphosts> ]
       [ -P <backup-ports> ] [ -I <indexfile-part> ] [ -V <var-directory> ]  [
       -k  <encryption-key-file>  ]  [  -W  <identity>  ]  [  -z <process-cmd>
       <unprocess-cmd> ] [ -Z <built-in-compress-level> ]

DESCRIPTION

       This command asks all the servers, which tapes are considered  precious
       for  the client, it is run on. If the server will tell fewer tapes than
       the client has in mind, then the tapes, that the server  omitted,  have
       been  erased on the server side. Now those entries will be removed from
       the client’s indexes, who list the erased  tapes  as  backup  location.
       This  command  may  be installed setuid root, so normal users can start
       it. As it performs just a defined update operation  and  nothing  else,
       there  should not be a security problem. It might be a good idea to run
       this command before some user  restore  program  (e.g.  xafrestore)  is
       started,  so  only  those  entries  are listed to the user, that really
       exist on backup media and can be restored. When  started  by  a  normal
       user,  all arguments will be ignored and only the configuration file is
       evaluated.

       -c <configfile>
              Use the given file for configuration information

       -h <hostname>
              Use the given list of hosts as backup servers.  The hostnames in
              this list can be separated by whitespace and/or commas

       -I <idx-prefix>
              The  first  part  of the filename, the names of the stored files
              and directories can be found. The current total backup number is
              appended (that increments each start of a full backup). If these
              files undergo processing, .z is appended

       -k <file>
              Use the contents  of  the  given  file  as  encryption  key  for
              authenticating  to  the  server,  where  the  source  or  target
              cartridge is handled, respectively

       -P <portnum>
              The  list  of  port  numbers  for  the  backup  servers   either
              configured in the parameter file or supplied with the -h option.
              The port numbers in this list can  be  separated  by  whitespace
              and/or commas

       -V <var-dir>
              The directory, where varying files are put

       -v     Verbose option, tell more about what is going on

       -W <id>
              Identify  as <id> to the server. This is needed by the server to
              tell the client the correct information about  tapes,  that  are
              considered crucial for this client for restore

       -z <z> <uz>
              The  commands  to  use  for  process and unprocess. If a command
              comprises of several words, it must be put in quotes

       -Z <level>
              If built-in  compression  should  be  used,  the  level  can  be
              supplied  here.  If  commands  to process and unprocess are also
              supplied with option -z, then data is  first  processed  by  the
              process command, then by built-in compression. During uncompress
              it works the other way round

FILES

       /etc/afbackup/client.conf
              Client configuration file

       /var/log/afbackup
              The directory for logging the client backups

       /var/lib/afbackup
              Some internal state information of the client backups.

SEE ALSO

       afclientconfig(8), xafclientconfig(8), full_backup(8),  incr_backup(8),
       afverify(8),     afrestore(8),     xafrestore(8),    update_indexes(8),
       copy_tape(8),     afclient.conf(8),     afserver(8),      afmserver(8),
       afserver.conf(8), tar(1)

AUTHOR

       afbackup was written by Albert Fluegel (af@muc.de)