WARNING: This is the _old_ Lustre wiki, and it is in the process of being retired. The information found here is all likely to be out of date. Please search the new wiki for more up to date information.

Simul Parallel File System Test Tool: Difference between revisions

From Obsolete Lustre Wiki
Jump to navigationJump to search
No edit summary
Line 1: Line 1:
''Simul'' is a benchmark stress test that simulates a number of clients making system calls to the Lustre file system simultaneously. Syscalls may be made from one or more threads on one or more nodes.  
The ''simul'' test consists of an MPI-coordinated set of parallel file system system calls and library functions.  It was designed to perform file system operations
simultaneously from many nodes and processes to test the correctness
and coherence of parallel file systems.


Operations include open, close, file stat, lseek, read, write, chdir, dir stat, readdir, mkdir, rmdir, unlink, rename, creat, truncate, symlink, readlink, and link. [[Is this list correct?]]
Many of the test processes require a setup and/or cleanup phase, e.g. the test
of the ''open()'' system call requires that a file first be created.  In
such cases, ''simul'' takes pains to make the setup and cleanup for each
test as low-impact as possible.  Normally the setup and cleanup phases
are sequential, so setup/cleanup is performed one process at a
time, or a single process performs setup and cleanup for a set of processes.


[[Should anything else be added to the description of simul?]]
All of the tests that ''simul'' performs are numbered. **and simul's tests
can be retrieved by giving simul the -h option.** '''[[OK to change text between **s to this?]]''' A list of the tests can be displayed by using ''simul'' with the ''-h'' option.


''Simul'' can be downloaded from ... [[where to you get simul?]]
The only required parameter when running ''simul'' is the "-d" option,
which is used to tell ''simul'' the target directory in which all of the
tests should be performed.


To build ''simul'', ... [[How do you do this?]]
=== Simul Parameters ===
The ''simul'' test parameters are:


''Simul'' is run with either ''pdsh'' or ''prun''. To run ''simul'' with ''pdsh'', enter:
''-d'' : (required) The directory in which the tests will run.


pdsh -E -w <node list> [-n tasks-per-node] /path/simul -d /mnt/lustre/path/ 
''-h'' : Prints a help message [[including a list of tests performed by simul]]'''. [[OK to add red text?]]'''


To run ''simul'' with ''prun'', enter:   
''-f'' : The number of the first test to run (default: 0).
[[What command should be used here?]]
 
:Example:
:<pre>simul -d /test/directory -f 13
</pre>
:The test run will start with test number 13 and run all of the tests numbered greater than 13.
 
''-l'' : The number of the last test to run (default: 39).
 
:Example:
:<pre>simul -d /test/directory -l 16
</pre>
:The test run will start with test number 0, and run all of the tests up to, and including, test 16.
 
:Example:
:<pre>simul -d /test/directory -f 5 -l 7
</pre>
:Tests 5, 6, and 7 will be run.
 
''-i'' : A comma-separated list of tests to include.
 
:Example:
:<pre>simul -d /test/directory -i 12
</pre>
:Test number 12 will be run.
 
:Example:
:<pre>simul -d /test/directory -i 2,4,7,38
</pre>
:Tests 2, 4, 7, and 38 will be run.
 
''-e'' : A comma-separated list of tests to exclude.
 
''-s'' : Run in "single-step" mode. ''simul'' will prompt the user to hit a key to continue to the next test.
 
''-n'' # : Repeat each test # times.
 
''-N'' # : Repeat the entire set of tests # times.

Revision as of 16:34, 13 November 2009

The simul test consists of an MPI-coordinated set of parallel file system system calls and library functions. It was designed to perform file system operations simultaneously from many nodes and processes to test the correctness and coherence of parallel file systems.

Many of the test processes require a setup and/or cleanup phase, e.g. the test of the open() system call requires that a file first be created. In such cases, simul takes pains to make the setup and cleanup for each test as low-impact as possible. Normally the setup and cleanup phases are sequential, so setup/cleanup is performed one process at a time, or a single process performs setup and cleanup for a set of processes.

All of the tests that simul performs are numbered. **and simul's tests can be retrieved by giving simul the -h option.** OK to change text between **s to this? A list of the tests can be displayed by using simul with the -h option.

The only required parameter when running simul is the "-d" option, which is used to tell simul the target directory in which all of the tests should be performed.

Simul Parameters

The simul test parameters are:

-d : (required) The directory in which the tests will run.

-h : Prints a help message including a list of tests performed by simul. OK to add red text?

-f : The number of the first test to run (default: 0).

Example:
simul -d /test/directory -f 13
The test run will start with test number 13 and run all of the tests numbered greater than 13.

-l : The number of the last test to run (default: 39).

Example:
simul -d /test/directory -l 16
The test run will start with test number 0, and run all of the tests up to, and including, test 16.
Example:
simul -d /test/directory -f 5 -l 7
Tests 5, 6, and 7 will be run.

-i : A comma-separated list of tests to include.

Example:
simul -d /test/directory -i 12
Test number 12 will be run.
Example:
simul -d /test/directory -i 2,4,7,38
Tests 2, 4, 7, and 38 will be run.

-e : A comma-separated list of tests to exclude.

-s : Run in "single-step" mode. simul will prompt the user to hit a key to continue to the next test.

-n # : Repeat each test # times.

-N # : Repeat the entire set of tests # times.

Retrieved from "http://wiki.old.lustre.org/index.php?title=Simul_Parallel_File_System_Test_Tool&oldid=8349"