Boot into ONIE

Issue

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

You use ONIE (the Open Network Install Environment) to install Cumulus Linux on open networking switches.

Environment

• Cumulus Linux, all versions

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
   

4. ARM switches only: The switch now boots 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->
   

   To boot into ONIE install mode, type the following commands:

   -> setenv onie_boot_reason install
   -> run bootcmd
   

   Install mode automatically starts trying to install a switch binary (like Cumulus Linux). If it keeps booting into Cumulus Linux and you just want to get to the ONIE prompt, use rescue mode instead:

   -> setenv onie_boot_reason rescue
   -> run bootcmd
   

5. Select ONIE from the GRUB menu, then press Enter to access the ONIE console.

                           GNU GRUB  version 2.02-cl3u3
   +----------------------------------------------------------------------------+
   | Cumulus Linux GNU/Linux                                                    | 
   | Advanced options for Cumulus Linux GNU/Linux                               |
   | Load a read-only snapshot                                                  |
   |*ONIE                                                                       |
   | ACCTON-DIAG                                                                |
   |                                                                            |
   |                                                                            |
   |                                                                            |
   |                                                                            |
   |                                                                            |
   |                                                                            |
   |                                                                            | 
   +----------------------------------------------------------------------------+
        Use the ^ and v keys to select which entry is highlighted.          
        Press enter to boot the selected OS, `e' to edit the commands       
        before booting or `c' for a command-line.                           
     The highlighted entry will be executed automatically in 4s.   
   

6. Select the ONIE mode to use then press Enter.

                             GNU GRUB  version 2.02~beta3
   +----------------------------------------------------------------------------+
   | ONIE: Install OS                                                           |
   |*ONIE: Rescue                                                               |
   | ONIE: Uninstall OS                                                         |
   | ONIE: Update ONIE                                                          |
   | ONIE: Embed ONIE                                                           |
   | ACCTON-DIAG                                                                |
   |                                                                            |
   |                                                                            |
   |                                                                            |
   |                                                                            |
   |                                                                            |
   |                                                                            |
   +----------------------------------------------------------------------------+
        Use the ^ and v keys to select which entry is highlighted.          
        Press enter to boot the selected OS, `e' to edit the commands       
        before booting or `c' for a command-line.                           
    The highlighted entry will be executed automatically in 1s.                 
   

7. The ONIE prompt appears.

   ONIE:/ #