Test Descriptions

The acceptance-small.sh script is a wrapper around auster that runs the test group 'regression' unless a test is specified.

Lustre Regression and Feature Tests

Test Name	Test Status	Test Description
conf-sanity		A set of unit tests that verify the configuration tools, and runs Lustre with multiple different setups to ensure correct operation in unusual system configurations.
dne_sanity		Run sanity parallel on different directories at the same time.
insanity		A set of tests that verify the multiple concurrent failure conditions.
large-scale		Large-scale tests that verify version-based recovery features.
lfsck	deprecated	Tests e2fsck and lfsck to detect and fix filesystem corruption. Use sanity-lfsck instead.
lnet-selftest		Runs LNET self test on hosts defined in test configuration.
lustre-rsync-test		Verifies the lustre_rsync (replication) feature.
metadata-updates		Tests that metadata updates are properly completed when multiple clients create/delete files and modify the attributes of files.
mmp		Tests for multiple mount protection (MMP) feature.
performance-sanity		Performance mdsrate tests (small file create/open/delete, large file create/open/delete, lookup rate 10M file dir, lookup rate 10M file 10 dir, getattr small file, and getattr large files).
ost-pools		A tests that exercises the OST pools feature.
parallel-scale		Runs functional tests (connectathon, cascading_rw, write_disjoint, write_append_truncate, parallel_grouplock, statahead), performance tests (IOR, compilebench and metabench), and a stress test (simul).
racer		Tests for filesystem race conditions by concurrently creating, moving, deleting, etc. a set of files.
recovery-double-scale		Failover test for all pair-wise combinations of node failures.
recovery-mds-scale		The server failover test: for a duration of 24 hours, repeatedly fail over a random facet (MDS or OST) at 10 minute intervals and verify that no application errors occur.
recovery-random-scale		Verifies client failure not affecting other clients.
recovery-small		A set of unit tests that verify RPC replay after communications failure.
replay-dual		A set of unit tests that verify the recovery from two clients after server failure.
replay-ost-single		A set of unit tests that verify recovery after OST failure.
replay-single		A set of unit tests that verify recovery after MDS failure.
replay-vbr		Verifies version-based recovery feature.
runtests		Simple basic regression test that verifies data persistence across write, unmount, and remount. This is one of the few tests that verifies data integrity across a full filesystem shutdown and remount, unlike many tests which at most only verify the existence/size of files.
sanity		A set of regression tests that verify operation under normal operating conditions. This tests a large number of unusual operations that have previously caused functional or data correctness issues with Lustre. Some of the tests are Lustre specific, and hook into the Lustre fault injection framework using the "lctl set_param fail_loc=X" command to activate triggers in the code to simulate unusual operating conditions that would otherwise be difficult or impossible to simulate.
sanityn		Tests that verify operations from two clients under normal operating conditions. This is done by mounting the same filesystem twice on a single client, in order to allow a single script/program to execute and verify filesystem operations on multiple "clients" without having to be a distributed program itself.
sanity-gss		Verifies GSSAPI features.
sanity-hsm		Sanity test for HSM feature.
sanity-krb5		Verifies Kerberos features.
sanity-lfsck		Sanity test for lfsck
sanity-quota		A set of tests that verify filesystem quotas.
sanity-scrub
sanity-sec		Verifies Lustre identity features. , including UID/GID mapping

Benchmark Scripts

Script Name	Script Description
bonnie	Bonnie++ benchmark for creation, reading, and deleting many small files. (Source HPDD Wiki Auster)
dbench	Dbench benchmark for simulating N clients to produce the filesystem load. (Source HPDD Wiki Auster)
iozone	Iozone benchmark for generating and measuring a variety of file operations. (Source HPDD Wiki Auster)
obdfilter-survey
sgpdd-survey

Auxiliary Test

Script Name

Script Description

fsx

The file system exerciser was developed outside of Lustre and is intended to stress test unusual IO and file operations. It does buffered and mmap reads and writes with random size and offset, truncate, open, close on a file. It verifies data integrity after each step. A lustre-developed extension allows fsx to run against multiple mountpoints to verify distributed IO operation correctness. (Source HPDD Wiki Auster)