NAME¶

ethcabletest

Initiates or stops Cable Bit Error Rate stress tests for Network Interface Card to switch (NIC-SW) links.

Syntax¶

ethcabletest [-p plane] [-f hostfile] [-h 'hosts'] [-n numprocs] [start|stop] ...

Options¶

--help

Produces full help text.

-p plane

Specifies the fabric plane the test will run on. The specified plane needs to be defined and enabled in the Mgt config file. Default is the first enabled plane.

-f hostfile

Specifies the file with hosts to include in NIC-SW test. It overrides the HostsFiles defined in Mgt config file for the corresponding plane.

-h hosts

Specifies the list of hosts to include in NIC-SW test.

-n numprocs

Number of processes per host for NIC-SW test. Default is 3.

start

Starts the NIC-SW tests.

stop

Stops the NIC-SW tests.

The NIC-SW cable test requires that the FF_MPI_APPS_DIR is set, and it contains a pre-built copy of the Intel(R) mpi_apps for an appropriate message passing interface (MPI).

Examples¶

ethcabletest -p plane1 start

ethcabletest -f good stop

ethcabletest -h 'arwen elrond' start

HOSTS='arwen elrond' ethcabletest stop

Environment Variables¶

The following environment variables are also used by this command:

HOSTS

List of hosts, used if -h option not supplied.

HOSTS_FILE

File containing list of hosts, used in absence of -f and -h.

FABRIC_PLANE

Name of fabric plane used in absence of -p, -f, and -h.

FF_MAX_PARALLEL

Maximum concurrent operations.