About this task
The switching process is described in this table:
Procedure
Results
Note: A server boot (whether warm or cold) always generates PCI reset
events.
Note: A server cold boot event always sets the state to FAILED,
if the state was other than NEUTRAL.
Note: For Windows, it is recommended to perform the warm reboot with the
following steps:
- Switch using the --pcirst option as shown in the following command
example.
imgctrl -a0 -s --pcirst
- Restart the system: Click the Restart button. Do not recycle the power.
- Check the current IMAGE
STATE.
imgctrl -a0 -q
The following state is shown in the output.IMAGE STATE : IMAGE SWITCH EVENT IN PROGRESS (code 2)
- Confirm.
imgctrl -a0 -s --confirm
Note: If the SmartNIC is switched from a Link™ Capture to a Link-Virtualization™ Software FPGA image (or vice-versa), the
server must be rebooted to initialize to a different set of PCI resources ; reloading the
FPGA is not sufficient. Use the --pcirst option to perform a PCI Reset
switch method which will execute on next system reboot. Remember to
--confirm the switch after rebooting. An output example when switching to
the new FPGA image is
failed.
... Error: You cannot quick switch image. New image requires different set of PCI resources, which must be assigned during the PCI resource enumeration at server reboot. Please use --pcirst command and reboot the entire host to switch image. FAIL. Switching failed. Use --query to examine adapterThis is an example command sequence to switch the FPGA image from a Link™ Capture to a Link-Virtualization™ Software image (or vice-versa) with a PCI Reset.
/opt/napatech3/bin/imgctrl -s -a 0 --pcirst reboot /opt/napatech3/bin/imgctrl -s -a 0 --confirm