openafs/doc/man-pages/pod8/fileserver.pod.in
Ken Dreyer 1cc8feb6fc doc: replace hostnames with IETF example hostnames
There were several different real and made-up hostnames and company names used
throughout our documentation examples.

The IETF has reserved "example.com" and other "example" TLDs for use in
examples (RFC 2606). Replace almost all references to ABC Corporation, DEF
Corporation, and State University, as well as "abc.com", "bigcell.com",
"def.com", "def.gov", "ghi.com", "ghi.gov", "jkl.com", "mit.edu",
"stanford.edu", "state.edu", "stateu.edu", "uncc.edu", and "xyz.com".
Standardize on "Example Corporation", "Example Network", "Example
Organization" (example.com, example.net, and example.org).

The Scout documentation in the Admin Guide contains PNG images that contain
the old cell names, so I left those references until the images can be
replaced.

Change-Id: I4e44815b2d2ffe204810b7fd850842248f67c367
Reviewed-on: http://gerrit.openafs.org/6697
Reviewed-by: Jeffrey Altman <jaltman@secure-endpoints.com>
Tested-by: Jeffrey Altman <jaltman@secure-endpoints.com>
2012-02-17 20:51:58 -08:00

66 lines
1.6 KiB
Plaintext

=head1 NAME
fileserver - Initializes the File Server component of the fs process
=head1 SYNOPSIS
=for html
<div class="synopsis">
=include fragments/fileserver-synopsis.pod
=for html
</div>
=head1 DESCRIPTION
The B<fileserver> command initializes the File Server component of the
C<fs> process. In the conventional configuration, its binary file is
located in the F</usr/afs/bin> directory on a file server machine.
The B<fileserver> command is not normally issued at the command shell
prompt, but rather placed into a database server machine's
F</usr/afs/local/BosConfig> file with the B<bos create> command. If it is
ever issued at the command shell prompt, the issuer must be logged onto a
file server machine as the local superuser C<root>.
=include fragments/fileserver-description.pod
=head1 CAUTIONS
=include fragments/fileserver-cautions.pod
=head1 OPTIONS
=include fragments/fileserver-options.pod
=back
=head1 EXAMPLES
The following B<bos create> command creates a traditional fs process on
the file server machine C<fs2.example.com> that uses the large configuration
size, and allows volumes to exceed their quota by 10%. Type the command on
a single line:
% bos create -server fs2.example.com -instance fs -type fs \
-cmd "/usr/afs/bin/fileserver -pctspare 10 -L" \
/usr/afs/bin/volserver /usr/afs/bin/salvager
=head1 TROUBLESHOOTING
=include fragments/fileserver-troubleshooting.pod
=head1 PRIVILEGE REQUIRED
=include fragments/fileserver-privilege.pod
=head1 SEE ALSO
=include fragments/fileserver-also.pod
L<dafileserver(8)>,
=head1 COPYRIGHT
=include fragments/fileserver-copyright.pod