doc/man-pages/pod8/fragments/fileserver-cautions.pod

   1 There are two strategies the File Server can use for attaching AFS volumes
   2 at startup and handling volume salvages.  The traditional method assumes
   3 all volumes are salvaged before the File Server starts and attaches all
   4 volumes at start before serving files.  The newer demand-attach method
   5 attaches volumes only on demand, salvaging them at that time as needed,
   6 and detaches volumes that are not in use.  A demand-attach File Server can
   7 also save state to disk for faster restarts. The B<dafileserver> implements
   8 the demand-attach method, while B<fileserver> uses the traditional method.
   9
  10 The choice of traditional or demand-attach File Server changes the
  11 required setup in F<BosConfig>. When changing from a traditional File
  12 Server to demand-attach or vice versa, you will need to stop and remove
  13 the C<fs> or C<dafs> node in F<BosConfig> and create a new node of the
  14 appropriate type. See L<bos_create(8)> for more information.
  15
  16 Do not use the B<-k> and B<-w> arguments, which are intended for use
  17 by the OpenAFS developers only. Changing them from their default
  18 values can result in unpredictable File Server behavior.  In any case,
  19 on many operating systems the File Server uses native threads rather
  20 than the LWP threads, so using the B<-k> argument to set the number of
  21 LWP threads has no effect.
  22
  23 Do not specify both the B<-spare> and B<-pctspare> arguments. Doing so
  24 causes the File Server to exit, leaving an error message in the
  25 F</usr/afs/logs/FileLog> file.
  26
  27 Options that are available only on some system types, such as the B<-m>
  28 and B<-lock> options, appear in the output generated by the B<-help>
  29 option only on the relevant system type.
  30
  31 Currently, the maximum size of a volume is 2 terabytes (2^31 bytes)
  32 and the maximum size of a /vicepX partition on a fileserver is 2^64
  33 kilobytes. The maximum partition size in releases 1.4.7 and earlier is
  34 2 terabytes (2^31 bytes). The maximum partition size for 1.5.x
  35 releases 1.5.34 and earlier is 2 terabytes as well.
  36
  37 The maximum number of directory entries is 64,000 if all of the entries
  38 have names that are 15 octets or less in length. A name that is 15 octets
  39 long requires the use of only one block in the directory. Additional
  40 sequential blocks are required to store entries with names that are longer
  41 than 15 octets. Each additional block provides an additional length of 32
  42 octets for the name of the entry. Note that if file names use an encoding
  43 like UTF-8, a single character may be encoded into multiple octets.
  44
  45 In real world use, the maximum number of objects in an AFS directory
  46 is usually between 16,000 and 25,000, depending on the average name
  47 length.