2010-07-16 18:21:57 +01:00
|
|
|
=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
|
2010-09-22 00:45:53 +01:00
|
|
|
|
2010-07-16 18:21:57 +01:00
|
|
|
=back
|
|
|
|
|
|
|
|
|
|
=head1 EXAMPLES
|
|
|
|
|
|
|
|
|
|
The following B<bos create> command creates a traditional fs process on
|
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-11 16:43:30 +00:00
|
|
|
the file server machine C<fs2.example.com> that uses the large configuration
|
2010-07-16 18:21:57 +01:00
|
|
|
size, and allows volumes to exceed their quota by 10%. Type the command on
|
|
|
|
|
a single line:
|
|
|
|
|
|
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-11 16:43:30 +00:00
|
|
|
% bos create -server fs2.example.com -instance fs -type fs \
|
2010-07-16 18:21:57 +01:00
|
|
|
-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
|
