How to recover ONIE on Edgecore x86 platform via PXE?

[stordis-toc]

Introduction

Recovering the Open Network Install Environment (ONIE) on Edgecore x86 platforms using PXE (Preboot Execution Environment) allows for remote system recovery without requiring physical access to the device. Below is a detailed step-by-step guide to performing this recovery process.

Supported Models:

• AS5916-54XL
• AS5916-54XKS
• AS7312-54XS
• AS7326-56X
• AS7712-32X
• AS7816-64X
• AS5835-54T
• AS5835-54X
• AS7726-32X
• AS5712-54X
• AS5812-54X
• AS4610-54T
• AS4630-54PE 

Requirements:

• PC – for setting up the TFTP and DHCP server.
• Ethernet RJ45 cable – to connect to the switch's management (MGMT) port.
• Serial console cable – to connect to the switch’s console port (usually included with the device).
• TFTP and DHCP Server – with support for DHCP options 66 and 67.
• PXE Boot File – download and extract the correct PXE file for your device.
• ONIE-updater Image – download the correct ONIE-updater image for your device.
• Console Terminal Software – such as PuTTY, Tera Term, or SecureCRT.

Step-by-Step Recovery Process

STEP 1: Set up the DHCP and TFTP Server

• Place the PXE boot file and ONIE-updater image in the root directory of the TFTP server.

• Rename the ONIE-updater file to:

  onie-updater-x86_64-accton_[Device_Model]-r0.bin

  Example:

  onie-updater-x86_64-accton_as7712_32x-r0.bin

  

  

• Edit the default file in the pxelinux.cfg folder to ensure the file name matches the ONIE-updater file.

• Launch the TFTP server application (e.g., tftp64.exe), select the correct directory and network interface.

• Set the boot file to pxelinux.0.

• Verify that both TFTP and DHCP servers are running correctly and that settings such as root directory, network interface, IP pool, gateway, and subnet mask are properly configured.

STEP 2: Connect to the Switch

• Connect an Ethernet cable from your PC to the switch’s MGMT port.
• Connect a console cable from your PC to the console port on the switch.
• Open a terminal emulator (e.g., Tera Term) and set the baud rate to 115200.

STEP 3: Configure the Switch’s BIOS

• Power on the switch and immediately press ESC to enter the BIOS setup.

• Navigate to Advanced → Network Stack Configuration.

• Enable Network stack and IPv4 PXE Support.

• Go to CSM Configuration and set Network to Legacy.

• Save changes and restart the device using Save Changes and Reset from the Save & Exit menu.

STEP 4: Set Boot Order

• After the reboot, enter BIOS again.

• Go to the Boot section and set:

  IBA GE slot 00A0 v1543

  as Boot Option #1.

  

• Save changes and restart the device.

STEP 5: Start the ONIE Recovery Process

• After reboot, the switch will request an IP address from the DHCP server and attempt to load the file pxelinux.cfg/default.

• When the boot: prompt appears, press Enter.

• Select "ONIE: Embed ONIE" to begin the recovery process.

• The system will load the ONIE-updater file (hence, it is crucial to have the correct file name).

• Once the process is complete, the switch will automatically reboot.

STEP 6: Restore Default Boot Order

• After the reboot, enter BIOS again.

• In the Boot section, set the storage device (e.g., eUSB or mSATA) as Boot Option #1:

  P0: ATP mSATA

  

  (The exact name may vary depending on the switch model.)

• Save changes and restart the switch.

STEP 7: Finalizing the Process

• After rebooting, ONIE should be successfully restored and ready for use.

Useful Links:

• How to set up the TFTP server (tftpd64) on Windows?
• How to set up the TFTP server (tftpd-hpa) on Ubuntu 20.04?
• How to set up a DHCP Server in Ubuntu?
• How to set up your first console connection to the open networking switch?
• How to recover ONIE on Edgecore x86 platform switch via USB?
• Firmware & Software (Edgecore Open Networking Switches)

For more free resources, visit: https://stordis.com/free-resources/