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.

Difference between revisions of "Simul Parallel File System Test Tool"

From Obsolete Lustre Wiki
Jump to navigationJump to search
 
Line 20: Line 20:
 
The ''simul'' test parameters are:
 
The ''simul'' test parameters are:
  
''-d'' : (required) The directory in which the tests will run.
+
'''''-d''''' : (required) The directory in which the tests will run.
  
''-h'' : Prints a help message
+
'''''-h''''' : Prints a help message
  
''-f'' : The number of the first test to run (default: 0).
+
'''''-f''''' : The number of the first test to run (default: 0).
  
 
:Example:
 
:Example:
Line 31: Line 31:
 
:The test run will start with test number 13 and run all of the tests numbered greater than 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).
+
'''''-l''''' : The number of the last test to run (default: 39).
  
 
:Example:
 
:Example:
Line 43: Line 43:
 
:Tests 5, 6, and 7 will be run.
 
:Tests 5, 6, and 7 will be run.
  
''-i'' : A comma-separated list of tests to include.
+
'''''-i''''' : A comma-separated list of tests to include.
  
 
:Example:
 
:Example:
Line 55: Line 55:
 
:Tests 2, 4, 7, and 38 will be run.
 
:Tests 2, 4, 7, and 38 will be run.
  
''-e'' : A comma-separated list of tests to exclude.
+
'''''-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.
+
'''''-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 each test # times.
  
''-N'' # : Repeat the entire set of tests # times.
+
'''''-N''''' # : Repeat the entire set of tests # times.

Latest revision as of 10:30, 20 January 2011

(Updated: Dec 2009)

The simul test from LLNL consists of an MPI-coordinated set of parallel file system system calls and library functions that are 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. 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

-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.