5 – Detailed Descriptions of Command LineTools
Advanced Initialization and Verification - ibtest
Ibtest provides detailed logging of its results. During each run the following
files are produced:
The -c option will remove all of the above.
Results from ibtest are grouped into Test Suites, Test Cases and Test Items.
A given run of ibtest represents a single Test Suite. Within a Test Suite multiple
Test Cases will occur, typically one Test Case per host, chassis or switch being
operated on. Some of the more complex operations (such as ipoibping) may
have multiple Test Items per Test Case. Each such item represents a major step
in the overall Test Case.
Each ibtest run appends to test.res and test.log and creates temporary
files in test_tmp$PID in the current directory. Test.res will provide an overall
summary of tests performed and their results. The same information will also
be displayed while ibtest is executing. Test.log will contain detailed
information about what was performed. This will include the specific commands
executed and the resulting output. The test_tmp directories will contain
temporary files which reflect tests in progress (or killed). The logs for any failures
will be logged in the save_temp directory with a directory per failed test case.
If the same test case fails more than once, save_temp will retain the information
from the first failure and subsequent runs of ibtest will only append to
test.log. It is recommended to review failures and use the -c option to remove
old logs before subsequent runs of ibtest.
ibtest implicitly performs its operations in parallel. However, as for the other
tools, FF_MAX_PARALLEL can be exported to change the degree of parallelism.
Twenty (20) parallel operations is the default.
Environment Variables
The following environment variables are also used by this command:
HOSTS, HOSTS_FILE: see discussion on selection of hosts above
CHASSIS, CHASSIS_FILE: see discussion on selection of chassis above
IBNODES, IBNODES_FILE: see discussion on selection of switches above
FF_IPOIB_SUFFIX: suffix to append to hostname to create IPoIB hostname.
Used in absence of -i
FF_MAX_PARALLEL: maximum number of parallel operations to perform at
once.
FF_USERNAME: user name to login to hosts as, default is root
5-62
test.res: appended with summary results of run
test.log: appended with detailed results of run
save_tmp/: contains a directory per failed test with detailed logs
test_tmp*/: intermediate result files while test is running
Q
D000006-000 Rev A
Need help?
Do you have a question about the Fast Fabric and is the answer not in the manual?