Switch Image on an NT SmartNIC

Handling FPGA Images

product_line_custom
Napatech SmartNIC
category
User Guide

Procedure

  1. To check the state of SmartNIC 1, write: $ imgctrl --adapter 1 --query
    An example of an output is:
    imgctrl v3.5.5.1-f24b1 (Sep 12 2017 08:02:15) (Logfile: /tmp/imgctrl.log)
    Scanning for Napatech adapters..
    Adapter 1:
         PCI SLOT        : 0000:84:00.0
         PCI DEVICE ID   : 01A5
         PCI LANES       : x8x8
         ADAPTER TYPE    : NT200A01-02-SCC-2x100-E3-FF-ANL 2x100Gb QSFP28 platform
    RUNNING FPGA:
         FPGA IDENT      : 200-9516-09-08-0000
    FPGA BANK0:
         PRODUCT CODE    : 9516
         VERSION         : 9.08
         DOWNLOADED BY   : ntope
    FPGA BANK1:
         PRODUCT CODE    : 9515
         VERSION         : 9.08
         DOWNLOADED BY   : ntope
    SUPPORTCHIP INFO:
         NT200E3_2_PTP   : v3.5f
    FPGA IMAGE STATE:
         IMAGE STATE     : NEUTRAL (code 0)
         PRIMARY BANK    : 0
         RUNNING BANK    : 0
    The SmartNIC state must be NEUTRAL.
  2. To perform a quick switch operation, write: $ imgctrl --adapter 1 --switch
    An example of an output is:
    imgctrl v3.5.5.1-f24b1 (Sep 12 2017 08:02:15) (Logfile: /tmp/imgctrl.log)
    Scanning for Napatech adapters..
    Switching image on adapter 1:
      OK. Image switched. Remember to issue --confirm or --discard to accept/discard the change. Inquire the adapter via --query
  3. To verify that the state is now IMAGE SWITCH EVENT IN PROGRESS, write: $ imgctrl --adapter 1 --query
    An example of an output is:
    imgctrl v3.5.5.1-f24b1 (Sep 12 2017 08:02:15) (Logfile: /tmp/imgctrl.log)
    Scanning for Napatech adapters..
    Adapter 1:
         PCI SLOT        : 0000:84:00.0
         PCI DEVICE ID   : 01A5
         PCI LANES       : x8x8
         ADAPTER TYPE    : NT200A01-02-SCC-2x100-E3-FF-ANL 2x100Gb QSFP28 platform
    RUNNING FPGA:
         FPGA IDENT      : 200-9515-09-08-0000
    FPGA BANK0:
         PRODUCT CODE    : 9516
         VERSION         : 9.08
         DOWNLOADED BY   : ntope
    FPGA BANK1:
         PRODUCT CODE    : 9515
         VERSION         : 9.08
         DOWNLOADED BY   : ntope
    SUPPORTCHIP INFO:
         NT200E3_2_PTP   : v3.5f
    FPGA IMAGE STATE:
         IMAGE STATE     : IMAGE SWITCH EVENT IN PROGRESS (code 2)
         PRIMARY BANK    : 0
         CHANGED TO BANK : 1
  4. To acknowledge the switch and cause the primary image setting to be updated, write: $ imgctrl --adapter 1 --switch --confirm
    An example of an output is:
    imgctrl v3.5.5.1-f24b1 (Sep 12 2017 08:02:15) (Logfile: /tmp/imgctrl.log)
    Scanning for Napatech adapters..
    Applying current running image as safeboot image..
      OK. Adapter PrimaryImage has been updated to reflect current running image.
  5. To check that the state is back to NEUTRAL, and that the primary image bank has changed, write: $ imgctrl --adapter 1 --query
    An example of an output is:
    imgctrl v3.5.5.1-f24b1 (Sep 12 2017 08:02:15) (Logfile: /tmp/imgctrl.log)
    Scanning for Napatech adapters..
    Adapter 1:
         PCI SLOT        : 0000:84:00.0
         PCI DEVICE ID   : 01A5
         PCI LANES       : x8x8
         ADAPTER TYPE    : NT200A01-02-SCC-2x100-E3-FF-ANL 2x100Gb QSFP28 platform
    RUNNING FPGA:
         FPGA IDENT      : 200-9515-09-08-0000
    FPGA BANK0:
         PRODUCT CODE    : 9516
         VERSION         : 9.08
         DOWNLOADED BY   : ntope
    FPGA BANK1:
         PRODUCT CODE    : 9515
         VERSION         : 9.08
         DOWNLOADED BY   : ntope
    SUPPORTCHIP INFO:
         NT200E3_2_PTP   : v3.5f
    FPGA IMAGE STATE:
         IMAGE STATE     : NEUTRAL (code 0)
         PRIMARY BANK    : 1
         RUNNING BANK    : 1