2
''' $RCSfile$$Revision$$Date$
20
.ie \\n(.$>=3 .ne \\$3
36
''' Set up \*(-- to give an unbreakable dash;
37
''' string Tr holds user defined translation string.
38
''' Bell System Logo is used as a dummy character.
44
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
45
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
48
''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
49
''' \*(L" and \*(R", except that they are used on ".xx" lines,
50
''' such as .IP and .SH, which do another additional levels of
51
''' double-quote interpretation
80
.\" If the F register is turned on, we'll generate
81
.\" index entries out stderr for the following things:
86
.\" X<> Xref (embedded
87
.\" Of course, you have to process the output yourself
88
.\" in some meaninful fashion.
91
.tm Index:\\$1\t\\n%\t"\\$2"
96
.TH volserver 8 "OpenAFS" "1/Mar/2006" "AFS Command Reference"
100
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
101
.de CQ \" put $1 in typewriter font
107
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
110
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
111
. \" AM - accent mark definitions
113
. \" fudge factors for nroff and troff
122
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
128
. \" simple accents for nroff and troff
141
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
142
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
143
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
144
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
145
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
146
. ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
147
. ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
148
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
149
. ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
151
. \" troff and (daisy-wheel) nroff accents
152
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
153
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
154
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
155
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
156
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
157
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
158
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
159
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
160
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
161
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
162
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
163
.ds ae a\h'-(\w'a'u*4/10)'e
164
.ds Ae A\h'-(\w'A'u*4/10)'E
165
.ds oe o\h'-(\w'o'u*4/10)'e
166
.ds Oe O\h'-(\w'O'u*4/10)'E
167
. \" corrections for vroff
168
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
169
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
170
. \" for low resolution devices (crt and lpr)
171
.if \n(.H>23 .if \n(.V>19 \
175
. ds v \h'-1'\o'\(aa\(ga'
191
volserver \- Initializes the Volume Server component of the fs process
193
\fBvolserver\fR [\fB\-log\fR] <<\ [\fB\-p\fR\ <\fInumber\ of\ processes\fR] >>>
194
<<\ [\fB\-udpsize\fR\ <\fIsize\ of\ socket\ buffer\ in\ bytes\fR] >>>
195
[\fB\-enable_peer_stats\fR] [\fB\-enable_process_stats\fR] [\fB\-help\fR]
197
The \fBvolserver\fR command initializes the Volume Server component of the
198
\f(CWfs\fR process. In the conventional configuration, its binary file is
199
located in the \fI/usr/afs/bin\fR directory on a file server machine.
201
The \fBvolserver\fR command is not normally issued at the command shell
202
prompt but rather placed into a file server machine's
203
\fI/usr/afs/local/BosConfig\fR file with the \fBbos create\fR command. If it is
204
ever issued at the command shell prompt, the issuer must be logged onto a
205
database server machine as the local superuser \f(CWroot\fR.
207
The Volume Server records a trace of its activity in the
208
\fI/usr/afs/logs/VolserLog\fR file. Use the \fBbos getlog\fR command to display
209
the contents of the file.
211
The Volume Server processes the \fBvos\fR commands that administrators use to
212
create, delete, move, and replicate volumes, as well as prepare them for
213
archiving to tape or other media.
215
By default, the VL Server runs nine lightweight processes (LWPs). To
216
change the number, use the \fB\-p\fR argument.
218
This command does not use the syntax conventions of the AFS command
219
suites. Provide the command name and all option names in full.
222
Records in the /usr/afs/logs/VolserLog file the names of all users who
223
successfully initiate a \fBvos\fR command. The Volume Server also records any
224
file removals that result from issuing the \fBvos release\fR command with the
226
.Ip "\fB\-p\fR <\fInumber of processes\fR>" 4
227
Sets the number of server lightweight processes (LWPs) to run. Provide an
228
integer between \f(CW4\fR and \f(CW16\fR. The default is \f(CW9\fR.
229
.Ip "\fB\-udpsize\fR <\fIsize of socket buffer\fR>" 4
230
Sets the size of the \s-1UDP\s0 buffer in bytes, which is 64 \s-1KB\s0 by
231
default. Provide a positive integer, preferably larger than the default.
232
.Ip "\fB\-enable_peer_stats\fR" 4
233
Activates the collection of Rx statistics and allocates memory for their
234
storage. For each connection with a specific \s-1UDP\s0 port on another machine,
235
a separate record is kept for each type of \s-1RPC\s0 (FetchFile, GetStatus, and
236
so on) sent or received. To display or otherwise access the records, use
237
the Rx Monitoring \s-1API\s0.
238
.Ip "\fB\-enable_process_stats\fR" 4
239
Activates the collection of Rx statistics and allocates memory for their
240
storage. A separate record is kept for each type of \s-1RPC\s0 (FetchFile,
241
GetStatus, and so on) sent or received, aggregated over all connections to
242
other machines. To display or otherwise access the records, use the Rx
243
Monitoring \s-1API\s0.
245
Prints the online help for this command. All other valid options are
248
The following \fBbos create\fR command creates a \f(CWvolserver\fR process on the
249
machine \f(CWfs2.abc.com\fR:
252
\& % bos create -server fs2.abc.com -instance volserver -type simple \e
253
\& -cmd /usr/afs/bin/volserver
255
.SH "PRIVILEGE REQUIRED"
256
The issuer must be logged in as the superuser \f(CWroot\fR on a file server
257
machine to issue the command at a command shell prompt. It is conventional
258
instead to create and start the process by issuing the \fBbos create\fR
261
the \fIBosConfig(5)\fR manpage,
262
the \fIVolserLog(5)\fR manpage,
263
the \fIbos_create(8)\fR manpage,
264
the \fIbos_getlog(8)\fR manpage,
265
the \fIvos(1)\fR manpage
267
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
269
This documentation is covered by the IBM Public License Version 1.0. It was
270
converted from HTML to POD by software written by Chas Williams and Russ
271
Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.
274
.IX Title "volserver 8"
275
.IX Name "volserver - Initializes the Volume Server component of the fs process"
279
.IX Header "SYNOPSIS"
281
.IX Header "DESCRIPTION"
285
.IX Item "\fB\-log\fR"
287
.IX Item "\fB\-p\fR <\fInumber of processes\fR>"
289
.IX Item "\fB\-udpsize\fR <\fIsize of socket buffer\fR>"
291
.IX Item "\fB\-enable_peer_stats\fR"
293
.IX Item "\fB\-enable_process_stats\fR"
295
.IX Item "\fB\-help\fR"
297
.IX Header "EXAMPLES"
299
.IX Header "PRIVILEGE REQUIRED"
301
.IX Header "SEE ALSO"
303
.IX Header "COPYRIGHT"