MMTests is a configurable test suite that runs a number of common workloads of interest to MM developers. Ideally this would have been to integrated with LTP, xfstests or Phoronix Test or implemented with autotest. Unfortunately, large portions of these tests are cobbled together over a number of years with varying degrees of quality before decent test frameworks were common. The refactoring effort to integrate with another framework is significant.
The top-level directory has a single driver script called run-mmtests.sh which reads a config file that describes how the benchmarks should be run, configures the system and runs the requested tests. config also has some per-test configuration items that can be set depending on the test. The driver script takes the name of the test as a parameter. Generally, this would be a symbolic name naming the kernel being tested.
Each test is driven by a run-single-test.sh script which reads the relevant driver-TESTNAME.sh script. High level items such as profiling are configured from the top-level script while the driver scripts typically convert the config parameters into switches for a "shellpack". A shellpack is a pair of benchmark and install scripts that are all stored in shellpacks/ .
Monitors can be optionally configured. A full list is in monitors/ . Care should be taken with monitors as there is a possibility that they introduce overhead of their own. Hence, for some performance sensitive tests it is preferable to have no monitoring.
Many of the tests download external benchmarks. An attempt will be made to download from a mirror . To get an idea where the mirror should be located, grep for MIRROR_LOCATION= in shellpacks/.
A basic invocation would be
$ cp config-global-dhp__pagealloc-performance config $ ./run-mmtests.sh --no-monitor 3.0-nomonitor $ ./run-mmtests.sh --run-monitor 3.0-runmonitorMore information is included in the README.
Download links are below. The naming convention is in two parts. The first mmtests-VERSION refers to the version of mmtests itself. Typically for a given series mmtests is forked where the second part comes into play. To a tarball that is a fork for reclaim related tests might be called mmtests-0.02-reclaim-0.01.tar.gz . Forks will never be linked here but it is handy to keep the naming convention when or if forks are referred to on a mailing list.
A git tree is available at https://github.com/gormanm/mmtests
v0.10 o Adjust stap to kernel 3.9 o Do not log usemem output as it can block on IO for anon tests o Collapse some of the micro tests o Rework reaim benchmark o Remove signal_test from reaim configs as it's stupid o Add ability to hog memory which simplifies some NUMA tests o Adjust watch-dstate.pl to handle removal of get_request_wait o Fix top monitor to avoid duplicate output o Remove ft from nas tests memory requirements are excessive o Improve reporting script for highalloc tests o Fix missing dependencies for dbench and memcachetest v0.09 o Many small improvements to reporting, more graphs etc. o Increase duration of dbench benchmarks to cope better with noise o Add generic graph-mmtests.sh script for comparing test runs o Improve monitoring of processes stuck in dstate o Do not record top-related informtion for hackbench, too much IO, unhelpful o Add more configurations related to read IO starvation monitoring v0.08 o Preliminary support for rendering HTML reports o specjbb configs for single JVMs o specjbb extraction script changes for single JVMs o nas reporting scripts v0.07 o Add benchmark for specjbb o Run multiple instances of tiobench and report variances o Basic NUMA monitoring scripts o Describe the components of autonumbench and add a configuration file v0.06 o Automatically install packages (need name mappings for other distros) o Add benchmark for autonumabench o Add support for benchmarking NAS with MPI o Add pgbench for autonumabench (may need a bit more work) o Upgrade postgres version to 9.2.1 o Upgrade kernel verion used for kernbench to 3.0 for newer toolchains o Alter mailserver config to finish in a reasonable time o Add monitor for perf sched o Add moinitor that gathers ftrace information with trace-cmd o Add preliminary monitors for NUMA stats (very basic) o Specify ftrace events to monitor from config file o Remove the bulk of whats left of VMRegress o Convert shellpacks to a template format to auto-generate boilerplate code o Collect lock_stat information if enabled o Run multiple iterations of aim9 o Add basic regression tests for Cross Memory Attach o Copy with preempt being enabled in highalloc stres tests o Have largedd cope with a missing large file to work with o Add a monitor-only mode to just capture logs o Report receive-side throughput in netperf for results v0.05 o Move driver and config scripts into their own directory o Add bin/extract-mmtests.pl and bin/compare-mmtests.pl o Remove references to Irish kernel.org mirror o Small tidy up v0.04 o Add benchmarks for tbench, pipetest, lmbench, starve, memcachedtest o Add basic benchmark to run trinity fuzz testing tool o Add monitor that runs parallel IO in the background. Measures how much IO interferes with a target workload. o Allow limited run of sysbench to save time o Add helpers for running oprofile, taken from libhugetlbfs o Add fsmark configurations suitable for page reclaim and metadata tests o Add a mailserver simulator (needs work, takes too long to run) o Tune page fault test configuration for page allocator comparisons o Allow greater skew when running STREAM on NUMA machines o Add a monitor that roughly measures interactive app startup times o Add a monitor that tracks read() latency (useful for interactivity tests) o Add script for calculating quartiles (incomplete, not tested properly) o Add config examples for measuring interactivity during IO (not validated) o Add background allocator for hugepage allocations (not validated) o Patch SystemTap installation to work with 3.4 and later kernels o Allow use of out-of-box THP configuration v0.03 o Add a page allocator micro-benchmark o Add monitor for tracking processes stuck in D state o Add a page fault micro-benchmark o Add a memory compaction micro-benchmark o Patch a tiobench divide-by-0 error o Adapt systemtap for >= 3.3 kernel o Reporting scripts for kernbench o Reporting scripts for ddresidency Version 0.02 o Added benchmark for running dbench3, dbench4, tiobench o Added benchmark for ffsb that can generate work profiles similar to the ffsb tests used for btrfs o iozone can now run in single mode to allow better specification of what the test should do o Corrected name of fraganalysis script in makefile o Polished reporting a little, added some support for comparing iostat reports Version 0.01 o Initial public release