Lustre 1.6 Operations Manual

32.5.12 lst
The lst utility starts LNET self-test.
Synopsis
lst
Description
LNET self-test helps site administrators confirm that Lustre Networking (LNET) has
been correctly installed and configured. The self-test also confirms that LNET, the
network software and the underlying hardware are performing as expected.
Each LNET self-test runs in the context of a session. A node can be associated with
only one session at a time, to ensure that the session has exclusive use of the nodes
on which it is running. A single node creates, controls and monitors a single session.
This node is referred to as the self-test console.
Any node may act as the self-test console. Nodes are named and allocated to a selftest
session in groups. This allows all nodes in a group to be referenced by a single
name.
Test configurations are built by describing and running test batches. A test batch is a
named collection of tests, with each test composed of a number of individual pointto-point
tests running in parallel. These individual point-to-point tests are
instantiated according to the test type, source group, target group and distribution
specified when the test is added to the test batch.
Modules
To run LNET self-test, load following modules: libcfs, lnet, lnet_selftest and any one
of the klnds (ksocklnd, ko2iblnd...). To load all necessary modules, run modprobe
lnet_selftest, which recursively loads the modules on which lnet_selftest depends.
There are two types of nodes for LNET self-test: console and test. Both node types
require all previously-specified modules to be loaded. (The userspace test node does
not require these modules).
Test nodes can either be in kernel or in userspace. A console user can invite a kernel
test node to join the test session by running lst add_group NID, but the user cannot
actively add a userspace test node to the test-session. However, the console user can
passively accept a test node to the test session while the test node runs lst client to
connect to the console.
Utilities
Chapter 32 System Configuration Utilities (man8) 32-27