OmniPath switches

Software and documentation

Serial console connection

Connect to the serial console using the (unusual) supplied USB type A (male) to type A (male) cable. The switch contains a serial port device of type FT231X USB UART from FTDI Chip:

  • Download and unpack the appropriate FT231X_drivers.
  • Update device drivers from the downloaded files.
  • A new USB serial port device appears, update its drivers from the same files.
  • Connect to the serial port using a terminal (for example, PuTTy) with port speed 115200 baud.

SSH or telnet connection

Use SSH or telnet to connect to the switch IP address:

  • The system prompts for a user name. The CLI has the following default user names:

    Operator access: operator
    Administrator access: admin

    Type the appropriate user name and press ENTER.

  • The system prompts for a password. The CLI has the following default passwords:

    Operator access: operpass
    Administrator access: adminpass

Please note that the SSH connection will appear to be very slow (up to 1 minute) because SSH will try public-key logins before trying the password for login. Question: How to make SSH logins and ignoring the public-keys?

Managed switch configuration

Only switches with the Management Module installed can be accessed via the RJ45 network port. Unmanaged switches have a deactivated RJ45 port.

To access the CLI interface:

  • Connect a cross-over network cable to the switch RJ45 port and a PC network port.

  • The switch factory default network configuration is:

    • IP netmask
    • Administrator login: admin password: adminpass
  • Configure the PC network port with another address in the same subnet

  • From the PC try:

  • If ping is successful, try to login by SSH to the IP address and using the above login.

    Notice: The telnet connection doesn't work, even though the Intel manual advises to use it!

  • Once logged into the switch, type:

    list all

    to display brief help for all available commands.

  • Learn the network MAC address information by:

  • To change the switch to use standard DHCP network configuration, first configure your DHCP server with MAC and IP address for the switch. Then configure the switch using:


    and reconnect the switch to the normal network. The original network session will be disconnected.

  • Logging out:

  • Saving the settings: As far as we can see in the manual, system settings are permanent when entered. The good side of this is that you don't have to remember saving the settings to permanent memory.

Additional switch configurations

  • You must set the system hostname (choose a name XYZ):

    setSystemName "XYZ"

    as well as the default Node Name (SMA Description)

    setNodeDesc "XYZ"

    There is no documentation of the meaning of nor difference between the System Name and Node Description parameters.

    After a few minutes the Subnet Manager seems to recognize the new system name.

  • To display the system hostname and description:

  • Change the logged in user's password:

  • Set the conventional CLI Backspace and Delete keys by swapping the factory default:

  • To change the CLI prompt:

       <prompt> :new prompt.
       The prompt may not exceed 11 characters and is not saved across reboots.
       If the prompt contains a space, asterisk, comma, parenthesis or semicolon
       it must be enclosed with double quotes. For example: "*a prompt*". Also,
       if a prompt is not accepted, try to enclose it with double quotes.
       In order for some FastFabric Tools to function correctly, the prompt must
       end in "-> "(note trailing space).
  • Hardware check:

    hwCheck -verbose
  • Check and update the timezone and time:

    timeZoneConf 1  # Hours East/West of UTC
    timeDSTConf [<sw> <sd> <sm> <ew> <ed> <em>]  # For example: timeDSTConf 5 1 3 5 1 10
    time -T <hhmmss>[<mmddyyyy>]

Subnet Manager

  • To start a Subnet Manager (fabric size up to only 100 nodes supported, 200 nodes hard limit):

    smControl start

SNMP configuration

By default the managed switches do not respond to SNMP requests, one has to enable this explicitly in the CLI interface:

-> uiconfig   # Lists current settings
-> uiconfig -snmp 1 -snmpv1 1 -snmpv2 1

To set the system name, contact and location information:

-> snmpSystem edit -n opa-c3 -c -l "DK;Lyngby;Niflheim;B309;059;rack 22;38"

This information may also be entered on the switch web interface under the System tab, but this currently has a bug causing the settings to be ignored.

From a management host one may then send inquiries by SNMP:

snmpwalk -Os -c public -v 2c <IP-address> system

Unmanaged switch configurations

Only switches with the Management Module installed can be accessed via the RJ45 network port. Unmanaged switches have a deactivated RJ45 port.

See the document Intel® Omni-Path Fabric Suite FastFabric User Guide.

To list all switches in the OPA fabric:

opasaquery -t sw

To configure the switch names, see section 3.5 FastFabric OPA Switch Setup/Admin Menu. Run the command:

 2) Externally Managed Switch Setup/Admin
   2) Test for Switch Presence
   0) Edit Config and Select/Edit Switch File

To analyze the present fabric and produce a list of Externally Managed switches in the required format for the /etc/opa/switches file:


Insert this into the file /etc/opa/switches and review the 2nd field (hostname). The 3rd field is the link hop count, which needs to be correct when you do firmware updates, in order to avoid disrupted firmware upgrades.

Our current switches file contains:


Firmware updates

Firmware update on managed switch

Firmware update requires an FTP server.

Managed (core switch) define download:

fwversion   # Display fw versions
fwSetUpdateParams -c management -h <IP-address> -d pub/OmniPath -f STL1.q7.

Useful commands:

chassisQuery   # Check presence of module
bootQuery module -all
bootSelect module   # choose image to boot from

When everything looks fine, reboot the switch:


Firmware update on unmanaged switch

The CLI tool opaswitchadmin is used for unmanaged switch operations, see man opaswitchadmin. This command is part of the RPM package:

rpm -q opa-fastfabric

To select individual or subsets of switches, see the Intel® Omni-Path Fabric Suite FastFabric User Guide section Selection of Switches:

To perform operations against a set of externally-managed switches, you can specify the switch on which to operate using one of the following methods:

  • On the command line, using the -N option.
  • Using the environment variable SWITCHES to specify a space-separated list of switches. Useful when multiple commands are performed against the same small set of switches.
  • Using the -L option or the SWITCHES_FILE environment variable to specify a file containing the set of switches. Useful for groups of switches that are used often. The file is located here: /etc/opa/switches by default. The file must list all switches in the cluster.

Within the tools, the options are considered in the following order:

  1. -N option
  2. SWITCHES environment variable
  3. -L option
  4. SWITCHES_FILE environment variable
  5. /etc/opa/switches file

On the OPA management host copy the firmware file like:


To identify leaf/edge switch GUIDs, pull out the tab at the back of the switch and read the GUID.

To list all unmanaged switches in the fabric:


The output will be copied to /etc/opa/switches by opaswitchadmin.

To ping the unmanaged switches:

/usr/sbin/opaswitchadmin ping

Report switch firmware and hardware Info:

/usr/sbin/opaswitchadmin info

Upgrade switch firmware:

/usr/sbin/opaswitchadmin -a run -P Intel_PRREdge_V1_firmware. upgrade

Reboot switches:

/usr/sbin/opaswitchadmin reboot

To operate on subsets of switches that are defined in the file specified by -L add flags like:

-L /etc/opa/switches
-L /etc/opa/switch-subset

To install a new firmware on unmanaged switches using the TUI tool:

# opafastfabric
  2) Externally Managed Switch Setup/Admin
  4) Update Switch Firmware
  Enter Files/Directories to use (or none): Intel_PRREdge_V1_firmware.
  6) Reboot Switch  # When all is OK
  7) Report Switch Firmware & Hardware Info  # Verification

WARNING: The Reboot Switch action will reboot all switches.

Niflheim: OmniPath_switches (last edited 2018-07-14 11:01:31 by OleHolmNielsen)