jimzah/openafs
1
0
Fork 0
mirror of https://git.openafs.org/openafs.git synced 2025-01-19 07:20:11 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
8e1ca72b1c
openafs/doc/man-pages/pod8/dafileserver.pod.in

123 lines
3.7 KiB
Plaintext
Raw Normal View History

document dafileserver split dafileserver and fileserver documentation. remove dafs-only switches from fileserver doc. refer both ways between docs. Change-Id: Ibcac8ed3f294c18436978f3cd4e52de305130198 Reviewed-on: http://gerrit.openafs.org/2425 Reviewed-by: Derrick Brashear <shadow@dementia.org> Tested-by: Derrick Brashear <shadow@dementia.org>
2010-07-16 18:21:57 +01:00
=head1 NAME
dafileserver - Initializes the File Server component of the dafs process
=head1 SYNOPSIS
=for html
<div class="synopsis">
=include fragments/dafileserver-synopsis.pod
=for html
</div>
=head1 DESCRIPTION
The B<dafileserver> command initializes the File Server component of the
C<dafs> process. In the conventional configuration, its binary file is
located in the F</usr/afs/bin> directory on a file server machine.
The B<dafileserver> 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
=item B<-fs-state-dont-save>
When present, fileserver state will not be saved during shutdown. Default
is to save state.
=item B<-fs-state-dont-restore>
When present, fileserver state will not be restored during startup.
Default is to restore state on startup.
=item B<-fs-state-verify> (none | save | restore | both)
This argument controls the behavior of the state verification mechanism.
A value of C<none> turns off all verification. A value of C<save> only
performs the verification steps prior to saving state to disk. A value
of C<restore> only performs the verification steps after restoring state
from disk. A value of C<both> performs all verifications steps both
prior to save and following a restore.
The default is C<both>.
doc: fileserver manpage fixes - Fix typo in -syslog option formatting - Add missing -nobusy - Add missing -vlrudisable - Add missing -sync in synopsis Change-Id: Id63c3228af619c2da5ef88a40e9c2e91888535bb Reviewed-on: http://gerrit.openafs.org/10393 Tested-by: BuildBot <buildbot@rampaginggeek.com> Reviewed-by: Derrick Brashear <shadow@your-file-system.com>
2013-06-14 22:54:01 +01:00
=item B<-vlrudisable>
This option completely disables the VLRU mechanism, which means volumes will
never "soft detach". The use of this option is only intended for debugging use
or if you find a serious bug in the VLRU mechanism you wish to work around.
document dafileserver split dafileserver and fileserver documentation. remove dafs-only switches from fileserver doc. refer both ways between docs. Change-Id: Ibcac8ed3f294c18436978f3cd4e52de305130198 Reviewed-on: http://gerrit.openafs.org/2425 Reviewed-by: Derrick Brashear <shadow@dementia.org> Tested-by: Derrick Brashear <shadow@dementia.org>
2010-07-16 18:21:57 +01:00
=item B<-vlruthresh <I<minutes>>
The number of minutes of inactivity before a volume is eligible for soft
detachment. Default is 120 minutes.
=item B<-vlruinterval <I<seconds>>
The number of seconds between VLRU candidate queue scan. The default is
120 seconds.
=item B<-vlrumax <I<positive integer>>
The maximum number of volumes which can be soft detached in a single pass
of the scanner. Default is 8 volumes.
=item B<-unsafe-nosalvage>
This option causes the fileserver to bypass the normal safety check when
attaching volumes that checks the inUse field in the volume header. With
this option, volumes that were in use at the time of an unclean shutdown
will not be salvaged immediately the next time they are accessed, and thus
risk (possibly silent and/or irrevocable) corruption. Volumes will still
be salvaged when an internal inconsistency is detected or other cases
where a salvage would normally occur.
Due to the increased risk of data corruption, the use of this flag is
strongly discouraged. Only use it if you really know what you are doing.
=back
=head1 EXAMPLES
The following B<bos create> command creates a dafs 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
document dafileserver split dafileserver and fileserver documentation. remove dafs-only switches from fileserver doc. refer both ways between docs. Change-Id: Ibcac8ed3f294c18436978f3cd4e52de305130198 Reviewed-on: http://gerrit.openafs.org/2425 Reviewed-by: Derrick Brashear <shadow@dementia.org> Tested-by: Derrick Brashear <shadow@dementia.org>
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 dafs -type dafs \
docs: Refer to dafs binaries by their real names (Most of) the dafs binaries are called da(something). Update the example in the dafileserver documentation so that we call the binaries by the names that they are actually installed with on the system. Change-Id: I05906758aa2b00ea7bc7f9be10414c8ad1a5a11a Reviewed-on: http://gerrit.openafs.org/5654 Tested-by: Simon Wilkinson <sxw@inf.ed.ac.uk> Reviewed-by: Derrick Brashear <shadow@dementix.org>
2011-10-10 23:19:13 +01:00
-cmd "/usr/afs/bin/dafileserver -pctspare 10 -L" \
/usr/afs/bin/davolserver \
document dafileserver split dafileserver and fileserver documentation. remove dafs-only switches from fileserver doc. refer both ways between docs. Change-Id: Ibcac8ed3f294c18436978f3cd4e52de305130198 Reviewed-on: http://gerrit.openafs.org/2425 Reviewed-by: Derrick Brashear <shadow@dementia.org> Tested-by: Derrick Brashear <shadow@dementia.org>
2010-07-16 18:21:57 +01:00
/usr/afs/bin/salvageserver \
docs: Refer to dafs binaries by their real names (Most of) the dafs binaries are called da(something). Update the example in the dafileserver documentation so that we call the binaries by the names that they are actually installed with on the system. Change-Id: I05906758aa2b00ea7bc7f9be10414c8ad1a5a11a Reviewed-on: http://gerrit.openafs.org/5654 Tested-by: Simon Wilkinson <sxw@inf.ed.ac.uk> Reviewed-by: Derrick Brashear <shadow@dementix.org>
2011-10-10 23:19:13 +01:00
/usr/afs/bin/dasalvager
document dafileserver split dafileserver and fileserver documentation. remove dafs-only switches from fileserver doc. refer both ways between docs. Change-Id: Ibcac8ed3f294c18436978f3cd4e52de305130198 Reviewed-on: http://gerrit.openafs.org/2425 Reviewed-by: Derrick Brashear <shadow@dementia.org> Tested-by: Derrick Brashear <shadow@dementia.org>
2010-07-16 18:21:57 +01:00
=head1 TROUBLESHOOTING
=include fragments/fileserver-troubleshooting.pod
=head1 PRIVILEGE REQUIRED
=include fragments/fileserver-privilege.pod
=head1 SEE ALSO
=include fragments/fileserver-also.pod
L<fileserver(8)>,
=head1 COPYRIGHT
=include fragments/fileserver-copyright.pod
Reference in New Issue Copy Permalink