Section 8: administration and privileged commands
opaverifyhosts Verifies basic node configuration and performance by running FF_HOSTVERIFY_DIR/hostverify.sh on all specified hosts. NOTE: Prior to using opaverifyhosts, copy the sample file /usr/lib/opa-ff/samples/hostverify.sh to FF_HOSTVERIFY_DIR and edit it to appropriate configuration and performance expectations and select which tests to run by default. On the first run for a given node, use the -c option…
opauploadall (Linux) Copies one or more files from a group of hosts to this system. Since the file name is the same on each host, a separate directory on this system is created for each host and the file is copied to it. This is a convenient way to upload log files or configuration files…
opatop Starts the opatop Text User Interface (TUI) menu to display performance, congestion, and error information about a fabric. Refer to Intel(R) Omni-Path Fabric Suite FastFabric User Guide for additional details. Syntax opatop [-v] [-q] [-h hfi] [-p port] [-i seconds] Options Options –help Produces full help text. -v/–verbose level Verbose output level. Value is…
opaswitchadmin (Switch) Performs a number of multi-step initialization and verification operations against one or more externally managed Intel(R) Omni-Path switches. The operations include initial switch setup, firmware upgrades, chassis reboot, and others. Syntax opaswitchadmin [-c] [-N ‘nodes‘] [-L nodefile] [-O] [-P packages] [-a action] [-t portsfile] [-p ports] operation… Options -help Produces full help text….
opaswenableall (Linux) Re-enables all unused (or disabled) switch ports. Syntax opaswenableall [-t portsfile] [-p ports] [-F focus] [-K mkey] Options –help Produces full help text. -t portsfile File with list of local HFI ports used to access fabrics for operation. Default is /etc/sysconfig/opa/ports file. -p ports List of local HFI ports used to access fabrics…
opaswdisableall (Linux) Disables all unused switch ports. Syntax opaswdisableall [-t portsfile] [-p ports] [-F focus] [-K mkey] Options –help Produces full help text. -t portsfile File with list of local HFI ports used to access fabrics when clearing counters. Default is /etc/sysconfig/opa/ports file. -p ports List of local HFI ports used to access fabrics for…
opasorthosts Sorts its standard input in a typical host name order and sorts to standard output. Hosts are sorted alphabetically (case-insensitively) by any alpha-numeric prefix, and then sorted numerically by any numeric suffix. Host names may end in a numeric field which may optionally have leading zeros. Unlike a pure alphabetic sort, this command results…
opashowmc (Linux) Displays the Intel(R) Omni-Path Multicast groups created for the fabric along with the Intel(R) Omni-Path Host Fabric Interface (HFI) ports which are a member of each multicast group. This command can be helpful when attempting to analyze or debug Intel(R) Omni-Path multicast usage by applications or ULPs such as IPoIB. Syntax opashowmc [-v]…
opashowallports (Switch and Host) Displays basic port state and statistics for all host nodes, chassis, or externally-managed switches. NOTE: opareport and opareports are more powerful Intel(R) Omni-Path Fabric Suite FastFabric commands. For general fabric analysis, use opareport or opareports with options such as -o errors and -o slowlinks to perform an efficient analysis of link…
opasetupssh (Linux or Switch) Creates SSH keys and configures them on all hosts or chassis so the system can use SSH and SCP into all other hosts or chassis without a password prompt. Typically, during cluster setup this tool enables the root user on the Management Node to log into the other hosts (as root)…
opascpall (Linux) Copies files or directories from the current system to multiple hosts in the fabric. When copying large directory trees, use the -t option to improve performance. This option tars and compresses the tree, transfers the resulting compressed tarball to each node, and untars it on each node. Use this tool for copying data…
opareports (All) opareports is a front end to opareport that provides many of the same options and capabilities. It can also run a report against multiple fabrics or subnets (for example, local host HFI ports). opareports can use an input file to augment the reports using additional details from the topology_input file. Syntax opareports [-t…
opareport (All) Provides powerful fabric analysis and reporting capabilities. Must be run on a host connected to the Intel(R) Omni-Path Fabric with the Intel(R) Omni-Path Fabric Suite FastFabric Toolset installed. Syntax opareport [-v][-q] [-h hfi] [-p port] [-o report] [-d detail] [-P|-H] [-N] [-x] [-X snapshot_input] [-T topology_input] [-s] [-r] [-V] [-i#8217#160; seconds] [-C] [-a]…
opapingall (All) Pings a group of hosts or chassis to verify that they are powered on and accessible through TCP/IP ping. Syntax opapingall [-C -p] [-f hostfile] [-F chassisfile] [-h ‘hosts’] [-H ‘chassis’] Options –help Produces full help text. -C Performs a ping against a chassis. The default is hosts. -p Pings all hosts/chassis in…
opapaquery (All) Performs various queries of the performance management (PM)/performance administration (PA) agent and provides details about fabric performance. Refer to the Intel(R) Omni-Path Fabric Suite Fabric Manager User Guide for a description of the operation and client services of the PM/PA. By default, opapaquery queries the most recent data. However, if an image number…
opalinkanalysis (Switch) Encapsulates the capabilities for link analysis. Additionally, this tool includes cable and fabric topology verification capabilities. This tool is built on top of opareport (and its analysis capabilities), and accepts the same syntax for input topology and snapshot files. In addition to being able to run assorted opareport link analysis reports, and generate…
opaledports Toggles the beaconing LED state of HFIs, switches, and switch ports. opaledports is a useful aid for finding specific physical nodes in a crowded data center. It supports the CSV link format provided by opaextractsellinks. Syntax opaledports [-h hfi] [-p port] [-C] [-s|-d] [on|off] #8217lt; portlist.csv Options –help Produces full help text. -h hfi…
opahostsmanalysis (All) Performs analysis against the local server only. It is assumed that both the host SM and the FastFabric are installed on the same system. The host SM analysis tool checks the following: • Host SM software version • Host SM configuration file (simple text compare using FF_DIFF_CMD) • Host SM health (for example,…
opahostadmin (Host) Performs a number of multi-step host initialization and verification operations, including upgrading software or firmware, rebooting hosts, and other operations. In general, operations performed by opahostadmin involve a login to one or more host systems. Syntax opahostadmin [-c] [-i ipoib_suffix] [-f hostfile] [-h ‘hosts‘] [-r release] [-I install_options] [-U upgrade_options] [-d dir] [-T…
opagentopology Generates sample topology verification XML. Provides an example of using opaxmlgenerate and is a prototype for customization. Uses CSV input files opatopology_links.txt, opatopology_FIs.txt, and opatopology_SWs.txt to generate LinkSummary, Node FIs, and Node SWs information respectively. These files are samples of what might be produced as part of translating a user custom file format into…