doc/man-pages/pod8/dafileserver.pod.in

   1 =head1 NAME
   2
   3 dafileserver - Initializes the File Server component of the dafs process
   4
   5 =head1 SYNOPSIS
   6
   7 =for html
   8 <div class="synopsis">
   9
  10 =include fragments/dafileserver-synopsis.pod
  11
  12 =for html
  13 </div>
  14
  15 =head1 DESCRIPTION
  16
  17 The B<dafileserver> command initializes the File Server component of the
  18 C<dafs> process. In the conventional configuration, its binary file is
  19 located in the F</usr/afs/bin> directory on a file server machine.
  20
  21 The B<dafileserver> command is not normally issued at the command shell
  22 prompt, but rather placed into a database server machine's
  23 F</usr/afs/local/BosConfig> file with the B<bos create> command. If it is
  24 ever issued at the command shell prompt, the issuer must be logged onto a
  25 file server machine as the local superuser C<root>.
  26
  27 =include fragments/fileserver-description.pod
  28
  29 =head1 CAUTIONS
  30
  31 =include fragments/fileserver-cautions.pod
  32
  33 =head1 OPTIONS
  34
  35 =include fragments/fileserver-options.pod
  36
  37 =item B<-fs-state-dont-save>
  38
  39 When present, fileserver state will not be saved during shutdown.  Default
  40 is to save state.
  41
  42 =item B<-fs-state-dont-restore>
  43
  44 When present, fileserver state will not be restored during startup.
  45 Default is to restore state on startup.
  46
  47 =item B<-fs-state-verify> (none | save | restore | both)
  48
  49 This argument controls the behavior of the state verification mechanism.
  50 A value of C<none> turns off all verification.  A value of C<save> only
  51 performs the verification steps prior to saving state to disk.  A value
  52 of C<restore> only performs the verification steps after restoring state
  53 from disk.  A value of C<both> performs all verifications steps both
  54 prior to save and following a restore.
  55
  56 The default is C<both>.
  57
  58 =item B<-vhashsize <I<size>>
  59
  60 The log(2) number of of volume hash buckets.  Default is 8 (i.e., by
  61 default, there are 2^8 = 256 volume hash buckets). The minimum that can
  62 be specified is 6 (64 hash buckets). In OpenAFS 1.5.77 and earlier, the
  63 maximum that can be specified is 14 (16384 buckets). After 1.5.77, the
  64 maximum that can be specified is 28 (268435456 buckets).
  65
  66 =item B<-vlrudisable>
  67
  68 This option completely disables the VLRU mechanism, which means volumes will
  69 never "soft detach". The use of this option is only intended for debugging use
  70 or if you find a serious bug in the VLRU mechanism you wish to work around.
  71
  72 =item B<-vlruthresh <I<minutes>>
  73
  74 The number of minutes of inactivity before a volume is eligible for soft
  75 detachment.  Default is 120 minutes.
  76
  77 =item B<-vlruinterval <I<seconds>>
  78
  79 The number of seconds between VLRU candidate queue scan.  The default is
  80 120 seconds.
  81
  82 =item B<-vlrumax <I<positive integer>>
  83
  84 The maximum number of volumes which can be soft detached in a single pass
  85 of the scanner.  Default is 8 volumes.
  86
  87 =item B<-unsafe-nosalvage>
  88
  89 This option causes the fileserver to bypass the normal safety check when
  90 attaching volumes that checks the inUse field in the volume header. With
  91 this option, volumes that were in use at the time of an unclean shutdown
  92 will not be salvaged immediately the next time they are accessed, and thus
  93 risk (possibly silent and/or irrevocable) corruption. Volumes will still
  94 be salvaged when an internal inconsistency is detected or other cases
  95 where a salvage would normally occur.
  96
  97 Due to the increased risk of data corruption, the use of this flag is
  98 strongly discouraged. Only use it if you really know what you are doing.
  99
 100 =back
 101
 102 =head1 EXAMPLES
 103
 104 The following B<bos create> command creates a dafs process on
 105 the file server machine C<fs2.example.com> that uses the large configuration
 106 size, and allows volumes to exceed their quota by 10%. Type the command on
 107 a single line:
 108
 109    % bos create -server fs2.example.com -instance dafs -type dafs \
 110                 -cmd "/usr/afs/bin/dafileserver -pctspare 10 -L" \
 111                 /usr/afs/bin/davolserver \
 112                 /usr/afs/bin/salvageserver \
 113                 /usr/afs/bin/dasalvager
 114
 115 =head1 TROUBLESHOOTING
 116
 117 =include fragments/fileserver-troubleshooting.pod
 118
 119 =head1 PRIVILEGE REQUIRED
 120
 121 =include fragments/fileserver-privilege.pod
 122
 123 =head1 SEE ALSO
 124
 125 =include fragments/fileserver-also.pod
 126 L<fileserver(8)>,
 127
 128 =head1 COPYRIGHT
 129
 130 =include fragments/fileserver-copyright.pod