Install ONIE
Check the current ONIE version of your switch by executing the following command in e.g. the ONIE-rescue shell:
onie-sysinfo -v
If your switch has the supported ONIE preinstalled you can skip this part and Install BISDN Linux right away. In the other case you can either install a complete ONIE or upgrade an existing one.
Supported ONIE versions
Only the following ONIE versions are tested and supported. Installation on other versions may not work as expected.
| Device | Bootloader | ONIE version |
|---|---|---|
| Delta AG5648 | GRUB | V1.00 |
| Delta AG7648 | GRUB | 2017.08.01-V1.12 (Build date 20181109) |
| Edgecore AS4610-30T/P | U-Boot | 2016.05.00.041 |
| Edgecore AS4610-54T/P | U-Boot | 2016.05.00.041 |
| Edgecore AS4630-54PE | GRUB | 2020.08.00.031 |
| Edgecore AS5835-54X | GRUB | 2019.08.00.011 |
| Edgecore AS7726-32X | GRUB | 2017.11.00.051 |
1 Edgecore support account required
Install ONIE
Prepare a bootable USB device and copy the proper ONIE image to it. One way is to download the .iso file given by the links above. Copy the file to the USB device like in the example below.
This example copies the .iso of the ONIE installer for AG7648 to the USB device on sdb:
sudo dd if=20181109-onie-recovery-x86_64-delta_ag7648-r0.iso of=/dev/sdb bs=10M
sync
NOTE: For installing ONIE on AG5648 platform please follow the instructions on github (see link above).
Attach the USB device to your switch and reboot it. Enter the ONIE boot menu then press c to get into the grub CLI. Enter the following commands to boot from a USB device.
set root=(hd1)
chainloader +1
boot
Then select ONIE: Embed ONIE and the switch is going to install ONIE from the USB device.
Update ONIE
Reboot the switch.
On switches using GRUB bootloader:
Enter the ONIE boot menu then select ONIE: Rescue to get into the ONIE CLI.
On switches using U-Boot bootloader:
Interrupt the U-Boot boot countdown by pressing any key and enter
run onie_rescue
to get into the ONIE CLI.
Download the .bin file given by the links above and put it onto an http server that is reachable by the switch. Start the update via the CLI command onie-self-update as shown in the example below.
onie-self-update -v http://local-http-server/onie-updater
Note: The ONIE CLI command can only process http URLs.
More information about the ONIE CLI command can be found here.