- How do I manually load the OS from the ONIE boot-loader?
- Switch with the ONIE network operating system installer
- Cumulus Linux, all versions
The following article outlines an alternative procedure for installing Cumulus Linux on an ONIE-based system (Open Network Install Environment). Use this method if you experience issues running ONIE (such as being unable to reach your HTTP server, or if you need to specify the switch's IP address).
All hardware systems supported by Cumulus Networks are shipped with ONIE. For more information on ONIE, please go to http://www.github.com/onie. If the system you have is on our HCL and is not running ONIE, please contact your hardware supplier or Cumulus Networks support at email@example.com.
- Download the appropriate Cumulus Linux install image from the Downloads page.
- Place the image in a server accessible from HTTP from the switch. In this example,
cumulus-install-powerpc.binwill be located at
10.0.1.251, with the URL to access the image as
Boot the system into the ONIE prompt. ONIE has a DHCP client running on it, and should pick up an IP address in the network. Iif you need the MAC address for static assignment through DHCP, the following command will provide it:
ONIE:/ # printenv eth_addr eth_addr=70:72:CF:8C:23:4D ONIE:/ #
ONIE:/#prompt, ensure the switch can contact to the HTTP server with the install image:
ONIE:/ # ping 10.0.1.251 PING 10.0.1.251 (10.0.1.251): 56 data bytes 64 bytes from 10.0.1.251: seq=0 ttl=64 time=0.544 ms 64 bytes from 10.0.1.251: seq=1 ttl=64 time=0.243 ms 64 bytes from 10.0.1.251: seq=2 ttl=64 time=0.228 ms 64 bytes from 10.0.1.251: seq=3 ttl=64 time=0.230 ms
If the HTTP server is unreachable, ensure you have an IP address, type
ONIE:/ # ifconfig eth0 Link encap:Ethernet HWaddr 44:38:39:00:30:41 inet addr:10.0.1.184 Bcast:10.0.1.255 Mask:255.255.255.0 inet6 addr: fe80::4638:39ff:fe00:3041/64 Scope:Link UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:65583 errors:0 dropped:0 overruns:0 frame:0 TX packets:12710 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:5844096 (5.5 MiB) TX bytes:1236728 (1.1 MiB) Base address:0x6000 ONIE:/ #
WARNING: If there is no IP address assigned to the system, then please troubleshoot the DHCP server for the network and ensure you do not need to add a static IP address.
onie-nos-installcommand. The switch will reboot at the end of the installation process.
ONIE:/ #onie-nos-install http://10.0.1.251/home/path/to/your/build/images/cumulus-install-powerpc.bin
Allow the system to reboot until you see a login prompt:
For your initial login to the system, use the default user name and password. For security reasons, please update the password as soon as possible using the