6. Start a TFTP waterfall.
The ONIE automatic discovery process locates the stored software image, downloads, and installs it, and reboots the device
with the new image. Autodiscovery repeats until a successful software image installation occurs and reboots the switch.
ONIE discovery — Usage information
● All ONIE autodiscovery methods download and run only supported default file names, such as onie-installer. The
required file names and search order are described on the Open Network Install Environment website at
Execution. For more information, see the Open Networking Hardware Diagnostic Guide on the
● If you use a DHCPv4 server, ONIE autodiscovery obtains the hostname, domain name, Management interface IP address,
and the IP address of the domain name server (DNS) from the DHCP server and DHCP options. It also searches SCP, FTP,
or TFTP servers with the default DNS of the ONIE server. DHCP options are not used to provide the server IP.
● If you use a USB storage device, ONIE searches only FAT or EXT2 file systems for an NOS image.
Example: NOS automatic installation
1. On the TFTP server, rename the NOS image to a supported installer file name, such as onie-installer, using the mv
image-name default-filename command.
mv <NOS-image-name>.bin onie-installer
2. Boot up the switch in ONIE: Install mode to install an NOS image.
Starting: discover... done.
ONIE:/ # Info: eth0: Checking link... up.
Info: Trying DHCPv4 on interface: eth0
ONIE: Using DHCPv4 addr: eth0: xx.xx.xx.xx / xxx.x.x.x
Info: eth1:
Checking link... down.
ONIE: eth1: link down.
ONIE: Failed to configure eth1 interface
ONIE: Starting ONIE Service Discovery
Info: Fetching tftp://xx.xx.xx.x/onie-installer-x86_64-dell_<platform>_c2338 ...
Info: Fetching tftp://xx.xx.xx.x/onie-installer-dell_<platform>_c2338 ...
Info: Fetching tftp://xx.xx.xx.x/onie-installer-x86_64-bcm ...
Info: Fetching tftp://xx.xx.xx.x/onie-installer-x86_64 ...
Info: Fetching tftp://xx.xx.xx.x/onie-installer ...
ONIE: Executing installer: tftp://xx.xx.xx.x/onie-installer
...
...
...
Press <DEL> or <F2> to enter setup.
Welcome to GRUB!
Manual NOS installation
If you do not use the ONIE-based automatic installation of a NOS image and if a DHCP server is not available, you can manually
install the image. Configure the Management port and provide the software image file to start the installation.
1. Save the NOS software image on an SCP/TFTP/FTP server.
2. Power up the switch and select ONIE Rescue for manual installation.
3. (optional) Stop DHCP discovery if you were not able to select ONIE Rescue mode.
$ onie-stop
4. Configure the IP addresses on the Management port, where x.x.x.x represents your internal IP address. After you configure
the Management port, the response is up.
$ ifconfig eth0 x.x.x.x netmask xxx.xxx.x.x up
5. Install the software on the device. The installation command accesses the NOS from the specified SCP, TFTP, or FTP URL,
creates partitions, verifies installation, and reboots itself.
$ onie-nos-install image_url
For example, enter
ONIE:/ # onie-nos-install ftp://a.b.c.d/
Skipping configuration.
<NOS-image_name> .bin
Image Discovery and
Dell Support
site.
Installation using ONIE
77