NFSometer

From Linux NFS

Revision as of 21:45, 22 February 2013

NFSometer is a performance measurement framework for running workloads and reporting results across NFS protocol versions, NFS options and Linux NFS client implementations.

The NFSometer project was started at NetApp as a way to automate performance testing of the Linux NFS client. Since then it has grown to include many other features, notably the generation of reports. It is our hope that by releasing this project under the GPLv2 license, the Linux NFS community will benefit from a better understanding of NFS performance characteristics and contribute improvements to NFSometer.

NFSometer is not designed to replace existing filesystem benchmarks. Instead, it is designed to automate the running of existing filesystem benchmarks, gather NFS specific statistics and generate reports that make benchmark output more understandable.

Goals:

• Automate the time consuming process of running a variety of workloads looking for performance regressions between kernel versions, NFS protocol versions and NFS options.

• Generate reports that allows the user to understand the performance characteristics of workloads and easily compare performance characteristics of different configurations.

• Provide a simple way to define workloads. This allows users to evaluate NFS deployment scenarios with workloads representative of their unique needs.

News

• Fri Feb 22, 2013: NFSometer v1.4 released! This version has a redesign of reports, many bugfixes and several new features.

• Fri Dec 7, 2012: NFSometer v1.3 released! This version includes some major cleanup and bugfixes.

• Fri Nov 30, 2012: NFSometer v1.2 released! This version includes, new options (notably -o replaces -m), basic loadgen functionality, probe mountopts and detect tags, replace poorly supported admin-script and client-script functionality with tags (-t option), bugfixes, etc

• Thu Jun 21, 2012: NetApp is pleased to announce the GPLv2 release of NFSometer!

Download

The current release of nfsometer is version 1.4:

nfsometer-1.4.tar.gz (md5sum: ef6e3031b2c39c7eb439dd35197e6b76)

Old releases:

• nfsometer-1.3.tar.gz (md5sum: f6ee81e838753fe1d07e49fff653f5cf)
• nfsometer-1.2.tar.gz (md5sum: 86ca117b3265ce40408b2015e96482b5)
• nfsometer-1.1.tar.gz (md5sum: efbca65ec863b63cb852baac5ff409cf)
• nfsometer-1.0.tgz (md5sum: 9d8873517c0365dc04d28b585e0ba31b)

Main git repository:

'master' branch is current release, 'testing' branch is where all new development is happening.

• git clone git://git.linux-nfs.org/projects/dros/nfsometer.git
• NFSometer gitweb

Example

The following command will run the Connectathon test suite once for each NFS protocol version (v3, v4.0, v4.1) and generate a report:

$ ./nfsometer.py zero:/export cthon

Requested: 1 workloads X 3 nfsopts X 1 runs = 3 test runs
Need to run 3 of 3 requested test runs
 cthon - needs 1 runs of vers=3 
 cthon - needs 1 runs of vers=4 
 cthon - needs 1 runs of vers=4,minorversion=1 

Trace 1/3: 1/1 with workload: cthon, nfsopts: vers=3
< SETUP >
Mounting: zero:/export...
remove run directory: /mnt/nfsometer_runroot/cthon
Unmounting: zero:/export...
< RUN >
Mounting: zero:/export...
Running command: cd /home/dros/nfsometer/tests/cthon/cthon && NFSTESTDIR="/mnt/nfsometer_runroot/cthon" ./runtests -a
Unmounting: zero:/export...
Results copied to: nfsometer_trace-cthon-vers=3-0

Trace 2/3: 1/1 with workload: cthon, nfsopts: vers=4
< SETUP >
Mounting: zero:/export...
remove run directory: /mnt/nfsometer_runroot/cthon
Unmounting: zero:/export...
< RUN >
Mounting: zero:/export...
Running command: cd /home/dros/nfsometer/tests/cthon/cthon && NFSTESTDIR="/mnt/nfsometer_runroot/cthon" ./runtests -a
Unmounting: zero:/export...
Results copied to: nfsometer_trace-cthon-vers=4-0

Trace 3/3: 1/1 with workload: cthon, nfsopts: vers=4,minorversion=1
< SETUP >
Mounting: zero:/export...
remove run directory: /mnt/nfsometer_runroot/cthon
Unmounting: zero:/export...
< RUN >
Mounting: zero:/export...
Running command: cd /home/dros/nfsometer/tests/cthon/cthon && NFSTESTDIR="/mnt/nfsometer_runroot/cthon" ./runtests -a
Unmounting: zero:/export...
Results copied to: nfsometer_trace-cthon-vers=4,minorversion=1-0

Successfully ran 3 traces!

Generating reports:

Saved: index.html
Saved: Report_Averages.html


graph summary: 47 generated, 0 cached, 0 mismatch, 0 pruned,
    0 hash files and 0 other files deleted

Report index: /home/dros/nfsometer/results/index.html

Here is a screenshot of part of the generated report:

Feedback

Please send any bug reports, questions or comments to dros@netapp.com

For contributions, see howto-contribute.txt.