document davolserver
[openafs.git] / doc / man-pages / pod8 / davolserver.pod.in
1 =head1 NAME
2
3 davolserver - Initializes the Volume Server component of the dafs process
4
5 =head1 SYNOPSIS
6
7 =for html
8 <div class="synopsis">
9
10 =include fragments/volserver-synopsis.pod
11
12 =for html
13 </div>
14
15 =head1 DESCRIPTION
16
17 The B<davolserver> command initializes the Volume 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<davolserver> command is not normally issued at the command shell
22 prompt but rather placed into a file 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 database server machine as the local superuser C<root>.
26
27 =include fragments/volserver-description.pod
28
29 =head1 OPTIONS
30
31 =include fragments/volserver-options.pod
32
33 =head1 EXAMPLES
34
35 The following B<bos create> command creates a C<davolserver> process on the
36 machine C<fs2.abc.com> as part of the dafs process:
37
38    % bos create -server fs2.abc.com -instance dafs -type dafs \
39                 -cmd "/usr/afs/bin/dafileserver" \
40                 /usr/afs/bin/davolserver \
41                 /usr/afs/bin/salvageserver \
42                 /usr/afs/bin/dasalvager
43
44 =head1 PRIVILEGE REQUIRED
45
46 =include fragments/volserver-privilege.pod
47
48 =head1 SEE ALSO
49
50 =include fragments/volserver-also.pod
51 L<volserver(8)>,
52
53 =head1 COPYRIGHT
54
55 =include fragments/fileserver-copyright.pod