src/man/fs_newcell.1

   1 fs newcell                 AFS Commands              fs newcell
   2
   3
   4 NAME
   5
   6    fs   newcell -- change   list  of  cell's  database  server
   7
   8                        machines in kernel.
   9
  10
  11                                                           +
  12    fs newcell -name <cell name> -servers <primary servers>
  13    [-help]
  14
  15 ACCEPTABLE ABBREVIATIONS/ALIASES
  16
  17                                            +
  18    fs n -n <cell name> -s <primary servers>   [-h]
  19
  20 DESCRIPTION
  21
  22    Removes the Cache Manager's kernel-resident list of database
  23    server  machines  for  the cell cell name, replacing it with
  24    primary servers.
  25
  26    This  command  does  not  make  permanent  changes  in   the
  27    workstation's /afs/vice/etc/CellServDB file, the contents of
  28    which are transferred into the kernel at each  reboot.    In
  29    other  words,  rebooting  the workstation will overwrite the
  30    changes made with this command, unless  the  issuer  changes
  31    CellServDB in the same way.
  32
  33    Changes  made  with  this command do appear in the output of
  34    fs listcells, since that command consults the in-kernel list
  35    rather than CellServDB.
  36
  37    This  command may be used to introduce a completely new cell
  38    into the kernel-resident list, but it  is  not  possible  to
  39    make  a cell inaccessible with this command (i.e., remove it
  40    from the kernel-resident list by not providing any instances
  41    for  -server).    To do that, the user must alter CellServDB
  42    and reboot the machine.
  43
  44 WARNING
  45
  46    Some commands work correctly only when both  CellServDB  and
  47    the  kernel-resident  list  correctly list a cell's database
  48    server machines.  The need  of  such  commands  for  correct
  49    information  in  CellServDB  precludes  use of this command.
  50    The klog command is a prominent example.
  51
  52 ARGUMENTS
  53
  54    -name   is the complete Internet-style name of the cell  for
  55            which the in-kernel list of database server machines
  56            will change.  It may be the local cell or a  foreign
  57            cell.
  58
  59    -servers
  60            names the database server machine(s) for the cell in
  61            question.     Provide  the  complete  Internet-style
  62            machine name for each machine.
  63
  64    -help   prints the online help entry for this command.    Do
  65
  66
  67
  68            not  provide  any other arguments or flags with this
  69            one.  See section 3.1 in the  Reference  Manual  for
  70            more details.
  71
  72 EXAMPLES
  73
  74    The  following changes the machine's kernel-resident list of
  75    database server machines for the Transarc  Corporation  cell
  76    to include fs1.transarc.com and fs2.transarc.com.
  77
  78    % fs n transarc.com fs1.transarc.com fs2.transarc.com
  79
  80 PRIVILEGE REQUIRED
  81
  82    Issuer  must  be logged in as "root" in the UNIX file system
  83    of the machine on which the command is being issued.
  84
  85 MORE INFORMATION
  86
  87    fs listcells