Manual Pages
Table of Contents
dafs - manages DAFS service
dafs start | stop
dafs setup
dafs attach vinic [ -d physical_device ] [ -l lis_ten_address
] [ -p ]
dafs detach vinic
dafs option vinic [ name [ value ] ]
dafs status [ -a | -C | -M | -n [-s [-r]] [nic] | -s [-r]
[session] ] [-v]
dafs stats start | stop [-a] | list [-z] [-a]
dafs drain
dafs export {options}
dafs access {options}
The dafs command manages the DAFS service on a filer.
Using the dafs command, you may start or stop the DAFS
service, attach and detach VI NIC interfaces to the DAFS
service, view the status of the DAFS service, and manage
DAFS NIC options. DAFS exported volumes may also be managed,
see na_dafs_export(1) and na_dafs_access(1)
Initial setup of the DAFS service can be performed using
the dafs setup subcommand.
The dafs command is available only if your filer has the
dafs license.
- start
- Starts the DAFS service if it is not already
running. Using this option also attaches the
DAFS service to any VI NICs which are configured
for DAFS usage.
- stop
- Stops the DAFS service if it is running. Any
DAFS sessions on DAFS attached NICs are first
stopped.
- setup
- Performs initial setup of the DAFS service.
Once initial system setup (see na_setup(1))
has completed, and configured VI NICs, then
this option may be used to configure the DAFS
service.
attach vinic [-d physical_device ] [-l listen_address]
[-p]
Attaches the DAFS service to the VI NIC named
vinic.
vinic is the logical name of the VI NIC.
- -d
- physical_device specifies the physical
device name. If this option is not present,
the physical device name is assumed to be the
same as the logical device name vinic.
- -l listen_address specifies the VI net address
-
and discriminator that the DAFS server will
use to listen for requests. The net address
may be specified as a symbolic hostname or in
the form of an IP dotted quad. The discriminator
is separated from the net address by a
single `:' and may be in the form of a 4 byte
string or 32 bit integer. If this option is
not present, for a local interface the net
address of vinic and the default discriminator
DAFS are used.
- -p indicates that the vinic should be attached
-
as a partner interface. This delays attaching
vinic until CFO takeover. If a listen address
is not specified, the net address of vinic and
the failover descriminator pDAF are used.
Note that attaching a device only needs to be
done once. The DAFS service remembers which
NIC(s) it is attached to, and will automatically
attach itself to the same set of NICs on
the next reboot or dafs start command.
An attached NIC may be inactive. This typically
applies to CFO partner devices which are
attached but remain inactive until CFO
takeover occurs. Use the dafs status -n command
to view the state of each NIC known to
the DAFS service.
The physical name of the VI NIC depends upon
the specific hardware installed in your filer,
an example might be vf5.
detach vinic
Detaches the DAFS service from the VI NIC
vinic.
drain
Allows currently executing DAFS requests to
complete before returning. Note that this command
does not prevent new requests starting,
it guarantees that any earlier started
requests have completed.
- stats
- start | stop [-a] | list [-a] [-z]
Gathers statistics on DAFS server operations.
Statistics gathering starts when the
stats start command is issued. Statistics
gathering stops when the stats stop command is
issued. When gathering stops, statistics summary
information is displayed of operations
during the interval. The list operation may
be used between start and stop to display
intermediate results. If the -z (zero) argument
is used, then counters are zeroed after
display, and subsequent list or stop
operations will display counts since the last
zero; otherwise values since the last start
are displayed. Only non-zero statistics
information is displayed by default. If the
-a (all) option is used, then all information,
even operations with a zero count are displayed.
The following statistics are gathered
for each operation:
- Count
- The number of the operation that took
place during the measurement interval.
- Percent
- The percent of the total operations
that a particular operation occurred
during the measurement interval.
- Ops/Sec
- The average number of times per second
that the operation took place during
the measurement interval.
- Msec/Op
- The average wall-clock time each operation
took to execute from dispatch in
the filer until sending the result of
the operation back to the DAFS client,
measured in milliseconds per operation.
It does not include time before
dispatching the operation, for example
network time from client; nor time
after completion of the operation, for
example network time sending the
result back to the client. Note that
wall-clock time is different than CPU
time; some operations may take longer
to complete than others, for example
due to associated disk operations.
- status
- [ -a | -C | -M | -n [-s [-r]] [nic] | -s [-r]
[session] ] [-v]
Displays the status of the DAFS service, NIC and/or sessions.
By default a compact output format is used. The -v
argument allows a greater level of detail to be displayed.
If the -n (NIC) argument is given, then the status of
each NIC known to DAFS are listed. If -n <nic> is specified,
then only that NIC are listed.
If the -s (session) argument is given, then the status of
sessions are listed. If just -s is used, then all sessions
are listed. If -s <session> is used, then only the
status of <session> is listed. If -s is used in conjection
with -n <nic>, then all sessions for <nic> are listed.
The -r (requests) argument may be used with the -s argument
to request that the status of DAFS requests underway
for a session be listed.
The -C (channels) argument prints information about the
channels.
The -M (memory) argument prints information about the memory
utilized by the dafs server.
If the -v (verbose) argument is given additional status
information is listed, as selected by the -s, -r and/or -n
argument.
If the -a (all) argument is specified, then all status
information is listed.
option <vinic> [<name> [ <value> ]]
Manage option values for a specific DAFS VINIC. (Note
that global DAFS server options are set using the options
command, see na_options(1). )
If no <name> is given, then all values for <vinic> are
listed.
If a single <name> is given, then the current value for
<name> is listed for <vinic>.
If both <name> and <value> are given, then the DAFS configuration
is updated for the name to the new value.
If both <name> and <value> are given and <value> is set to
the empty string,"", then the value is deleted.
The option command is intended for use by Network Appliance
CS and performance tuning engineering and should be
used with care. Per-NIC options typically require the
filer to be restarted to take effect.
The following <name> options may be specified with dafs
option :
checksums.enable
Enable use of DAFS-level checksums for DAFS
requests and responses for the specified NIC.
num_requestd
Set the default number of DAFS request-processing
servers to start for the specified VI NIC.
devicename
Set the physical device name of the specified
VI NIC if it is different than the NIC name.
listen_address
Set the VI listen address and VI discriminator
of the specified VI NIC. See the
dafs attach -l description for the format of
the listen address.
During giveback, the dafs server will attempt to gracefully
disconnect sessions to the partner image. This is
accomplished by rejecting new requests and allowing existing
requests to drain before disconnecting the session.
Once giveback is complete, the dafs server will detach the
network interfaces marked as partner interfaces.
Setup DAFS service: dafs setup
Show the status of the DAFS server, including NICs:
dafs status -n
Show the status of all DAFS sessions:
dafs status -s
Show the status of DAFS sessions and their requests for
just NIC vf7:
dafs status -nsr vf7
Show all status information:
dafs status -a
Gather DAFS statistics for a period, then display them:
dafs stats start
dafs stats stop
might produce:
DAFS Statistics, gathered for 24 seconds, ops 80722
Operation Count Percent Ops/sec Msec/Op
--------- ----- ------- ------- -------
Client Connect 4 0 0 0
Client Authenticate 4 0 0 0
Server Authenticate 4 0 0 0
Write Inline 80710 26 79 39
Gather DAFS statistics over a period, displaying and zeroing
intermediate results:
dafs stats start
dafs stats list -z
dafs stats list -z
dafs stats stop
Attach VI NICs to the DAFS server. For the purpose of
these examples, assume a VI NIC vf5 with net address
192.168.1.25. The following local interface attach commands
are equivalent:
dafs attach vf5
dafs attach vf5 -d vf5
dafs attach vf5 -d vf5 -l :DAFS
dafs attach vf5 -d vf5 -l 192.168.1.25:DAFS
Attach partner VI NICs to the DAFS server. For the purpose
of these examples, assume a VI NIC vf5 with net address
192.168.1.25. The following partner interface attach commands
are equivalent:
dafs attach p_vf5 -d vf5 -p
dafs attach p_vf5 -d vf5 -l :pDAF -p
dafs attach p_vf5 -d vf5 -l 192.168.1.25:pDAF -p
The current DAFS specification is subject to change, thus
interoperability is not guaranteed in this release.
na_dafs(8), na_dafs_export(1), na_dafs_access(1),
na_setup(1)
Table of Contents