Install Guide

| ONIE: Diag ONIE |
+--------------------------------------------------------+
● Install OS—Boots to the ONIE prompt and installs an NOS image using the Automatic Discovery process. When ONIE installs
a new OS image, the previously installed image and configuration are deleted.
● Rescue—Boots to the ONIE prompt and enables manual installation of an NOS image or ONIE update.
● Uninstall OS—Deletes the contents of all disk partitions, including the NOS configuration, except ONIE and diagnostics.
● Update ONIE—Installs a new ONIE version.
● Embed ONIE—Formats the disk and installs ONIE.
● EDA DIAG—Runs the system diagnostics.
After the ONIE process installs an NOS image and you later reboot the switch in ONIE: Install OS mode (default), ONIE
takes ownership of the system and remains in Install mode (ONIE Install mode is sticky) until an NOS image successfully installs
again. To boot the switch from ONIE for any reason other than installation, select the ONIE: Rescue or ONIE: Update
ONIE option from the ONIE boot menu.
CAUTION: During an automatic or manual NOS installation, if an error condition occurs that results in an
unsuccessful installation and if there is an existing OS on the device, select Uninstall OS to clear the
partitions. If the problem persists, contact Dell EMC Technical Support.
Automatic NOS installation
You can automatically install an NOS image on a Dell EMC ONIE-enabled device. This process is known as zero-touch install.
After the device boots to ONIE: Install OS, ONIE autodiscovery follows these steps to locate the installer file and uses the
first successful method:
1. Use a statically configured path that is passed from the boot loader.
2. Search file systems on locally attached devices, such as USB.
3. Search the exact URLs from a DHCPv4 server.
4. Search the inexact URLs based on the DHCP responses.
5. Search IPv6 neighbors.
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 Image Discovery and
Execution. For more information, see the Open Networking Hardware Diagnostic Guide on the Dell EMC Support site.
● 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. Skipping configuration.
ONIE: Failed to configure eth1 interface
ONIE: Starting ONIE Service Discovery
Info: Fetching tftp://xx.xx.xx.x/onie-installer-x86_64-dellemc_<platform>_c2338 ...
Info: Fetching tftp://xx.xx.xx.x/onie-installer-dellemc_<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 ...
Installation using ONIE
55