File: README

package info (click to toggle)
nfsometer 1.9-3.1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 836 kB
  • sloc: python: 4,928; sh: 156; javascript: 32; makefile: 5
file content (80 lines) | stat: -rw-r--r-- 1,815 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
nfsometer -

  A framework for the running and reporting of performance characteristics of 
  workloads across NFS protocol versions, options and Linux kernels.


About
==================

  author:  Weston Andros Adamson <dros@monkey.org>
  website: http://wiki.linux-nfs.org/wiki/index.php/NFSometer


Dependencies
==================

  nfsometer depends on several third-party packages and will not run without
  them installed.

   - matplotlib - used for graph plotting
   - numpy      - used by matplotlib, stats functions
   - mako       - used for html templating of reports
   - nfs-utils  - mount.nfs, mountstats, etc
   - time       - /bin/time

  On a fedora system the following command will install these packages:

  # sudo yum install python-matplotlib numpy python-mako nfs-utils time

  Other distros will have a similar command.


Installation
================

  nfsometer is designed to be able to run without installation, ie:

  # ./nfsometer.py --help

  nfsometer can also be installed to standard python site-packages and
  executable directories (must be run as root):

  # python setup.py install
  # nfsometer --help


Using nfsometer
=================

 See the nfsometer manpage:

  man nfsometer

 Or use the help:

  ./nfsometer.py --help

 And see examples (the same as in the manpage):

  ./nfsometer.py examples


Adding a workload
======================

  Adding a workload is designed to be very simple.

  Copy the 'nfsometer-workload-template' file to a file in the workloads
  directory that ends with ".nfsometer", edit this file following the
  instructions contained within.

  Most of the time it's probably easier to just use a custom workload -
  see the manpage for more info on the custom workload.


Contributing back
==================

See howto-contribute.txt