opacabletest(8)

💖 NAME 💖

okay so bestie, opacabletest(8) is here from the IFSFFCLIRG (Man Page) era, and it's giving (Switch) energy ✨. This tool initiates or stops Cable Bit Error Rate stress tests for Intel(R) Omni-Path Host Fabric Interface (HFI)-to-switch links and/or ISLs. No cap, it's literally the stress-test queen for your fabric links 💅.

✨ Syntax ✨

opacabletest [-C|-A] [-c  file] [-f  hostfile] [-h  'hosts'] [-n
numprocs]

[-t portsfile] [-p  ports] [start|start_fi|start_isl|stop|stop_fi|
stop_isl] ...

🎀 Options 🎀

• --help — Produces full help text. Ask and you shall receive, bestie.
• -C — Clears error counters. Fresh start energy.
• -A — Forces the system to clear hardware error counters. Implies -C. Like, it's the aggressive version of -C.
• -c file — Specifies the error thresholds configuration file. Default is /etc/opa/opamon.si.conf file. Only used if -C or -A specified. Only relevant when you're clearing counters.
• -f hostfile — Specifies the file with hosts to include in HFI -to-SW test. Default is /etc/opa/hosts file. Your VIP host list.
• -h hosts — Specifies the list of hosts to include in HFI -SW test. Name-drop them directly.
• -n numprocs — Specifies the number of processes per host for HFI -SW test. Parallelism, but make it per-host.
• -t portsfile — Specifies the file with list of local HFI ports used to access fabrics when clearing counters. Default is /etc/opa/ports file. Ports, but from a file.
• -p ports — Specifies the list of local HFI ports used to access fabrics for counter clear.

Default is first active port. The first HFI in the system is 1. The first port on an HFI is 1. Uses the format hfi:port, for example:

• 0:0 — First active port in system.
• 0:y — Port y within system.
• x:0 — First active port on HFI x.
• x:y — HFI x, port y.

iykyk, the hfi:port format is the moment.

• start — Starts the HFI -SW and ISL tests. Go go go!
• start_fi — Starts the HFI -SW test. HFI-SW only, bestie.
• start_isl — Starts the ISL test. ISL only, no HFI-SW.
• stop — Stops the HFI -SW and ISL tests. Hit the brakes.
• stop_fi — Stops the HFI -SW test. Just the HFI-SW one.
• stop_isl — Stops the ISL test. Just the ISL one.

The HFI -SW cable test requires that the FF_MPI_APPS_DIR is set, and it contains a pre-built copy of the mpi_apps for an appropriate message passing interface (MPI). Don't skip this step, bestie, or the vibe check will fail.

The ISL cable test started by this tool assumes that the master Host Subnet Manager (HSM) is running on this host. If using the Embedded Subnet Manager (ESM), or if a different host is the master HSM, the ISL cable test must be controlled by the switch CLI, or by Intel(R) Omni-Path Fabric Suite FastFabric on the master HSM respectively. Read this twice, fr fr.

🌈 Examples 🌈

opacabletest -A start

opacabletest -f good -A start

opacabletest -h 'arwen elrond' start_fi

HOSTS='arwen elrond' opacabletest stop

opacabletest -A

🦋 Environment Variables 🦋

The following environment variables are also used by this command:

• HOSTS — List of hosts, used if -h option not supplied. Your backup host list.
• HOSTS_FILE — File containing list of hosts, used in absence of -f and -h. File-based host list.
• PORTS — List of ports, used in absence of -t and -p. Ports, but env-var style.
• PORTS_FILE — File containing list of ports, used in absence of -t and -p. Ports, but from a file.
• FF_MAX_PARALLEL — Maximum concurrent operations. How many things can happen at once.

and that's the tea ☕ — this page is Copyright(C) 2015-2019 Intel Corporation, and it's opacabletest(8), periodt 💅✨. Stay fab and stress-test responsibly, bestie 🫶💖.