SPOTDELAY.CIFS.CLIENT(1)SPOTDELAY.CIFS.CLIENT(1)NAMEspotdelay.cifs.client - A Perl script utility that reads through an
CIFS Client output file, checking for delays and therefore bottlenecks
in its running.
SYNOPSISspotdelay.cifs.client [-h] [-NNNN] <cifsclient log file>
DESCRIPTION
This tool is part of the CIFS WTEC Support Tools suite.
spotdelay.cifs.client is a Perl script that runs through the user pro‐
vided CIFS Client debug file looking at the time stamps for each nfs
line in the trace. It will issue a warning when the following condi‐
tion holds:
Delays occur greater than a specified time between sequential
lines in the trace.
The script was designed to be short, but still readable, with the aim
that it will be easy to cut&paste onto a customer's system. Be‐
cause of this, it takes only two command line arguments. (See Options
below)
You will have to examine the lines that spotdelay.cifs.client warns
about to see if there are actual bottlenecks, and what nfs request/re‐
ply pairs are involved.
LIMITATIONSspotdelay.cifs.client will get confused by traces that run over mid‐
night, since it assumes that the time shown is from the beginning of
the day.
spotdelay.cifs.client may also misreport delays near the end of trun‐
cated trace files.
OPTIONS-h Print a summary of command line options.
-NNNNN Sets the maximum time (in milliseconds)between paired nfs com‐
mand and response lines above which spotdelay.cifs.client will
issue a warning. For example to see if there are any lines with
1 second or more between them, set this to 1000.
OUTPUT
It indicates the NFS command/response pairs that took longer than -NNNN
milliseconds to complete. The output is of the form:
NFS Command [XXXXXXXX] took YYYYY ms to return
Armed with this information, you can vi the log file itself to deter‐
mine WHAT nfs command this was, and the events surrounding the event.
Dependenciesspotdelay.cifs.client requires that the debug file input was captured
with the nfsTrace log level uncommented in the /etc/opt/cifsclient/cif‐
sclient.cfg file.
This script was developed and tested under perl(1) version 5.005_02
built for PA-RISC1.1 . While it may run under previous versions it is
recommended that you install 5.005_02 or higher for best results. You
may need to modify the first line to point to whatever location YOUR
environment has perl installed.
SEE ALSOcifs_diag(1). spotdelay.cifs.server(1).
AUTHOR
Don McCall, HP WTEC NOS Support Team, based on concepts developed by
Ian Jespersen, also of the HP WTEC NOS Support Team.
SPOTDELAY.CIFS.CLIENT(1)