Dell Z9432F-ON ONIE Instruction Manual

Dell EMC PowerSwitch Z9432F-ON ONIE
Firmware Updater Release Notes
March 2021
Rev. A01

Notes, cautions, and warnings
NOTE: A NOTE indicates important information that helps you make better use of your product.
CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid
the problem.
WARNING: A WARNING indicates a potential for property damage, personal injury, or death.
© 2021 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other
trademarks may be trademarks of their respective owners.

Chapter 1: .................................................................................................................................... 4
Z9432F–ON Series Firmware updater release notes................................................................................................. 4
Document revision history........................................................................................................................................... 4
Firmware requirements.................................................................................................................................................4
Important information...................................................................................................................................................5
IP address assignment in ONIE.................................................................................................................................. 6
ONIE-based firmware update process..................................................................................................................... 6
Support resources........................................................................................................................................................12
Contacting Dell EMC................................................................................................................................................... 12
Contents
Contents 3

Z9432F–ON Series Firmware updater release notes
This document describes firmware updater information for the Z9432F-ON switch.
Document revision history
Table 1. Revision history
Revision Date Description
A00 2021-02 Initial release
A01 2021-03 Updated the Firmware requirements section.
Firmware requirements
The following are contained in this release:
NOTE: Before deploying your switch, Dell Technologies recommends that you check and install the latest firmware or
software images available for upgrade. This upgrade ensures that you get access to the most complete feature set.
Table 2. New firmware versions
Firm New firmware versions
ONIE FW Updater v3.51.5.1-4
BMC v4.51.6.4-2.03
BIOS v3.51.0.D-6
CPLD v1.02
PCIe v1.0
FPGA v2.00
New in this release
FPGA
●Replaced non-inclusive language
●Added port beacon LED support
●Xilinx 2019.2-based PCIe core and compile
CPLD
●Added watchdog timer support
1
4

Important information
The following is important information you need to know when working with your switch:
Secure boot
For the secure boot feature, the .bin file is replaced with the .tar file. The .tar archive file has both the .bin file and
the .sig file to verify the secure boot .bin file. You do not have to untar the .tar file to access the .bin file.
NOTE: If you specify the .bin file, the .sig file MUST be in the same location as the .bin file.
Firmware downgrade not recommended
After you upgrade the firmware, Dell Technologies does not recommend downgrading to an earlier BIOS version. Downgrading
to an earlier BIOS version causes the AMI label to change. This AMI label change may cause an unwanted change to the NVRAM
variable layout.
CAUTION: To avoid damage to your switch, never downgrade Z9432F-ON switches running BIOS version
3.40.0.9-8 and above to BIOS version 3.40.0.9-7 or below.
ONIE install mode recovery
For information about the ONIE install mode recovery process, see the Dell EMC PowerSwitch Z9432F-ON Release Notes.
BIOS version numbering change
The following describes the BIOS version nomenclature. The version X.Y.Z.U-V:
XThe processor family. For example, 3 for X86 on an Z9432F-ON switch.
YThe platform ID within the processor family. For example, the Z9432F-ON switch is 51.
Z* The image type. For example, BIOS = 0.
UThe bit definitions for the BIOS are from 0 through 5, as shown in the table.
VThe image version.
Table 3. BIOS bit definitions
Bit Feature State
0 Partition 0=MBR, 1=UEFI
1 Baud rate 0=115200, 1=9600
2 N/A N/A
3 PXE 1=supported
4 N/A N/A
5 Bootloader 0=AMI BIOS
*BIOS=0, ONIE=1, Grub=2, DIAG-OS=3, DIAG tools=4, and ONIE FW Updater=5.
CPLD version numbering change
The CPLD version nomenclature has changed. The new version is in the form of major.minor—the major release number
then the minor release number.
5

Power cycle the switch
CAUTION: After powering off the switch and before power cycling on the switch back on, be sure that the PSU
LED indicator is off—no color displays.
ONIE infrastructure support
This release includes ONIE infrastructure support for firmware updates.
IP address assignment in ONIE
By default, DHCP is enabled in ONIE. If your network has DHCP configured, ONIE gets the valid IP address for the management
port using DHCP, as shown.
Info: Using eth0 MAC address: xx:xx:xx:xx:xx:xx
Info: Using eth1 MAC address: xx:xx:xx:xx:xx:xx
Info: eth0: Checking link... up.
Info: Trying DHCPv4 on interface: eth0
ONIE: Using DHCPv4 addr: eth0: xx.xx.xxx.xx / xxx.xxx.xxx.x
You can manually assign an IP address.
1. Wait for ONIE to complete a DHCP timeout and return to the prompt.
2. Wait for ONIE to assign a random default IP address. This address may not be valid for your network.
3. Enter the ifconfig command to assign a valid IP address.
This command is not persistent. After you reboot, you must reconfigure the IP address.
** Rescue Mode Enabled ** ONIE:/ #
ONIE:/ # ifconfig eth0 xx.xx.xxx.xxx/xx up
ONIE-based firmware update process
NOTE: Always update the ONIE operating system first. After this update finishes, update the firmware, such as the BIOS,
CPLD, FPGA, and so forth.
NOTE: The output examples are for reference only. Your output may vary.
You can update the firmware by using any of the following methods:
●Firmware update invoked manually from ONIE
●Firmware update using the USB
●Firmware update staging from NOS
●Firmware update staging from ONIE
WARNING: Do not power cycle or power off your switch when you upgrade the CPLD image.
WARNING: The FW-updater program updates the switch as needed.
NOTE: Upgrading the CPLD may take up to 10 minutes.
NOTE: After you have successfully upgraded, the FW-updater program power-cycles the switch.
6

Firmware update invoked manually from ONIE
Manually invoke the firmware update from the ONIE prompt using the onie-self-update command.
NOTE: This method allows you to update the firmware components, for example BIOS and CPLD, in one step without
requiring a switch reboot. However, this method is not support for platforms supporting the multistage reboot sequence.
There are two ways to use the onie-self-update command. For ease of use, Dell Technologies recommends using Option 1.
OPTION 1:
1. Boot into Rescue mode.
2. Start the firmware update process using the onie-self-update command.
ONIE:/ # onie-self-update tftp://x.x.x.x/onie-firmware-x86_64-VENDOR_MACHINE -r0.tar
OPTION 2:
1. Boot into Rescue mode.
2. Copy the firmware update binary to the target.
Using SCP:
●ONIE:/ # scp <[email protected]> :/tftp/users/<name>/fw-updater.tar<space> .
●ONIE:/ # scp <[email protected]> :/home/<name>/fw-updater.tar<space> .
WGET supports HTTP and FTP options. You can use ONIE: / # wget if supported by the host server or machine. Using
WGET:
●ONIE: / # wget --quiet http://xx.xx.x.xxx/tftpboot/users/<name>/fw-updater.tar
Use TFTP if the host or server supports this option. The .txt file must be present in the TFTP directory; for example, /
tftpboot/users/<name>/fw-updater.tar. Using TFTP:
●ONIE: / # tftp -g -r fw-updater.tar xx.xx.xxx.xxx .
3. Start the firmware update process using the onie-self-update command.
ONIE:/ # onie-self-update onie-firmware-x86_64-VENDOR_MACHINE -r0.tar
Verify firmware update
After you have updated the firmware, verify that all components are running the correct version. To verify the firmware version,
use the ONIE:~ # onie-sysinfo -F command. For example:
ONIE:~ # onie-sysinfo -F
BIOS version:x.xx.x.x-x
CPU_CPLD version:x.x
PORT_01_16_CPLD version:x.x
PORT_17_34_CPLD version:x.x
FPGA version:x.x
MAIN-BMC firmware version:x.xx
Firmware update using USB
You can manually install the OS10 software image using a USB device. Verify that the USB device supports a FAT or EXT2 file
system. For instructions to format a USB device in FAT or EXT2 format, see the Windows documentation accompanying the
USB device.
NOTE: Using the onie-firmware-x86_64-dellemc_platform_c3538-r0.x.xx.x.x-x.tar image only updates
the ONIE firmware components, such as BIOS and CPLD. This image does not update the base ONIE version.
1. Plug the USB storage device into the USB storage port on the switch.
2. Power up the switch to automatically boot using the ONIE: Rescue option.
7

3. Create a USB mount location on the system.
$ mkdir /mnt/media
4. Identify the path to the USB drive.
$ fdisk -l, blkid
5. Mount the USB media plugged into the USB port on the device.
$ mount -t vfat usb-drive-path /mnt/media
6. Install the software from the USB, where /mt/media specifies the path where the USB partition is mounted.
$ onie-self-update /mnt/media/onie-firmware-x86_64-dellemc_platform_c3538-r0.x.xx.x.x-
x.tar
Verify firmware update
After you have updated the firmware, verify that all components are running the correct version. To verify the firmware version,
use the ONIE:~ # onie-sysinfo -F command. For example:
ONIE:~ # onie-sysinfo -F
BIOS version:x.xx.x.x-x
CPU_CPLD version:x.x
PORT_01_16_CPLD version:x.x
PORT_17_34_CPLD version:x.x
FPGA version:x.x
MAIN-BMC firmware version:x.xx
Firmware update staging from NOS
There are two options for staging the firmware update from the networking operating system (NOS).
NOTE: These steps are for a switch with Dell EMC SmartFabric OS10 installed.
For switches running software version 10.5.x.x or later, use Option 1. For switches running software version 10.4.x.x or earlier,
use Option 2.
Option 1
For switches running software version 10.5.x.x or later:
1. Download the OS10 firmware file from a server using the image download <server-filepath/firmware-
filename>command in EXEC mode.
OS10# image download http://xx.xx.x.xxx/tftpboot/users/regr//neteng/<name>/files
/new/onie-firmware-x86_64-dellemc_<platform>_c3538-rx.x.xx.x.x-x.tar
2. Install the OS10 firmware file using the image install <firmware-file-url>l command in EXEC mode, where
firmware-file is the name of the firmware file downloaded in Step 1.
OS10# image install image://onie-firmware-x86_64-dellemc_<platform>_c3538-rx.x.xx.x.x-
x.tar
To view the pending firmware upgrade, use the show image firmware command. To cancel a firmware installation and
remove any pending firmware upgrades, use the image cancel command.
8

3. Reload the switch in EXEC mode.
OS10# reload
Option 2
For switches running software version 10.4.x.x or earlier:
1. Log in to Dell EMC SmartFabric OS10 as the Linux administrator.
Debian GNU/Linux 9 OS10 ttyS0
Dell EMC Networking Operating System (OS10)
OS10 login: admin
Password: admin
2. Configure an IP address for the management port to get the firmware updater over the network.
OS10# configure terminal
OS10(config)# interface mgmt 1/1/1
OS10(conf-if-ma-1/1/1)# no ip address dhcp
OS10(conf-if-ma-1/1/1)# ip address xx.xx.xxx.xx/xx
OS10(conf-if-ma-1/1/1)# no shutdown
OS10(conf-if-ma-1/1/1)# exit
OS10(config)# management route xx.xx.x.x/xx managementethernet
OS10(config)# exit
OS10#
3. Confirm you can reach the network.
OS10# ping -c4 xx.xx.x.xxx
PING xx.xx.x.xxx (xx.xx.x.xxx) 56(84) bytes of data.
64 bytes from xx.xx.x.xxx: icmp_seq=1 ttl=61 time=2.59 ms
64 bytes from xx.xx.x.xxx: icmp_seq=2 ttl=61 time=2.48 ms
64 bytes from xx.xx.x.xxx: icmp_seq=3 ttl=61 time=2.62 ms
64 bytes from xx.xx.x.xxx: icmp_seq=4 ttl=61 time=2.41 ms
--- xx.xx.x.xxx ping statistics ---
4 packets transmitted, 4 received, 0% packet loss, time 3004ms
rtt min/avg/max/mdev = 2.411/2.526/2.621/0.104 ms
OS10#
4. Get the Linux prompt using the system bash command.
OS10# system bash
admin@OS10:/config/home/admin$
5. Change the directory to /home/admin using the cd command.
admin@OS10:/config/home/admin$ cd
admin@OS10:~$
6. Confirm that the ONIE partition is already mounted.
admin@OS10:~$ mount | grep onie
/dev/sda2 on /mnt/onie-boot type ext4 (rw,relatime,data=ordered)
admin@OS10:~$
As shown, the ONIE partition is mounted. If it is not mounted, follow these steps:
a. Change to Root mode.
admin@OS10:~$ sudo -i
We trust you have received the usual lecture from the local System
Administrator. It usually boils down to these three things:
#1) Respect the privacy of others.
#2) Think before you type.
#3) With great power comes great responsibility.
9

[sudo] password for admin: admin
b. Mount the ONIE partition, if not already mounted.
root@OS10:~# mkdir -p /mnt/onie-boot/
root@OS10:~# mount LABEL=ONIE-BOOT /mnt/onie-boot
7. Confirm that the onie-fwpkg command is accessible.
This action also confirms that the ONIE partition is mounted correctly.
root@OS10:~# /mnt/onie-boot/onie/tools/bin/onie-fwpkg
** Pending firmware update information:
No pending firmware updates present.
root@OS10:~#
8. Use the scp command to copy the firmware updater binary from the host to the target.
root@OS10:~# scp < name >@xx.xx.x.xx:/home/< name >/fw-updater.tar .
Password: admin
fw-updater.tar 100% 18MB 28.0MB/s 00:00
admin@OS10:~$ ls -ltr fw-updater.tar
-rw-r--r-- 1 admin sysadmin 19314551 Mar 16 02:46 fw-updater.tar
root@OS10:~#
9. Use the add option of the onie-fwpkg command to stage the firmware updater from the OS10.
root@OS10:~# /mnt/onie-boot/onie/tools/bin/onie-fwpkg add fw-updater.tar
Staging firmware update: fw-updater.tar
root@OS10:~# /mnt/onie-boot/onie/tools/bin/onie-fwpkg
** Pending firmware update information:
Name | Version | Attempts |Size (Bytes) | Date
======== ====+==== =====+==========+==============+====================
fw-updater.tar | x.xx.x.x-xx | 0 | 19314551 | 2018-02-17 03:19:35
=============+==========+==========+==============+====================
For more detailed information run: onie-fwpkg show-pending <update_name>
root@OS10:~#
10. Set next boot to ONIE update mode.
root@OS10:~# os10-image -o update
WARNING: ONIE update requested
Are you sure (y/N)? y
Success setting boot mode to ONIE update
Reboot required to take effect
root@OS10:~#
11. Reboot your switch to enter ONIE update mode and start the firmware update.
Optionally, to set the next boot to ONIE mode, use the ONIE:/# onie-boot-mode -o update command.
Verify firmware update
After you have updated the firmware, verify that all components are running the correct version. To verify the firmware version,
use the ONIE:~ # onie-sysinfo -F command. For example:
ONIE:~ # onie-sysinfo -F
BIOS version:x.xx.x.x-x
CPU_CPLD version:x.x
PORT_01_16_CPLD version:x.x
PORT_17_34_CPLD version:x.x
10

FPGA version:x.x
MAIN-BMC firmware version:x.xx
Firmware update staging from ONIE
1. Boot into ONIE Rescue or Update mode.
If you boot into Update mode, stop discovery using the onie-discovery-stop command.
2. Copy the fw-updater image from the host to the target.
onie-fwpkg command with 'add' option would queue the firmware update.
onie-fwpkg add <fw_updater.tar>
3. Boot back to ONIE update mode if you previously booted to Rescue mode.
After you boot into ONIE Update mode, the ONIE firmware updates infrastructure, locates the firmware update archive, and
proceeds to update the components.
If you were previously in ONIE Update mode and stopped discovery using the onie-discovery-stop command, restart
discovery using the onie-discovery-start command. This command causes the ONIE firmware updater infrastructure to
locate the firmware updater binary image and proceed with the firmware update.
The following is a list of ONIE staging command options:
ONIE:/mnt/onie-boot # onie-fwpkg purge
Removing all pending firmware updates (
y/N)? y Purging all pending firmware updates. ONIE:/mnt/onie-boot #
ONIE:/mnt/onie-boot # onie-fwpkg
** Pending firmware update information:
No pending firmware updates present.
ONIE:/mnt/onie-boot #
ONIE:/mnt/onie-boot # wget http://xx.xx.x.xxx//tftpboot/users/<name>/<platform>/FWUPG
RD/onie-firmware-x86_64-dell_<platform>_c2338-r0.x.x.x.x.tar
Connecting to xx.xx.x.xxx (xx.xx.x.xxx:xx)
onie-firmware-x86_64 100% |*******************************| 12521k 0:00:00 ETA
ONIE:/mnt/onie-boot #
ONIE:/mnt/onie-boot # onie-fwpkg add onie-firmware-x86_64-dell_<platform>_c2338-r0x.x.x.x.tar
Staging firmware update: onie-firmware-x86_64-dell_<platform>_c2338-r0.x.x.x.x.tar
ONIE:/mnt/onie-boot #
ONIE:/mnt/onie-boot # onie-fwpkg show-pending
** Pending firmware update information:
Name |Version|Attempts|Size (Bytes)|Date
======================================================+=======+========+============+===
onie-firmware-x86_64-dell_<platform>_c2338-r0.x.x.x.x.tar|x.x.x.x| 0 |12822391|2016-11-03
23:45:45
======================================================+=======+========+============+===
For more detailed information run: onie-fwpkg show-pending <update_name> ONIE:/mnt/onie-
boot #
ONIE:/mnt/onie-boot # ONIE:/mnt/onie-boot #
ONIE:/mnt/onie-boot # onie-fwpkg show-pending onie-firmware-x86_64-dell_<platform>_c2338-r0.x.x.x.x.tar
** Pending firmware update information:
Name |Version|Attempts|Size (Bytes)|Date
======================================================+=======+========+============+===
onie-firmware-x86_64-dell_<platform>_c2338-r0.x.x.x.x.tar|x.x.x.x| 0 |12822391 |
2016-11-03
23:45:45
======================================================+=======+========+============+===
Verify firmware update
11

After you have updated the firmware, verify that all components are running the correct version. To verify the firmware version,
use the ONIE:~ # onie-sysinfo -F command. For example:
ONIE:~ # onie-sysinfo -F
BIOS version:x.xx.x.x-x
CPU_CPLD version:x.x
PORT_01_16_CPLD version:x.x
PORT_17_34_CPLD version:x.x
FPGA version:x.x
MAIN-BMC firmware version:x.xx
Support resources
The following support resources are available for the Z9432F-ON switch:
Documentation resources
For more information about using the Z9432F-ON switch, see the following documents at https://www.dell.com/support:
●Dell EMC PowerSwitch Z9432F-ON Installation Guide
●Dell EMC PowerSwitch Z9432F-ON Set-Up Guide
●Dell EMC PowerSwitch Z9432F-ON Release Notes
●Dell EMC PowerSwitch Z9432F-ON DIAG OS and Tools Release Notes
●Dell EMC PowerSwitch Z9432F-ON BMC Guide
●Open Networking Hardware Diagnostic Guide
●Dell EMC SmartFabric OS10 Release Notes
●Dell EMC SmartFabric OS10 User Guide
For more information about the open network installation environment (ONIE)-compatible third-party operating system, see
https://onie.org.
Contacting Dell EMC
The Dell EMC support site provides documents and tools to help you use Dell EMC equipment and mitigate network outages.
Through the support site you can obtain technical information, access software upgrades and patches, download available
management software, and manage your open cases. The Dell EMC support site provides integrated, secure access to these
services.
Dell EMC provides several online and telephone-based support and service options. Availability varies by country and product,
and some services may not be available in your area.
To access the Dell EMC support site, go to www.dell.com/support/. To display information in your language, scroll down to the
bottom of the web page and select your country from the drop-down menu.
●To obtain product-specific information, enter the 7-character Service Tag or 11-digit express service code of your switch,
which is found on the pull-out tag, also known as a luggage tag, and click Submit.
●To receive more technical support, click Contact Us. On the Contact Information web page, click Technical Support.
To access product documentation and resources for specific Dell EMC Networking switches, see the Dell EMC Networking
OS10 Info Hub.
To search for drivers and downloads, go to the Drivers and Downloads section for your switch at www.dell.com/drivers/.
To participate in Dell EMC community blogs and forums, go to www.dell.com/community.
12