Booting into ONIE Install Mode

Follow

Issue

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

Environment

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

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

Resolution

  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
    switch->
    switch->

  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: 192.168.100.14 / 255.255.255.0
    ONIE:/ #
    

See Also

Have more questions? Submit a request

Comments

  • 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).

Powered by Zendesk