Dell PowerSwitch S4148F-ON, PowerSwitch S4148T-ON, PowerSwitch S4148FE-ON User Manual

Open Networking Hardware Diagnostic Guide

June 2018

Notes, cautions, and warnings

NOTE: A NOTE indicates important information that helps you make better use of your computer.

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.

trademarks may be trademarks of their respective owners.

2018 - 06

Rev. A05

Contents

1 About this guide............................................................................................................................................. 7

Notices.................................................................................................................................................................................7

Related documents............................................................................................................................................................ 7

2 ONIE and Dell EMC OS installation instructions.............................................................................................8

ONIE expansion.................................................................................................................................................................. 8

DIAG-OS installation.......................................................................................................................................................... 8

ONIE and DIAG OS installation.........................................................................................................................................9

ONIE service discovery and OS installation....................................................................................................................9

Installation ONIE from BIOS............................................................................................................................................10

ONIE UEFI-based installation using USB.................................................................................................................10

3 ONIE overview............................................................................................................................................. 16

ONIE expansion.................................................................................................................................................................16

Boot processes................................................................................................................................................................. 16

POST............................................................................................................................................................................16

Capture support data from ONIE............................................................................................................................. 16

Change default grub boot entry................................................................................................................................17

View system information..................................................................................................................................................17

4 Dell EMC DIAG OS....................................................................................................................................... 19

Diagnostic package download.........................................................................................................................................19

Diagnostic test suite.................................................................................................................................................. 22

View DIAG versions..........................................................................................................................................................22

View CPLD versions........................................................................................................................................................ 22

Install or upgrade DIAG tools.......................................................................................................................................... 23

Restore factory defaults..................................................................................................................................................23

5 Dell EMC DAIG-OS tools............................................................................................................................. 25

Diagnostic tools................................................................................................................................................................25

edatool...............................................................................................................................................................................26

Tests............................................................................................................................................................................ 26

CLI options..................................................................................................................................................................26

Output......................................................................................................................................................................... 26

Verbose mode.............................................................................................................................................................28

cpldupgradetool................................................................................................................................................................29

Tests............................................................................................................................................................................ 29

CLI options..................................................................................................................................................................29

Output.........................................................................................................................................................................30

cputool...............................................................................................................................................................................30

Tests............................................................................................................................................................................ 30

CLI options..................................................................................................................................................................30

Contents

Output..........................................................................................................................................................................31

eepromtool........................................................................................................................................................................32

Tests............................................................................................................................................................................ 32

CLI options..................................................................................................................................................................32

Output......................................................................................................................................................................... 33

ethtool............................................................................................................................................................................... 35

fantool............................................................................................................................................................................... 35

Tests............................................................................................................................................................................ 35

CLI options..................................................................................................................................................................35

OutputTest output.....................................................................................................................................................36

ashrom.............................................................................................................................................................................37

gpiotool..............................................................................................................................................................................38

CLI options..................................................................................................................................................................38

Output......................................................................................................................................................................... 38

list output....................................................................................................................................................................38

get output...................................................................................................................................................................39

set output................................................................................................................................................................... 39

i2ctool................................................................................................................................................................................39

Tests............................................................................................................................................................................ 39

CLI options..................................................................................................................................................................39

Outputscan Output................................................................................................................................................... 40

test Output..................................................................................................................................................................41

read Output................................................................................................................................................................ 42

write Output............................................................................................................................................................... 42

ledtool................................................................................................................................................................................42

Tests............................................................................................................................................................................ 42

CLI options..................................................................................................................................................................43

Outputlist output........................................................................................................................................................44

get Output.................................................................................................................................................................. 44

lpctool................................................................................................................................................................................45

CLI options..................................................................................................................................................................45

OutputRead output................................................................................................................................................... 45

Write output............................................................................................................................................................... 45

memtool............................................................................................................................................................................ 45

Tests............................................................................................................................................................................ 46

CLI options..................................................................................................................................................................46

OutputList output...................................................................................................................................................... 47

Info output.................................................................................................................................................................. 48

Test output................................................................................................................................................................. 49

Read output................................................................................................................................................................49

Write output............................................................................................................................................................... 49

Constraints..................................................................................................................................................................49

Data ow.....................................................................................................................................................................49

nputool.............................................................................................................................................................................. 49

Tests............................................................................................................................................................................ 50

Contents

CLI options..................................................................................................................................................................50

nvramtool..........................................................................................................................................................................55

Tests............................................................................................................................................................................ 55

CLI option................................................................................................................................................................... 55

OutputRead outputWrite output............................................................................................................................. 55

opticstool.......................................................................................................................................................................... 56

Tests............................................................................................................................................................................ 56

CLI options..................................................................................................................................................................56

Outputshow=brief outputshow outputshow --int=interface # output...............................................................57

pcitool................................................................................................................................................................................60

Tests............................................................................................................................................................................ 60

CLI options..................................................................................................................................................................60

Outputscan outputtest outputshow output............................................................................................................61

phytool...............................................................................................................................................................................64

Tests............................................................................................................................................................................ 64

CLI optionsOutput..................................................................................................................................................... 64

pltool..................................................................................................................................................................................66

Tests............................................................................................................................................................................ 66

CLI options..................................................................................................................................................................66

OutputList outputListdevicenames outputRead outputWrite outputTest output............................................. 67

psutool...............................................................................................................................................................................68

Tests............................................................................................................................................................................ 68

CLI optionstest option...............................................................................................................................................68

rtctool................................................................................................................................................................................ 70

Tests.............................................................................................................................................................................70

CLI options..................................................................................................................................................................70

smartctl.............................................................................................................................................................................. 71

smarttool............................................................................................................................................................................71

SMF upgrade binariesCLI options.............................................................................................................................71

SMF MSS upgrade.................................................................................................................................................... 72

Upgrading SMF FPGA............................................................................................................................................... 74

smbiostool......................................................................................................................................................................... 76

CLI options..................................................................................................................................................................76

Output......................................................................................................................................................................... 77

storagetool........................................................................................................................................................................ 77

Tests.............................................................................................................................................................................77

CLI options.................................................................................................................................................................. 77

Outputlist outputtest outputsmart outputbonnie output..................................................................................... 78

smartctl....................................................................................................................................................................... 80

bonnie++..................................................................................................................................................................... 82

temptool............................................................................................................................................................................82

Tests............................................................................................................................................................................ 82

CLI options..................................................................................................................................................................83

Outputtest output......................................................................................................................................................83

updatetool.........................................................................................................................................................................84

Contents

Tests............................................................................................................................................................................ 84

CLI options..................................................................................................................................................................84

Output.........................................................................................................................................................................85

vmetool............................................................................................................................................................................. 85

CLI options..................................................................................................................................................................85

Diagnostic package..........................................................................................................................................................85

6 Dell EMC support........................................................................................................................................ 86

6 Contents

About this guide

This guide provides site preparation recommendations, step-by-step procedures for rack mounting and desk mounting, inserting optional modules, and connecting to a power source.

Notices

CAUTION: To avoid electrostatic discharge (ESD) damage, wear grounding wrist straps when handling this equipment.

WARNING: Only trained and qualied personnel can install this equipment. Read this guide before you install and power up this

equipment. This equipment contains two power cords. Disconnect both power cords before servicing.

WARNING: This equipment contains optical transceivers, which comply with the limits of Class 1 laser radiation.

Figure 1. Class 1 laser product tag

WARNING: When no cable is connected, visible and invisible laser radiation may be emitted from the aperture of the optical

transceiver ports. Avoid exposure to laser radiation and do not stare into open apertures.

ONIE and Dell EMC OS installation instructions

This section describes the dierent methods to install ONIE and the Dell EMC OS on your system.

NOTE: After installing the networking operating software (NOS) and diagnostics operating system (DIAG-OS), if you boot into

ONIE Install mode, ONIE assumes ownership of the system; ONIE Install mode is sticky. In this situation, ONIE stays in Install mode until NOS and DIAG-OS are successfully installed again. If you want to boot into ONIE for any reason other than installation, use Rescue mode or Update mode.

NOTE: To access ONIE, use the RJ-45 console port.

ONIE expansion

To view all the ONIE commands available, from the ONIE prompt, enter onie- and click <tab> twice.

ONIE:/ # onie- <TAB><TAB> onie-boot-mode onie-fwpkg onie-syseeprom onie-console onie-nos-install onie-sysinfo onie-discovery-start onie-self-update onie-uninstaller onie-discovery-stop onie-support

Topics:

• DIAG-OS installation

• ONIE and DIAG OS installation

• ONIE service discovery and OS installation

• Installation ONIE from BIOS

DIAG-OS installation

: If you have a recovery USB plugged into your system, you must remove it before installing the DIAG-OS.

NOTE

1 Assign an IP address to the management interface.

Conrm you can reach the network.

2 Install the DIAG-OS from the ONIE prompt using the following command:

ONIE:/ # onie-nos-install tftp://x.x.x.x/diag-installer-x86_64-dell_<platform>_<processor id>-r0.bin

After the DIAG-OS installs, the system reboots and displays following menu:

: By default, the system boots in DIAG-OS mode.

NOTE

GNU GRUB version 2.02~beta2+e4a1fe391

8 ONIE and Dell EMC OS installation instructions

| | | | | | | | | | | | | | +----------------------------------------------+

Use the ^ and v keys to select which entry is highlighted. Press enter to boot the selected OS, `e' to edit the commands before booting or `c' for a command-line.

ONIE and DIAG OS installation

The following steps describe how to load ONIE and DIAG-OS on your system:

• Installing ONIE—these instructions use the universal serial bus (USB) method. To boot from a Linux USB, you must preinstall BIOS on your system.

• Installing the DIAG-OS—Install the DIAG-OS from the ONIE prompt. Ensure that your TFTP server is reachable over your network.

• ONIE operates using a 115200 baud rate. Ensure that any equipment attached to the serial port supports the required 115200 baud rate.

NOTE: The following output examples are for reference only; your output may vary.

NOTE: The management port IP, FTP server IP address, MAC address, and user-id shown are for illustration purpose only. Use

your system’s applicable values.

ONIE service discovery and OS installation

ONIE attempts to locate the installer through several discovery methods, as shown. To download and run an installer, the ONIE Service Discovery feature uses the rst successful method found.

1 Pass from the boot loader.

2 Search locally attached storage devices for one of the ONIE default installer lenames—for example, USB.

3 Discover the URLs from DHCPv4.

4 Report discovered URLs based on the DHCPv4 responses.

5 Query to the IPv6 link-local neighbors using HTTP for an installer.

6 Start TFTP waterfall—from the DHCPv4 option 66.

ONIE ifconfig eth0 command examples

If none of the ONIE Service Discovery methods are successful, you can disable this using the onie-discovery-stop command.

You can install an operating system manually from HTTP, USB, FTP, or TFTP using the onie-nos-install <URL> command.

NOTE

: If you have a recovery USB plugged into your system, you must remove it before installing the DIAG-OS using the onie-

nos-install <URL> command.

The ONIE Install environment uses DHCP to assign an IP address to the management interface, eth0. If that fails, it uses the link-local IPv4 address 169.254.209.190/16.

To display the IP address, use the ifconfig eth0 command, as shown:

ONIE:/ # ifconfig eth0 eth0 Link encap:Ethernet HWaddr 90:B1:1C:F4:9C:76 inet addr:x.x.x.x Bcast:x.x.x.x Mask:x.x.x.x inet6 addr: fe80::92b1:1cff:fef4:9c76/64 Scope:Link UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:18 errors:0 dropped:0 overruns:0 frame:0 TX packets:24 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:1152 (1.1 KiB) TX bytes:6864 (6.7 KiB) Interrupt:21 Memory:ff300000-ff320000

ONIE and Dell EMC OS installation instructions

To assign an IP address to the management interface, eth0, and verify network connectivity, use the ifconfig eth0 <ip address> command, as shown:

ONIE:/ # ifconfig eth0 x.x.x.x netmask x.x.x.x UP

Then set speed on management interface as below

ONIE:/ # ethtool -s eth0 speed 100 duplex full Verify the network connection with ping. ONIE:/ # ping x.x.x.x PING x.x.x.x (x.x.x.x): 56 data bytes 64 bytes from x.x.x.x: seq=0 ttl=62 time=1.357 ms 64 bytes from x.x.x.x: seq=1 ttl=62 time=0.577 ms ^C

Installation ONIE from BIOS

There are two options for installing ONIE from the BIOS.

• Media (usb) boot using the ONIE installer USB (using the OCP Procedure)

• Media (usb) boot using the Ubuntu installer USB (using the custom-bootable USB procedure)

Pre-requisites

The BIOS running on your system must meet the following requirements:

• Allows a change to the boot order so the system can boot from media (USB).

• Allows a baud-rate change. This feature is optional; you do not need it if your BIOS is running at 115200 baud rate. The default baud rate for ONIE is 115200.

CAUTION

• These procedures are for x86-based targets only, particularly targets using Rangeley or Centerton CPU-based boards.

• Check the console (UART-0/1) used on the target.

• The log messages included in this guide are subject to change.

NOTE: The following procedure is generic and does not list a particular target. Therefore, the ONIE images are specied using

the <platform>_<cpu> notation. For example, the ONIE media (usb) iso image is onie-recovery-x86_64- dell_<platform>_<cpu>-r0.iso.

ONIE UEFI-based installation using USB

The following steps describe how to create a bootable unied extensible rmware interface (UEFI) ONIE-based USB to install ONIE using Embed mode:

To install ONIE UEFI on your system, use any existing ONIE-based system to make an ONIE UEFI-based bootable USB. To make a bootable USB, use the ONIE ISO le.

1 Boot the ONIE target in ONIE Rescue mode.

Use ONIE Rescue mode to make the ONIE UEFI-bootable USB.

To select which entry is highlighted, use the up and down arrow keys. Press Enter to select an operating software-selected OS or enter e to edit the commands before booting. Enter c for a command line. The highlighted entry, displaying *, executes automatically in the operating system.

GNU GRUB version 2.02~beta2+e4a1fe391

+---------------------------+ |ONIE: Install OS |

ONIE and Dell EMC OS installation instructions

2 Conrm that your system can reach the network.

3 Copy the ONIE ISO image to the solid-state drive (SSD) of the ONIE target.

ONIE:/ # wget --quiet http://xx.xx.x.xxx/tftpboot/users/<name>/onie-recovery-x86_64dell_<platform>_c2538-r0.iso

To copy the image, you can use SCP, TFTP, or WGET (ftp/http).

scp username@xx.xx.xxx.xxx:/tftpboot/onie-recovery-x86_64-dell_<platform>_c2538-r0.iso .

4 Conrm that the ISO le copied to the SDD over the network.

ONIE:/ # ls -l …

-rw-r--r-- 1 root 0 39780352 Apr 10 11:55 onie-recovery-x86_64-dell_<platform>_c2538-r0.iso …

5 Insert a blank USB in the ONIE target's USB slot. Verify the USB block device using the ONIE logs.

Info: eth0: Checking link... scsi 6:0:0:0: Direct-Access Kingston DataTraveler 2.0 1.00 PQ: 0 ANSI: 4 sd 6:0:0:0: [sdb] 15148608 512-byte logical blocks: (7.75 GB/7.22 GiB) sd 6:0:0:0: [sdb] Write Protect is off sd 6:0:0:0: [sdb] Write cache: disabled, read cache: enabled, doesn't support DPO or FUA sd 6:0:0:0: [sdb] Attached SCSI removable disk

The logs show that the USB device is present: /dev/sdb.

You can also check /sys/block.

ONIE:/ # cd /sys/block/sdb ONIE:/sys/block/sdb # ls -l

-r--r--r-- 1 root 0 4096 Apr 10 13:12 alignment_offset lrwxrwxrwx 1 root 0 0 Apr 10 13:12 bdi -> ../../devices/virtual/bdi/8:16

-r--r--r-- 1 root 0 4096 Apr 10 13:12 capability

-r--r--r-- 1 root 0 4096 Apr 10 13:12 dev lrwxrwxrwx 1 root 0 0 Apr 10 13:12 device -> ../../devices/pci0000:00/0000:00:16.0/ usb1/1-1/1-1.1/1-1.1.1/1-1.1.1:1.0/host6/target6:0:0/6:0:0:0 …

6 Copy the ISO image to the USB using the dd command.

ONIE:/ # dd if=./onie-recovery-x86_64-dell_<platform>_c2538-r0.iso of=/dev/sdb bs=10M 3+1 records in 3+1 records out 39780352 bytes (37.9MB) copied, 6.890503 seconds, 5.5MB/s ONIE:/ #

7 Move the USB from the ONIE target—the system with ONIE—to the USB slot in your switch—the system without ONIE.

8 Turn-on your system and enter the BIOS setup menu by selecting Del when BIOS message is displayed.

If you already powered on your system, reboot the system and enter the BIOS setup menu by selecting Del.

9 In the BIOS Boot menu, select UEFI USB. Select Save and Exit.

ONIE and Dell EMC OS installation instructions

Figure 2. Setup utility

After the system exits the BIOS Boot menu, the system boots with the ONIE USB and presents the following menu:

Figure 3. Embed ONIE menu

10 Select the Embed ONIE option.

This step installs the UEFI ONIE version 3.26.1.1 on system. Any previous installation is removed.

Do not press any key during the Embed ONIE installation.

The following are the Embed ONIE logs:

ONIE: Embedding ONIE ... Platform : x86_64-dell_<platform>_c2538-r0 Version : x.xx.x.x Build Date: 2016-04-26T09:14-0700 [ 4.066378] dummy-irq: no IRQ given. Use irq=N [ 14.296290] esas2r: driver will not be loaded because no ATTO esas2r devices were found

ONIE and Dell EMC OS installation instructions

[ 14.463587] mtdoops: mtd device (mtddev=name/number) must be supplied [ 16.328319] i8042: No controller found [ 16.397853] fmc_write_eeprom fake-design-for-testing-f001: fmc_write_eeprom: no busid passed, refusing all cards [ 16.568122] intel_rapl: driver does not support CPU family 6 model 77 Info: Mounting kernel filesystems... done. Info: Mounting ONIE-BOOT on /mnt/onie-boot ... Info: Using eth0 MAC address: 4c:76:25:f4:7c:80 Info: eth0: Checking link... [ 18.571495] scsi 6:0:0:0: Direct-Access Kingston DataTraveler

2.0 1.00 PQ: 0 ANSI: 4 [ 18.707185] sd 6:0:0:0: Attached scsi generic sg1 type 0 [ 18.707703] sd 6:0:0:0: [sdb] 15148608 512-byte logical blocks: (7.75 GB/7.22 GiB) [ 18.796392] sd 6:0:0:0: [sdb] Write Protect is off [ 18.797033] sd 6:0:0:0: [sdb] Write cache: disabled, read cache: enabled, doesn't support DPO or FUA [ 19.159563] sd 6:0:0:0: [sdb] Attached SCSI removable disk up. Info: Trying DHCPv4 on interface: eth0 ONIE: Using DHCPv4 addr: eth0: 1[ 20.053045] random: dropbearkey urandom read with 94 bits of entropy available x.xx.xxx.xx / xxx.xxx.xxx.x Starting: dropbear ssh daemon... done. Starting: telnetd... done. discover: ONIE embed mode detected. Running updater. Starting: discover... done. Please press Enter to activate this console. Info: eth0: Checking link... up. Info: Trying DHCPv4 on interface: eth0 ONIE: Using DHCPv4 addr: eth0: x.xx.xxx.xx / xxx.xxx.xxx.x ONIE: Starting ONIE Service Discovery Info: Found static url: file:///lib/onie/onie-updater [ 29.744855] random: nonblocking pool is initialized ONIE: Executing installer: file:///lib/onie/onie-updater Verifying image checksum ... OK. Preparing image archive ... OK. ONIE: Version : x.xx.x.x ONIE: Architecture : x86_64 ONIE: Machine : dell_< ONIE: Machine Rev : 0 ONIE: Config Version: 1 Installing ONIE on: /dev/sda /proc/devices: No entry for device-mapper found /proc/devices: No entry for device-mapper found ONIE: Success: Firmware update URL: file:///lib/onie/onie-updater ONIE: Success: Firmware update version: x.xx.x.x ONIE: Rebooting... discover: ONIE embed mode detected. Stopping: discover...start-stop-daemon: warning: killing process 1441: No such process Stopping: dropbear ssh daemon... done. Stopping: telnetd... done.

platform>_c2538

Stopping: syslogd... done. Info: Unmounting kernel filesystems The system is going down NOW! Sent SIGTERM to all processes Sent SIGKILL to all processes Requesting system reboot

After the Embed-ONIE installation completes, the system bootups and presents the ONIE menu.

ONIE and Dell EMC OS installation instructions

Figure 4. ONIE install menu

The system comes up in ONIE Install mode by default, as shown:

ONIE: OS Install Mode ... Version : x.xx.x.x Build Date: 2016-04-26T09:14-0700 ONIE: OS Install Mode ... Version : x.xx.x.x Build Date: 2016-04-26T09:14-0700 [ 4.759116] dummy-irq: no IRQ given. Use irq=N

[ 4.835970] esas2r: driver will not be loaded because no ATTO esas2r devices were found [ 5.003050] mtdoops: mtd device (mtddev=name/number) must be supplied [ 6.867708] i8042: No controller found [ 6.937375] fmc_write_eeprom fake-design-for-testing-f001: fmc_write_eeprom: no busid passed, refusing all cards [ 7.107669] intel_rapl: driver does not support CPU family 6 model 77 Info: Mounting kernel filesystems... done. Info: Mounting ONIE-BOOT on /mnt/onie-boot ... [ 8.018377] random: fsck urandom read with 73 bits of entropy available Info: Mounting EFI System on /boot/efi ... Info: Using eth0 MAC address: 4c:76:25:f4:7c:80 Info: eth0: Checking link... [ 8.902787] scsi 6:0:0:0: Direct-Access Kingston DataTraveler 2.0 1.00 PQ: 0 ANSI: 4 [ 9.038475] sd 6:0:0:0: Attached scsi generic sg1 type 0 [ 9.038993] sd 6:0:0:0: [sdb] 15148608 512-byte logical blocks: (7.75 GB/7.22 GiB) [ 9.253877] sd 6:0:0:0: [sdb] Write Protect is off [ 9.254546] sd 6:0:0:0: [sdb] Write cache: disabled, read cache: enabled, doesn't support DPO or FUA [ 9.492124] sd 6:0:0:0: [sdb] Attached SCSI removable disk up. Info: Trying DHCPv4 on interface: eth0 ONIE: Using DHCPv4 addr: eth0: x.xx.xxx.xx / xxx.xxx.xxx.x Starting: dropbear ssh daemon... done. Starting: telnetd... done. [ 11.789298] random: nonblocking pool is initialized discover: installer mode detected. Running installer. Starting: discover... done. Please press Enter to activate this console. Info: eth0: Checking link... up. Info: Trying DHCPv4 on interface: eth0 ONIE: Using DHCPv4 addr: eth0: x.xx.xxx.xx / xxx.xxx.xxx.x ONIE: Starting ONIE Service Discovery Info: Fetching

ONIE and Dell EMC OS installation instructions

http://xx.xx.xxx.x/onie-installer-x86_64-dell_<platform>_c2538-r0 ... Info: Fetching http://xx.xx.xxx.x/onie-installer-x86_64-dell_<platform>_c2538 ... Info: Fetching http://xx.xx.xxx.x/onie-installer-dell_<platform>_c2538 ... Info: Fetching http://xx.xx.xxx.x/onie-installer-x86_64 ... Info: Fetching http://xx.xx.xxx.x/onie-installer ... Info: Fetching http://xx.xx.xxx.x/onie-installer-x86_64-dell_< Info: Fetching http://xx.xx.xxx.x/onie-installer-x86_64-dell_<platform>_c2538 ...

11 Stop ONIE Discovery mode.

ONIE:/ # onie-discovery-stop The operation has completed successfully. ONIE:/ #

12 Verify the ONIE Linux kernel version and partition layout.

This step veries that you are running the correct kernel in ONIE as the kernel is separate from the ONIE environment.

ONIE:/ # uname -a Linux onie 4.1.28-onie+ #1 SMP Wed Sep 7 14:38:43 PDT 2016 x86_64 GNU/Linux ONIE:/ # sgdisk -p /dev/sda Disk /dev/sda: 31277232 sectors, 14.9 GiB Logical sector size: 512 bytes Disk identifier (GUID): 763E53FF-B894-40FD-B0F9-FBAE2ED4B0B5 Partition table holds up to 128 entries First usable sector is 34, last usable sector is 31277198 Partitions will be aligned on 2048-sector boundaries Total free space is 30490733 sectors (14.5 GiB) Number Start (sector) End (sector) Size Code Name 1 2048 526335 256.0 MiB EF00 EFI System 2 526336 788479 128.0 MiB 3000 ONIE-BOOT ONIE:/ #

13 Verify that efibootmgr runs and displays the valid boot options.

ONIE:/ # efibootmgr BootCurrent: 0000 Timeout: 1 seconds BootOrder: 0000,0006,0001,0003 Boot0000* ONIE: Open Network Install Environment Boot0001* Hard Drive Boot0003* UEFI: Built-in EFI Shell Boot0006* UEFI: KingstonDataTraveler 2.01.00 14

platform>_c2538-r0 ...

ONIE and Dell EMC OS installation instructions

ONIE overview

This chapter describes system diagnostics and troubleshooting. After running the diagnostic tools, your system displays pass or fail test results. If all tests pass, the diagnostic tools exit normally. If a test fails, each diagnostic tool oers a dierent result.

NOTE: The troubleshooting package includes a README le that lists the tools version and the overall troubleshooting package

version. For more information, see this README le.

NOTE: To download the Release Notes, go to www.dell.com/support.

This system uses the power-on self test (POST) diagnostic tool that automatically runs during the system power-on at the BIOS level. This tool tests for catastrophic hardware failures that prevent booting the system. The error code is saved in CMOS for the next boot. There is no physical alarm indication.

ONIE expansion

To view all the ONIE commands available, from the ONIE prompt, enter onie- and click <tab> twice.

ONIE:/ # onie- <TAB><TAB> onie-boot-mode onie-fwpkg onie-syseeprom onie-console onie-nos-install onie-sysinfo onie-discovery-start onie-self-update onie-uninstaller onie-discovery-stop onie-support

Topics:

• Boot processes

• View system information

Boot processes

After the BIOS, POST runs to verify the devices required to boot to ONIE GRUB.

POST

POST diagnostics verify the system DRAM, DIMM, SPD, memory, RTC/NVRAM, and PCI devices. Test conguration parameters and test results are saved in NVRAM.

Capture support data from ONIE

1 Capture support data to the screen.

ONIE:/ # dmesg

2 Capture support data to the onie-support.tar.bz2 gzip le.

ONIE-support creates the support le. To store the le, enter the location; for example, ONIE:/# onie-support/tmp.

ONIE:/ # onie-support <output_directory>

16 ONIE overview

The ONIE support le includes the following:

• kernel_cmdline

• runtime-export-env

• runtime-process

• runtime-set-env

• log/messages

• log/onie.log

Output example

Success: Support tarball created: /tmp/onie-support.tar.bz2

Change default grub boot entry

To view or set the default Boot mode, the onie-boot-mode command has two options —l, the default, and —o. The Grub boot default shows the current default entry.

View or set the default Grub boot entry.

ONIE:/ # onie-boot-mode [-o <onie_mode>]

The -o command options include:

• install—ONIE OS Installer mode

• rescue—ONIE Rescue mode

• uninstall—ONIE OS Uninstall mode

• update—ONIE Self-Update mode

• embed—ONIE Self-Update mode and Embed ONIE

• none—Uses System Default Boot mode. This mode uses the rst ONIE boot menu entry.

The -l command option lists the current default entry—this is the default setting.

View system information

To view your system information; for example, the model, part number, serial number, and service tag, use the following commands:

1 Boot into ONIE.

2 Enter the onie-syseeprom command.

ONIE:/ # onie-syseeprom TlvInfo Header: Id String: TlvInfo Version: 1 Total Length: 162 TLV Name Code Len Value

-------------------- ---- --- ----Part Number 0x22 6 0W1K08 Serial Number 0x23 20 CN0W1K08779316470002 Product Name 0x21 8 < Device Version 0x26 1 0 Label Revision 0x27 3 X00 Manufacture Date 0x25 19 04/08/2016 08:43:05 Manufacturer 0x2B 5 77931 Country Code 0x2C 2 CN Vendor Extension 0xFD 1 0x00 MAC Addresses 0x2A 2 256

platform>

ONIE overview

Service Tag 0x2F 7 2WCSG02 Vendor Name 0x2D 4 DELL Diag Version 0x2E 6 01_010 Base MAC Address 0x24 6 34:17:EB:05:B4:00 Platform Name 0x28 26 x86_64-dell_<platform>_c2538-r0 ONIE Version 0x29 8 x.xx.x.x CRC-32 0xFE 4 0x99415608 Checksum is valid. ONIE:/ #

Enter the onie-sysinfo –a command.

ONIE:/ # onie-sysinfo -a CN0W1K08779316470002 0W1K08 34:17:EB:05:B4:00 3.28.1.2 674 dell_<platform>_c2538 0 x86_64dell_<platform>_c2538-r0 x86_64 1 gpt 2016-09-21T10:01-0700 bcm ONIE:/ #

18 ONIE overview

Dell EMC DIAG OS

These sections describe the Dell EMC diagnostics. These instructions apply to systems where ONIE diagnostics are not available.

Topics:

• Diagnostic package download

• View DIAG versions

• View CPLD versions

• Install or upgrade DIAG tools

• Restore factory defaults

Diagnostic package download

Load or update the DIAG-OS—the diag installer image—using the onie-nos-install command. The DIAG-OS installer runs in two modes: Update mode or Install mode.

• In Update mode, the DIAG-OS updates the existing DIAG-OS and boots back to ONIE.

• In Install mode, the DIAG-OS erases the existing DIAG-OS and loads the new DIAG-OS.

: If you have a recovery USB plugged into your system, remove it before installing the DIAG-OS using the onie-nos-

NOTE

install command.

NOTE: Before you begin, go to www.dell.com/support and download the diagnostic package.

1 Enter the onie-discovery-stop command to stop ONIE Discovery mode.

2 Assign an IP address to the management interface and verify the network connectivity.

ONIE:/ # ifconfig eth0 xx.xx.xx.xx netmask xxx.xxx.x.x up ONIE:/ # ifconfig eth0 Link encap:Ethernet HWaddr 34:17:EB:05:B4:00 inet addr:xx.xx.xx.xx Bcast:xx.xx.xxx.xxx Mask:xxx.xxx.x.x inet6 addr: fe80::3617:ebff:fe05:b400/64 Scope:Link UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:43 errors:0 dropped:0 overruns:0 frame:0 TX packets:31 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:5118 (4.9 KiB) TX bytes:7104 (6.9 KiB) Memory:dff40000-dff5ffff

3 Upgrade the DIAG Installer.

Again, boot to ONIE Rescue mode and install the onie diag installer.

: In Install mode, the DIAG-OS installation removes any existing NOS and DIAG-OS partition. If you do not create

NOTE

file /tmp/diag_os_install_mode, the DIAG-OS installs in Upgrade mode. In this case, the installation process does NOT touch any existing NOS.

ONIE:/ onie-nos-install tftp://<tftp-server ip>/<filepath>/filename/diag-install er-x86_64-dell_<platform>_c2538-r0-2016-08-12.bin discover: installer mode detected. Stopping: discover... done. Info: Fetching tftp://<tftp-server ip>/users/<

user>/<platform>/diag-installer-x86_64-

Dell EMC DIAG OS 19

dell_<platform>_c2538-r0-2016-08-12.bin ... users/<user>/<platform> 100% |*******************************| 154M 0:00:00 ETA ONIE: Executing installer: tftp://<tftp-server ip>/users/<user>/<platform>/diag-installerx86_64-dell_<platform>_c2538-r0-2016-08-12.bin Ignoring Verifying image checksum ... OK. cur_dir / archive_path /var/tmp/installer tmp_dir /tmp/tmp.qlnVIY Preparing image archive ...sed -e '1,/^exit_marker$/d' /var/tmp/installer | tar xf - OK. Diag-OS Installer: platform: x86_64-dell_<

EDA-DIAG Partiton not found. Diag OS Installer Mode : INSTALL

Creating new diag-os partition /dev/sda3 ... Warning: The kernel is still using the old partition table. The new table will be used at the next reboot. The operation has completed successfully.

EDA-DIAG dev is /dev/sda3 mke2fs 1.42.13 (17-May-2015) Creating filesystem with 262144 4k blocks and 65536 inodes Filesystem UUID: 63fc156f-b6c1-415d-9676-ae4478704c5a Superblock backups stored on blocks: 32768, 98304, 163840, 229376

Allocating group tables: done Writing inode tables: done Creating journal (8192 blocks): done Writing superblocks and filesystem accounting information: done

Created filesystem on /dev/sda3 with label EDA-DIAG

platform>_c2538-r0

Mounted /dev/sda3 on /tmp/tmp.BBEygm

Preparing /dev/sda3 EDA-DIAG for rootfs install untaring into /tmp/tmp.BBEygm

rootfs copy done Success: Support tarball created: /tmp/tmp.BBEygm/onie-support.tar.bz2

Updating Grub Cfg /dev/sda3 EDA-DIAG

ONIE uefi_uuid 69AD-9CBF

INSTALLER DONE... Removing /tmp/tmp.qlnVIY ONIE: NOS install successful: tftp://<tftp-server ip>/users/< x86_64-dell_<platform>_c2538-r0-2016-08-12.bin ONIE: Rebooting... ONIE:/ # discover: installer mode detected. Stopping: discover...start-stop-daemon: warning: killing process 2605: No such process done. Stopping: dropbear ssh daemon... done. Stopping: telnetd... done. Stopping: syslogd... done. Info: Unmounting kernel filesystems umount: can't umount /: Invalid argument The system is going down NOW! Sent SIGTERM to all processes Sent SIGKILL tosd 4:0:0:0: [sda] Synchronizing SCSI cache reboot: Restarting system reboot: machine restart

user>/<platform>/diag-installer-

BIOS Boot Selector for < Primary BIOS Version x.xx.x.x_MRC48

Dell EMC DIAG OS

platform>

SMF Version: MSS 1.3.1, FPGA 0.3 Last POR=0x11, Reset Cause=0x55

POST Configuration CPU Signature 406D8 CPU FamilyID=6, Model=4D, SteppingId=8, Processor=0 Microcode Revision 125 Platform ID: 0x10041A43 PMG_CST_CFG_CTL: 0x40006 BBL_CR_CTL3: 0x7E2801FF Misc EN: 0x840081 Gen PM Con1: 0x203808 Therm Status: 0x884C0000 POST Control=0xEA000100, Status=0xE6000000

BIOS initializations...

CPGC Memtest ................................ PASS

Booting `EDA-DIAG'

Loading DIAG-OS ... [ 3.786758] dummy-irq: no IRQ given. Use irq=N [ 3.792812] esas2r: driver will not be loaded because no ATTO esas2r devices were found [ 3.818171] mtdoops: mtd device (mtddev=name/number) must be supplied [ 4.880285] i8042: No controller found [ 4.890134] fmc_write_eeprom fake-design-for-testing-f001: fmc_write_eeprom: no busid passed, refusing all cards [ 4.901699] intel_rapl: driver does not support CPU family 6 model 77

Debian GNU/Linux 8 dell-diag-os ttyS1

dell-diag-os login: root Password: Linux dell-diag-os 3.15.10 #1 SMP Fri Aug 12 05:14:52 PDT 2016 x86_64

The programs included with the Debian GNU/Linux system are free software; the exact distribution terms for each program are described in the individual files in /usr/share/doc/*/copyright.

Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent permitted by applicable law. Diag OS version < Build date/time Fri Aug 12 05:23:56 PDT 2016 Build server netlogin-eqx-03 Build by <name> Kernel Info: Linux 3.15.10 #1 SMP Fri Aug 12 05:14:52 PDT 2016 x86_64 GNU/Linux Debian GNU/Linux 8 \n \l

Done Initializing Ethernet root@dell-diag-os:~# root@dell-diag-os:~# root@dell-diag-os:~# root@dell-diag-os:~# root@dell-diag-os:~# root@dell-diag-os:~#

4 Start diagnostics.

To start the ONIE diagnostics, use the DIAG-OS option from the GRUB menu.

platform>_DIAG_OS_x.xx.x.x

Dell EMC DIAG OS

a Boot into the DIAG OS. b Log in as root.

Password: calvin.

c Install the EDA-DIAG tools package. d Run /opt/dellemc/diag/bin/edatool.

NOTE: To return to your networking operating software, enter the reboot command.

Diagnostic test suite

After the system boots up, select the EDA-DIAG option to run the diagnostic test suite.

GNU GRUB version 2.02~beta2+e4a1fe391

View DIAG versions

To display the DIAG version installed in the DIAG OS, use the dpkg -l | grep dn-diags command at the root@dell-diag-os:~ prompt.

root@dellemc-diag-os:~# dpkg -l | grep dn-diags ii dn-diags-<platform>-on.deb 3.xx.4.1-x amd64 Dell Networking Diagnostics

View CPLD versions

To view CPLD data, including the fan status, PSU status, current programmed version, and image packed version, use the cpldupgradetool or updatetool command at the prompt.

• For the cpldupgradetool command:

root@dell-diag-os:/# cpldupgradetool --cpldver CPLD1 Version 0x00 CPLD2 Version 0x01 CPLD3 Version 0x01 CPLD4 Version 0x01 root@dell-diag-os:/#

• For the updatetool command:

root@dellemc-diag-od~#updatetool --device_version --dev=CPU_CPLD CPU_CPLD version: System CPLD Version : offset 0x00 = 0xc 7: 4 Major Revision = 0 3: 0 Minor Revision = c Scratch Register : offset 0x01 = 0x0

Dell EMC DIAG OS

Install or upgrade DIAG tools

To install or upgrade the DIAGs in the DIAGs OS, use the dpkg --install dn-diags-<platform>-DiagOS-<version>- <date>.deb command.

root@dell-diag-os:~#dpkg --install dn-diags-<platform>-DiagOS-<version>-<date>.de Selecting previously unselected package dn-diags-<platform>.deb. (Reading database ... 18873 files and directories currently installed.) Preparing to unpack dn-diags-< Unpacking dn-diags-<platform>.deb (1.10) ... Setting up dn-diags-< root@dell-diag-os:~#

platform>.deb (1.10) ...

platform>-DiagOS-<version>-<date>.deb ...

Restore factory defaults

To restore your system factory defaults, reboot the system to ONIE: Uninstall OS mode.

If it is not possible to restore your factory defaults with the installed OS, reboot the system from the Grub menu and select ONIE: Rescue. ONIE Rescue bypasses the installed OS and boots the system into ONIE until you reboot the system. After ONIE Rescue completes, the system resets and boots to the ONIE console.

CAUTION: Restoring factory defaults erases any installed OS and requires a long time to erase storage.

1 Restore the factory defaults on your system from the Grub menu using the ONIE: Uninstall OS command.

To select which entry is highlighted, use the up and down arrow keys.

GNU GRUB version 2.02~beta2+e4a1fe391

2 Press ENTER to activate the console.

3 Return to the default ONIE settings using the onie-uninstaller command.

ONIE:/ # onie-uninstaller Erasing internal mass storage device: /dev/sda4 (32MB) Percent complete: 100% Erase complete. Deleting partition 4 from /dev/sda Erasing internal mass storage device: /dev/sda5 (300MB) Percent complete: 100% Erase complete. Deleting partition 5 from /dev/sda Erasing internal mass storage device: /dev/sda6 (300MB) Percent complete: 100% Erase complete. Deleting partition 6 from /dev/sda Erasing internal mass storage device: /dev/sda7 (12461MB) Percent complete: 100% Erase complete. Deleting partition 7 from /dev/sda Installing for i386-pc platform. Installation finished. No error reported. Uninstall complete. Rebooting...

Dell EMC DIAG OS

ONIE:/ # discover: Rescue mode detected. No discover stopped. Stopping: dropbear ssh daemon... done. Stopping: telnetd... done. Stopping: syslogd... done. Info: Unmounting kernel filesystems The system is going down NOW! Sent SIGTERM to all processes Sent SIGKILL tosd 4:0:0:0: [sda] Synchronizing SCSI cache Restarting system. machine restart

24 Dell EMC DIAG OS

Dell EMC DAIG-OS tools

This section describes how to use the Dell EMC diagnostics operating system (DIAG-OS). The DIAG-OS provides a suite of tools to help diagnose issues seen on the system, or to run a health check to ensure that the hardware is operating properly.

Diagnostic tools

The DIAG-OS uses standard Linux drivers and contains the following tools you can use to evaluate the health of your system. The tools are packaged for both the DIAG-OS, which is a simple OS of the same kernel version, and small rootfs to support the tools and drivers.

NOTE: By default, the system’s I/O modules are down. Power up the I/O modules or the Opticstool and NPUtool reports failures.

For information about how to power up the I/O modules, see the

support.

Topics:

• edatool

• cpldupgradetool

• cputool

• eepromtool

• ethtool

• fantool

• ashrom

• gpiotool

• i2ctool

• ledtool

• lpctool

• memtool

• nputool

• nvramtool

• opticstool

• pcitool

• phytool

• pltool

• psutool

• rtctool

• smartctl

• smarttool

• smbiostool

• storagetool

• temptool

• updatetool

• vmetool

Dell EMC Installation Guide

for your system at www.dell.com/

Dell EMC DAIG-OS tools 25

• Diagnostic package

edatool

The diagnostics tools include edatool. To test the basic functionality of the system, use the edatool.

The edatool executes a script of simple commands, similar to commands in the CLI. Usually, the diagnostics tools run these types of tests. The success or failure of these tools is reported. At the end of the edatool run, reports the PASSED or FAILED results in a standard format the test scripts can easily parse.

Tests

The edatool does not have a test command, but instead runs all the tests that are scripted.

CLI options

DellEmc Diag - Extended Diagnostics Application version 1.4, x.xx.x.x-x build, 2017/05/23,

Syntax: edatool <option> Show the Help-text:= edatool --h (or) edatool -h Lists tests in config files:= edatool --list (or) edatool -l Config file to use for tests:= edatool --config=<config_file> (or) edatool -f <config_file> Config file to use for extended tests:= edatool --extended-config=<config_file> (or) edatool -X <config_file> Display test list or test result or modify test item status:= edatool --testlist=show/result/<on/off,<test_id>,<test_id>...>(or) edatool -L show/result/<on/off,<test_id>,<test_id>...> Run all or selected test item in test list:= edatool --testrun=all/<test_id> (or) edatool --R all/<test_id> Execute repeatedly command by count:= edatool --iteration=max/<count> [option1] [option2]... (or) edatool -I max/<count> [option1] [option2]...

Usage:=

-h, --h Show the help text

-l, --list List the understood TLV codes and names

-I, --iteration= Iteration command execution

-L, --testlist= Test list status

-R, --testrun= Run test item

-f, --config= To specify the location of the config file e.g. /etc/dn/diag/

<file_name>

-X, --extended-config= Config file to use for extended tests

Output

root@dell-diag-os:~# edatool ***************************** * Diagnostics Application * ***************************** Dell-EMC Diag edatool version 1.4, package x.xx.x.x 2016/11/21

Dell EMC DAIG-OS tools

+ 60 hidden pages