Import Upstream version 1.8.5
[hcoop/debian/openafs.git] / doc / man-pages / pod8 / fileserver.pod.in
CommitLineData
805e021f
CE
1=head1 NAME
2
3fileserver - Initializes the File Server component of the fs process
4
5=head1 SYNOPSIS
6
7=for html
8<div class="synopsis">
9
10=include fragments/fileserver-synopsis.pod
11
12=for html
13</div>
14
15=head1 DESCRIPTION
16
17The B<fileserver> command initializes the File Server component of the
18C<fs> process. In the conventional configuration, its binary file is
19located in the F</usr/afs/bin> directory on a file server machine.
20
21The B<fileserver> command is not normally issued at the command shell
22prompt, but rather placed into a database server machine's
23F</usr/afs/local/BosConfig> file with the B<bos create> command. If it is
24ever issued at the command shell prompt, the issuer must be logged onto a
25file 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=back
38
39=head1 EXAMPLES
40
41The following B<bos create> command creates a traditional fs process on
42the file server machine C<fs2.example.com> that uses the large configuration
43size, and allows volumes to exceed their quota by 10%. Type the command on
44a single line:
45
46 % bos create -server fs2.example.com -instance fs -type fs \
47 -cmd "/usr/afs/bin/fileserver -pctspare 10 -L" \
48 /usr/afs/bin/volserver /usr/afs/bin/salvager
49
50=head1 TROUBLESHOOTING
51
52=include fragments/fileserver-troubleshooting.pod
53
54=head1 PRIVILEGE REQUIRED
55
56=include fragments/fileserver-privilege.pod
57
58=head1 SEE ALSO
59
60=include fragments/fileserver-also.pod
61L<dafileserver(8)>,
62
63=head1 COPYRIGHT
64
65=include fragments/fileserver-copyright.pod