Dell EMC Networking ONIE Quick Start Guide An introduction to ONIE on Dell EMC Networking devices Abstract Dell EMC Networking ONIE quick start guide. This guide provides the essentials needed to update and prepare a switch for a networking OS installation.
Revisions Date Description August 2018 Initial release 1.0 Acknowledgements This paper was produced by the Dell EMC Networking Infrastructure Solutions team. Dell_Networking_Solutions@dell.com The information in this publication is provided “as is.” Dell Inc. makes no representations or warranties of any kind with respect to the information in this publication, and specifically disclaims implied warranties of merchantability or fitness for a particular purpose.
Table of contents 1 Introduction ...................................................................................................................................................................4 2 ONIE Operations ..........................................................................................................................................................5 3 ONIE menu ...........................................................................................................................
1 Introduction The concept of Open Networking is a core element of Dell EMC Networking’s strategy and mission. Open Networking embraces the disaggregation of the traditional locked-down and proprietary networking stack. Dell EMC accomplishes this effort by using standards-based building blocks that use open source where possible.
2 ONIE Operations This section covers the operations available within each ONIE menu. Review the various functions that are listed in Table 1 to assist with navigating to the necessary menu. The ONIE: Install OS section and the ONIE: Update section will allow for an automatic (zero-touch) process and a manual process. Note: See section 4 ONIE: Install OS and section 7 ONIE: Update for more information.
3 ONIE menu To access the ONIE menu use the following steps: 1. First make a serial connection to the switch. Note: For specific connection information download and reference the switch's Installation Guide on support.dell.com. 2. Once the connection has been made to the switch, power on the switch or reload. As the switch boots, it will pause at the GRUB menu if the switch is loaded without an OS or has OS10 installed. If the switch has OS9 installed, press Esc during the autoboot process.
The EDA-DIAG and ONIE selections display only if an operating system was not previously installed. GRUB Menu with no OS 3. Use the down arrow key to select ONIE and press the Enter key. Note: On the next step, you must use an up/down arrow key or make your selection within 5 seconds of seeing the menu, or else the default selection will run automatically. 4. Once ONIE is selected the sub menus will be displayed. Note: See Table 1 for information on each menu.
4 ONIE: Install OS There are multiple ways in which an Operating System can be installed using ONIE. The default setting is to have ONIE auto-discovery enabled. With ONIE auto-discovery enabled an automatic (zero-touch) install from a USB flash drive or HTTP/TFTP server can be performed. Another option is to stop the discovery process and install the Operating System manually. For each of the remote installations to work properly, an IP address is needed on the switch. The default is DHCP.
Perform the following steps for an HTTP/TFTP zero touch installation: 1. Install a Linux web server, such as Apache, that a switch can access once it has obtained its IP address from a DHCP server. 2. Copy the operating system installer file to the path shared by the web server, such as /var/www/html, and rename it onie-installer or another qualified file name. Note: For a listing of qualified file names used by ONIE auto-discovery, see Appendix C. 3.
4.2.2 USB You can manually install the OS image using a USB drive. Note: Verify that the USB drive supports a FAT 32 or EXT2 file system. 1. Plug the USB drive with the desired operating system into the USB port on the device. 2. Enter the following command to create a USB mount location on the system: ONIE:/ # mkdir /mnt/media 3. Validate the specific file path for the USB drive on the switch with the blkid command. The USB drive is highlighted in the command output below.
5 ONIE: Rescue Four operations can be performed within the ONIE: Rescue mode: • • • • Operating system installations ONIE updates Diagnostics installs Firmware updates Note: ONIE updates and operating system installations are covered in the ONIE: Update section and the ONIE: Install OS section. The same process applies in ONIE: Rescue mode for those two operations. 5.
diag-installer-x86_6 100% |*******************************| 164M 0:00:00 ETA ONIE: Executing installer: tftp:///diag-installer-x86_64dellemc_s4100_c2338-r0-3.33.3.1-6-2018-02-05.bin Ignoring Verifying image checksum ... OK. cur_dir / archive_path /var/tmp/installer tmp_dir /tmp/tmp.bSyRpb Preparing image archive ...sed -e '1,/^exit_marker$/d' /var/tmp/installer | tar xf - OK.
Diag Version CRC-32 Checksum is valid. 0x2E 0xFE 10 3.33.3.1-6 4 0x474D58A6 INSTALLER DONE... Removing /tmp/tmp.bSyRpb ONIE: NOS install successful: tftp://100.67.2.65/diag-installer-x86_64dellemc_s4100_c2338-r0-3.33.3.1-6-2018-02-05.bin ONIE: Rebooting... 5.2 Firmware Updates To update the firmware, BIOS/CPLD perform the following steps: 1. Boot the switch into ONIE: Rescue mode. Note: The install package must be first downloaded from support.dell.com and accessible via http/tftp/ftp. 2.
6 ONIE: Uninstall OS The uninstallation of the operating system is not required, however, if the installation of an operating system is not successfully completed or if there are additional issues, use the ONIE: Uninstall OS function to resolve any issues. When the ONIE: Uninstall OS option is selected, ONIE automatically goes through and deletes any existing operating system on the switch. ONIE and diagnostics are not deleted.
7 ONIE: Update Use the ONIE: Update menu to update ONIE. To manually update ONIE, run the onie-discovery-stop command and disable the auto discovery function. When in the CLI prompt of ONIE: Update, enter the following command to verify the ONIE version: ONIE:/ # onie-sysinfo -v 3.33.1.1-6 If a different version of ONIE is required, perform the following steps to update ONIE: 1. Navigate to support.dell.com and select the specific Dell EMC networking device. 2.
Note: For more information on this process, see Open Computer Project. The content of this document is specific to Dell EMC Networking, as where the Open Computer Project documentation is generic. For HTTP or TFTP zero-touch installation, perform the following steps: 1. Install a Linux web server, such as Apache, that a switch can access after it has obtained an IP address from a DHCP server. 2.
7.2.2 USB The ONIE update can be manually installed using a USB drive. Note: Before you continue, verify that the USB drive supports a FAT32 or EXT2 file system. 1. Plug the USB drive into the USB port on the device. 2. Enter the following command to create a USB mount location on the system: ONIE:/ # mkdir /mnt/media 3. Validate the specific file path for the USB drive on the switch with the blkid command. The USB drive is highlighted in the command output below.
8 ONIE: Embed mode The ONIE: Embed mode is used to fully reinstall ONIE. This option is rarely used as ONIE is usually preinstalled on Dell EMC Networking devices. If use of ONIE: Embed is required, see the ONIE Recovery procedure included in the ONIE .zip file for your specific switch which is available from the Drivers and Downloads section of support.dell.com.
9 EDA-DIAG The EDA-DIAG within ONIE is used to validate hardware or to determine the current BIOS, CPLD, or FPGA versions. EDA-DIAG is also used if the ONIE firmware installation procedure fails, by upgrading the BIOS, CPLD, or FPGA images individually. Note: Not all switches have FPGA images. The Dell EMC Networking S4048-ON and Dell EMC Networking S3048-ON use a different form of ONIE Diagnostics called DCLI. Note: If using the DCLI diagnostics, see Appendix B.
ONIE:/ # onie-syseeprom -g 0x2E 3.33.3.1-6 9.2 Hardware diagnostics Use the edatool command to test the hardware. The edatool command determines the tool versions installed and performs hardware diagnostics. The edatool command references the versions installed and determines whether an upgrade is required. Note: If edatool does not run, see the EDA-DIAG tools upgrade section for information on installing diagnostic tools.
1. Download the diagnostic tools from support.dell.com and unzip. 2. Copy the dn-diags-sssss-DiagOS-vvvvvv-ddddd.deb file to the switch. root@dellemc-diag-os:~# ls dn-diags-S4100-DiagOS-3.33.4.1-6-2018-01-21.deb 3. Run the dpkg command to upgrade the tools. root@dellemc-diag-os:~# dpkg --install dn-diags-S4100-DiagOS-3.33.4.1-62018-01-21.deb Selecting previously unselected package dn-diags-s4100-on.deb. (Reading database ... 19769 files and directories currently installed.
root@dellemc-diag-os:~# cpldupgradetool --write --image=s41x8_1.1_1.0_0.7.vme 9.6 EDA-DIAG SMF-MSS upgrade The SmartFusion-Microcontroller Subsystem (SMF-MSS) can be verified or upgraded from the EDA-DIAG, however, each switch may have a specific procedure for this update. Note: See the Hardware Diagnostic Guide specific to your switch, to update the SMF-MSS. A switch that does not have an SMF-MSS image will not have the smarttool command available for use.
A Manually assign an IP address To manually assign an IP address: 1. Enter the following command to stop the ONIE discovery process: onie-discovery-stop 2. If a DHCP server is not used, configure the IP address and subnet mask on the management port, where x.x.x.x represents your internal IP address. ifconfig eth0 x.x.x.x netmask 255.255.255.0 up 3.
B DCLI diagnostics This section applies to the Dell EMC Networking S3048-ON and the Dell EMC Networking S4048-ON. These switches use the DCLI diagnostics. All other switches use the EDA diagnostics. Note: See Diagnostics for information on the EDA diagnostics. ONIE sub menu with DCLI Diagnostics PLATFORM-DELL-DIAG boots to DCLI prompt. No login/password. DLCI supports CPLD image upgrades but not BIOS upgrades.
Slave CPLD Version : 5 Packed CPLD image Info: Packed System CPLD Version Packed Master CPLD Version Packed Slave CPLD Version B.1 : 15.2 : 12 : 5 PPId Info: PPId PPId Revision : TW0J09D32829849Q0048 : X01 SysEeprom Info: Base MAC Address Country Code Part Number Manufacturer Manufacture Date Product Name : : : : : : 34:17:eb:f2:52:c4 TW 0J09D3 28298 10/03/2014 13:39:37 DCLI upgrade To verify the current version of DIAGs installed: 1. Access the Platform-DIAGs menu. 2.
Info: Fetching tftp://100.67.2.65/INSTALLER-DND-SK-1.0.0.14.bin ... random: nonblocking pool is initialized INSTALLER-DND-SK-1.0 100% |*******************************| 27143k 0:00:00 ETA ONIE: Executing installer: tftp://100.67.2.65/INSTALLER-DND-SK1.0.0.14.bin Verifying image checksum ... OK. Preparing image archive from /var/tmp/installer ... Done. Mounting /dev/sda3...mkfs.fat 3.0.26 (2014-03-07) Done. Copying Images ...Done. Installing Menu Entry ...
B.5 Exit DLCI DLCI->reload Note: Do not enter ‘exit’ from the DCLI prompt or the switch, otherwise you will need to power cycle the switch.
C Qualified ONIE file names The following file names are for the Dell EMC Networking S4048-ON. The s4000 field differs from switch to switch. Note: To reach a larger grouping of switches, Dell EMC recommends the use of a more generic file name.
D Validated hardware and software versions The following tables list the hardware and components used to configure and validate the example configurations in this guide. D.1 Dell EMC networking switches Versions Qty Item OS/Firmware version 1 Dell EMC Networking S4148U-ON ONIE software 3.33.1.1-4 DIAG OS 3.33.3.0-1 DIAG tools 3.33.4.1-6 Firmware 3.33.5.1-19 ONIE software 3.21.5.3 DIAG OS 1.0.0.14 Firmware 3.21.5.
E Technical support and resources All future switches and software are available at support.dell.com. Switch Description Link Comments Dell EMC Networking S3048-ON Open Networking Troubleshooting Guide https://www.dell.com/sup HTML port/manuals/us/en/19/fo rce10-s3048-on/ontroubleshootingpub/about-thisguide?guid=guid99f0717c-c76f-43c49307e0f56f8fc9fb&lang=enus ONIE Software https://www.dell.com/sup .
ONIE Software https://www.dell.com/sup .zip port/home/us/en/19/drive rs/driversdetails?driverId Onie_installer =TPNCP Onie_recovery Onie_recovery_notes Diagnostics OS https://www.dell.com/sup .zip port/home/us/en/19/drive rs/driversdetails?driverId INSTALLER-DND SK=GK22T x.x.x.x.bin Release Notes Firmware updater https://www.dell.com/sup .zip port/home/us/en/19/drive rs/driversdetails?driverId BIOS.zip =V4DJ1 CPLD.
BIOS CPLD Dell EMC Networking S4112-ON and Dell EMC Networking S4112T-ON Open Networking Hardware Diagnostic Guide https://www.dell.com/sup HTML port/manuals/us/en/19/n etworking-s4112fon/generic-on-hw-diagpub/about-thisguide?guid=guid09038dc8-cfd0-438dbda2fab9792eb801&lang=enus ONIE Software https://www.dell.com/sup .zip port/home/us/en/19/drive rs/driversdetails?driverId ONIE Updater =78N0W ONIE Recovery Release Notes Diagnostics OS https://www.dell.com/sup .
ONIE Software https://www.dell.com/sup .zip port/home/us/en/19/drive rs/driversdetails?driverId ONIE Updater =CH1RW ONIE Recovery Release Notes Diagnostics OS https://www.dell.com/sup .zip port/home/us/en/19/drive rs/driversdetails?driverId Diag OS Installer =TJ9N5 Diagnostic tools https://www.dell.com/sup .zip port/home/us/en/19/drive rs/driversdetails?driverId Dn-diags-S4100=GXXTV DiagOS-xxxxx.deb Firmware updater https://www.dell.com/sup .
Firmware updater https://www.dell.com/sup .zip port/home/us/en/19/drive rs/driversdetails?driverId Onie-firmware =FT8DP BIOS CPLD Dell EMC Networking S4148U-ON Open Networking Hardware Diagnostic Guide https://downloads.dell.co .pdf m/manuals/allproducts/esuprt_ser_stor _net/esuprt_networking/ networking-s4148uon_specifications_enus.pdf ONIE Software https://www.dell.com/sup .
ONIE Software https://www.dell.com/sup .zip port/home/us/en/19/drive rs/driversdetails?driverId ONIE Updater =C2W9R ONIE Recovery Release Notes Diagnostics OS https://www.dell.com/sup .zip port/home/us/en/19/drive rs/driversdetails?driverId Diag OS Installer =1DWN8 Diag Tools for S4248FB/FBL-ON https://www.dell.com/sup .zip port/home/us/en/19/drive rs/driversdetails?driverId Dn-diags-S4200=MN65P DiagOS-xxxxx.deb Diag Tools for S4248FBL-ON https://www.dell.com/sup .
networking-s5048fon_reference_guide_enus.pdf ONIE Software https://www.dell.com/sup .zip port/home/us/en/19/drive rs/driversdetails?driverId ONIE Updater =18VXM ONIE Recovery Release Notes Diagnostics OS https://www.dell.com/sup .zip port/home/us/en/19/drive rs/driversdetails?driverId Diag OS Installer =D4J38 Diagnostic Tools https://www.dell.com/sup .zip port/home/us/en/19/drive rs/driversdetails?driverId Dn-diags-S4100=21JT1 DiagOS-xxxxx.deb Firmware updater https://www.dell.com/sup .
Diagnostic Tools https://www.dell.com/sup .zip port/home/us/en/19/drive rs/driversdetails?driverId Dn-diags-S4100=KMTRX DiagOS-xxxxx.deb Firmware updater https://www.dell.com/sup .zip port/home/us/en/19/drive rs/driversdetails?driverId Onie-firmware =F2R2C BIOS CPLD Dell EMC Networking S6000-ON Open Networking Troubleshooting Guide https://www.dell.
ONIE Recovery Release Notes Diagnostics OS https://www.dell.com/sup .zip port/home/us/en/19/drive rs/driversdetails?driverId Diag OS Installer =4178G Diagnostic Tools https://www.dell.com/sup .zip port/home/us/en/19/drive rs/driversdetails?driverId Dn-diags-S4100=09J4V DiagOS-xxxxx.deb Firmware updater https://www.dell.com/sup .zip port/home/us/en/19/drive rs/driversdetails?driverId Onie-firmware =7XFV8 BIOS CPLD Dell EMC Networking S6100-ON Open Networking Hardware Diagnostic Guide https://www.
Dell EMC Networking Z9100-ON Open Networking Hardware Diagnostic Guide https://www.dell.com/sup HTML port/manuals/us/en/19/n etworking-z9100/z9100on-hw-diag-pub/aboutthis-guide?guid=guid99f0717c-c76f-43c49307e0f56f8fc9fb&lang=enus ONIE Software https://www.dell.com/sup .zip port/home/us/en/19/drive rs/driversdetails?driverId ONIE Updater =H2P74 ONIE Recovery Release Notes Diagnostics OS https://www.dell.com/sup .
F Support and feedback Contacting Technical Support Support Contact Information Web: http://support.dell.com/ Telephone: USA: 1-800-945-3355 Feedback for this document We encourage readers to provide feedback on the quality and usefulness of this publication by sending an email to Dell_Networking_Solutions@dell.