This knowledge base has moved to the documentation site. Please visit the knowledge base here for the most up to date content. This site is no longer maintained.

Booting into ONIE Install Mode



I already have Cumulus Linux running but I want to boot back into ONIE for troubleshooting/installation issues.


  • Cumulus Linux 2.x
  • Cumulus Linux 1.5.x

ONIE (the Open Network Install Environment) is utilized for installing Cumulus Linux.


  1. Log in to your switch via the console:
  2. Reboot the switch:
    cumulus@switch~:# sudo reboot
  3. Press any key when you see the following prompt:
    Hit any key to stop autoboot:  0
    The full output from the boot sequence is in this file: reboot.txt
  4. The switch will now boot into U-Boot.
    switch-> version
    U-Boot 2013.01.01-g1f891da (Sep 23 2013 - 18:31:29)
    ONIE 1.6.5
    powerpc-linux-gcc (GCC) 4.7.2
    GNU ld (GNU Binutils) 2.22

  5. To boot into ONIE install mode, type the following commands:
    -> setenv onie_boot_reason install
    -> run bootcmd
    NOTE: install mode will automatically start trying to install a switch binary (like Cumulus Linux). If it keeps booting into Cumulus Linux or other operating system and you just want to get to the ONIE prompt use the rescue mode instead, perform the following
    -> setenv onie_boot_reason rescue
    -> run bootcmd
  6. Press Enter to access the ONIE console.
    Please press Enter to activate this console. ONIE: Using DHCPv4 addr: eth0: /
    ONIE:/ #

See Also


  • Avatar
    Harrison Duong

    Is there a way to do this within the OS? The listed method requires an console connection.

  • Avatar
    Sean Cavanaugh

    use cl-img-select, (man cl-img-select for more info), there is a cl-img-select -r (rescue boot) that I think will get you the desired effect you are after (boot into ONIE from SSH).

This support portal has moved

Cumulus Networks is now part of the NVIDIA Networking Business Unit! The NVIDIA Cumulus Global Support Services (GSS) team has merged its operations with the NVIDIA Mellanox support services team.

You can access NVIDIA Cumulus support content from the Mellanox support portal.

You open and update new cases on the Mellanox support portal. Any previous cases that have been closed have been migrated to the Mellanox support portal.

Cases that are still open on the Cumulus portal will continue to be managed on the Cumulus portal. Once these cases close, they will be moved to the Mellanox support portal.

Powered by Zendesk