Skip to main content
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.

Dell SmartFabric OS10 Installation, Upgrade, and Downgrade Guide

PDF

Perform an OS10 upgrade

After you download and unpack a new OS10 binary image as described in Download OS10 image for upgrade, follow these steps:

NOTE:
  • Use the image download command to download the software image to the system—it does not install the software on your device. The image install command installs the downloaded image, which becomes the standby image.
  • If the active image includes any modified text files or custom packages that were installed earlier, they are not available with the standby image. Back up the modified files and custom packages and reinstall them after downloading the image.
  • Configuring VLAN with uppercase V through the CLI is supported starting from Release 10.5.1.0. However, until Release 10.5.4.x, the system accepted configurations in the startup.xml file with the uppercase 'V' in VLAN. From Release 10.5.5.x onwards, configurations with uppercase 'V' in VLAN within startup.xml are no longer allowed. Dell Technologies recommends that any configurations containing VLAN with an uppercase 'V' be rectified either in the configuration or in the startup.xml file before upgrading to Release 10.5.5.x or later versions. Failure to address this issue may result in OS10 failing to load the configuration, causing the system to boot with the default configuration until the erroneous configuration is removed. In the event of an error in the startup.xml file, upon booting with the default configuration, the system saves the last snapshot as startup.xml.last.
CAUTION: Do not use copy commands to download the image to the switch, as this action may result in loss of disk space for critical system applications and functions, and it may be difficult to locate the image.
  1. Back up the current running configuration to the startup configuration in EXEC mode. Alternatively, use the write memory command to copy the current running configuration to the startup configuration.
    OS10# copy running-configuration startup-configuration
  2. Back up the startup configuration in EXEC mode.
    OS10# copy config://startup.xml config://<backup file name>
  3. Enter the system "file /mnt/onie-boot/onie/vmlinuz*" command from the OS10 CLI to check the version of the ONIE Linux kernel.
    OS10# system "file /mnt/onie-boot/onie/vmlinuz*"
    /mnt/onie-boot/onie/vmlinuz-3.14.27-onie: Linux kernel x86 boot executable bzImage, version 3.14.27-onie+ 
    (root@arlogin-sjc-01.force10networks.com) #1 SMP Thu Feb 19 17:09:11 PST 2015, RO-rootFS, swap_dev 0x3, Normal VGA

    If the ONIE Linux kernel version is:

    • 3.x.x—See the ONIE Firmware Updater Release Notes for the latest recommended ONIE and ONIE firmware versions and update them. See Appendix A for a list of links to the ONIE Firmware Updater Release Notes for the different platforms.
    • 4.x.x—Proceed with OS10 upgrade.
  4. Download the new software image from the Dell Support Site, extract the bin files from the tar file, and save the file in EXEC mode.
    OS10# image download file-url
    For example:
    OS10# image download scp://userid:passwd@hostip:/filepath
    NOTE:Some Windows extraction applications insert extra carriage returns (CR) or line feeds (LF) when they extract the contents of a .tar file, which may corrupt the downloaded OS10 binary image. Turn off this option if you use a Windows-based tool to untar an OS10 binary file.
  5. (Optional) View the current software download status in EXEC mode.
    OS10# show image status
  6. (Applicable only if you are presently running OS10 release 10.5.0.x or earlier and installing 10.5.2.0 or later now.) Cancel any staged firmware update using the image cancel command.
    OS10# image cancel
  7. Install the 10.5.2.6 or later software image in EXEC mode.
    OS10# image install image-url
    For example:
    OS10# image install image://filename.bin
    In Release 10.5.5.0P1 or later, you can specify the OS10 image in .exe format on the supported platforms:
    OS10# image install image://filename.exe
    NOTE:OS10 has two images: A and B. One image is active, which is the present running version and used as the running software at the next system reload. The other image remains standby, used for software upgrades.

    The image install command installs the downloaded image to the system. If you had modified text files or installed custom packages, they are not available with the standby image. Back up the modified files and custom packages, and reinstall them after downloading the standby image.

  8. (Optional) View the status of the current software install in EXEC mode.
    OS10# show image status
  9. (Optional) Verify the standby image version.
    OS10# show boot detail
    Current system image information detail:
    ==========================================
    Type: Node-id 1
    Boot Type: Flash Boot
    Active Partition: B
    Active SW Version: 10.5.0.9
    Active SW Build Version: 10.5.0.270
    Active Kernel Version: Linux 4.9.168
    Active Build Date/Time: 2023-02-07T23:35:01Z
    Standby Partition: A
    Standby SW Version: 10.5.5.0P1
    Standby SW Build Version: 10.5.5.0P1
    Standby Build Date/Time: 2023-02-07T11:43:33+0000
    Next-Boot: standby[A]
    NOTE: Use the show boot detail command to check 
  10. Depending on the release that is presently running on your system:
    • System is presently running an OS10 release earlier than 10.5.1.0 and you are installing 10.5.1.9 or later: Reload the new software image in EXEC mode.
      OS10# reload
    • System is presently running OS10 release 10.5.1.0 or later and you are installing 10.5.2.6 or later now:
      1. Change the next boot image to the standby image in EXEC mode.
        OS10# boot system standby
        Check whether the next boot has changed to the standby image in EXEC mode.
        OS10# show boot detail
      2. Reload the new software image in EXEC mode.
        OS10# reload
        NOTE:The OS10 switch boots with the image that you chose.
  11. After the installation is complete, use the show version command to check if the latest version of the software is running in the system. The following example shows the 10.5.5.0P1 software installed and running:
    OS10# show version
    Dell SmartFabric OS10 Enterprise
    Copyright (c) 1999-2023 by Dell Inc. All Rights Reserved.
    OS Version: 10.5.5.0P1
    Build Version: 10.5.5.0P1.228
    Build Time: 2023-02-07T11:43:33+0000
    System Type: S5232F-ON
    Architecture: x86_64
    Up Time: 01:28:47
    OS10#  
    
NOTE:Starting from Release 10.5.1.0, SmartFabric OS10 comes with a unified partition. If you have upgraded from an earlier release to 10.5.1.9 or later, the show boot detail command output appears as follows:
OS10# show boot detail
Image A: 10.5.5.0P1
Image B: N/A

Image B is listed as N/A. However, Image B (older version) resides in the system and is used when you roll back to the previous release.

If you want to update the standby partition with the current OS10 image, use the copy active-to-standby command:

OS10# image copy active-to-standby

This action removes the older version from the standby partition of the system. You can no longer roll back to the previous release. If you want to downgrade, you must follow the instructions provided in the Downgrade to OS10 release 10.5.0.9 or earlier section.


Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\