Recovering Software

Recovery procedure

This section explains how to recover devices from image installation failure or deleted or corrupted flash images.

Note: Software recovery should be performed under the supervision of a RUCKUS support engineer.

Note: To stop at the uboot prompt from the console, continuously press b during the boot process.

  1. Connect a console cable from the console port to the terminal server.
  2. Connect an Ethernet cable from the management port (the port located under the console port on the device) to the TFTP server.
    The device will be in boot mode for recovery.
  3. Display the existing variables from the boot prompt. 
    ICX7150-Boot> printenv
baudrate=9600
ipaddr=10.176.134.154
serverip=10.176.195.200
netmask=255.255.255.128
gatewayip=10.176.134.129
uboot=mnz10120b35.bin
image_name=SPR08095d.bin
ver=10.1.20b35T225 (Apr 29 2021 - 23:48:55 -0700)
    The path is to the boot image on the TFTP server.
  4. Set the TFTP server that hosts a valid ICX software image using the setenv serverip command. 
    ICX7150-Boot> setenv serverip 10.10.10.21
  5. Set the IP address, gateway IP address, and netmask for the device management port, and save the configuration using the setenv ipaddr, setenv gatewayip, setenv netmask, and saveenv commands. 
    ICX7150-Boot> setenv ipaddr 10.10.10.22
ICX7150-Boot> setenv gatewayip 10.10.10.1
ICX7150-Boot> setenv netmask 255.255.255.0
ICX7150-Boot> saveenv
    Note: The IP address and the gateway IP address set for the device management port should be for the same subnet as the TFTP server NIC.
  6. Enter the printenv command to verify the IP addresses that you configured for the device and the TFTP server. 
    ICX7150-Boot> printenv
baudrate=9600
ipaddr=10.176.134.154
serverip=10.176.195.200
netmask=255.255.255.128
gatewayip=10.176.134.129
uboot=mnz10120b35.bin
image_name=SPR08095d.bin
ver=10.1.20b35T225 (Apr 29 2021 - 23:48:55 -0700)
  7. Test the connectivity to the TFTP server from the device using the ping command to ensure a working connection. 
    ICX7150-Boot> ping 10.10.10.21
ethPortNo = 0
Using egiga0 device
host 10.10.10.21 is alive
  8. Provide the file name of the image that you want to copy from the TFTP server using the setenv image_name command. 
    ICX7150-Boot> setenv image_name SPR09010aufi.bin
  9. Update the flash using the update_primary or update_secondary command as appropriate. 
    ICX7150-Boot> update_primary
  10. Load the image from the primary or secondary flash using the boot_primary or boot_secondary command as appropriate. 
    ICX7150-Boot> boot_primary
Parent topic: Software Recovery