Downloading and Managing Firmware in Cisco UCS Manager

This chapter includes the following sections:

Obtaining M-Series Software Bundles from Cisco

The Cisco UCS M-Series Modular Server Software Bundle contains firmware for M-Series chassis and cartridge components.

Procedure
    Step 1   In a web browser, navigate to Cisco.com.
    Step 2   Under Support, click All Downloads.
    Step 3   In the center pane, click Servers - Unified Computing.
    Step 4   If prompted, enter your Cisco.com username and password to log in.
    Step 5   In the right pane, click the link for the software bundles you require, as follows:
    Bundle Navigation Path

    Cisco UCS M-Series Modular Server Software Bundle

    Click Cisco UCS M-Series Modular Server Software > Unified Computing System (UCS) Server Software Bundle.

    Tip   

    The Unified Computing System (UCS) Documentation Roadmap Bundle, which is accessible through these paths, is a downloadable ISO image of all Cisco UCS documentation.

    Step 6   On the first page from which you download a software bundle, click the Release Notes link to download the latest version of the Release Notes.
    Step 7   For each software bundle that you want to download, do the following:
    1. Click the link for the software release bundle.

      The release number is followed by a number and a letter in parentheses. The number identifies the maintenance release level, and the letter differentiates between patches of that maintenance release. For more information about what is in each maintenance release and patch, see the latest version of the Release Notes.

    2. Click one of the following buttons and follow the instructions provided:

      • Download Now—Allows you to download the software bundle immediately.

      • Add to Cart—Adds the software bundle to your cart to be downloaded at a later time.

    3. Follow the prompts to complete your download of the software bundle(s).
    Step 8   Read the Release Notes before upgrading your Cisco UCS domain.
    What to Do Next

    Download the software bundles to the fabric interconnect.

    Downloading M-Series Firmware Images to the Fabric Interconnect from a Remote Location


    Note

    In a cluster setup, the image file for the firmware bundle is downloaded to both fabric interconnects, regardless of which fabric interconnect is used to initiate the download. Cisco UCS Manager maintains all firmware packages and images in both fabric interconnects in sync. If one fabric interconnect is down, the download finishes successfully. The images are synced to the other fabric interconnect when it comes back online.

    Before You Begin

    Obtain the required firmware bundles from Cisco.

    Procedure
       Command or ActionPurpose
      Step 1UCS-A# scope firmware  

      Enters firmware mode.

       
      Step 2UCS-A /firmware # download image URL  
      Downloads the firmware bundle. Using the download path provided by Cisco, specify the URL with one of the following syntax:

      • ftp:// server-ip-addr / path

      • scp:// username@server-ip-addr / path

      • sftp:// username@server-ip-addr / path

      • tftp:// server-ip-addr : port-num / path

      Note   

      TFTP has a file size limitation of 32 MB. Because firmware bundles can be much larger than that, we recommend that you do not select TFTP for firmware downloads.

      If you use a hostname rather than an IP address, configure a DNS server in Cisco UCS Manager.

       
      Step 3Enter the password for the remote server.  

      The password for the remote server username. This field does not apply if the protocol is tftp.

       
      Step 4UCS-A /firmware # show download-task  

      Displays the status for your download task. When your image is completely downloaded, the task state changes from Downloading to Downloaded. The CLI does not automatically refresh, so you may have to enter the show download-task command multiple times until the task state displays Downloaded.

       
      Step 5Repeat this task until all of the firmware bundles have been downloaded to the fabric interconnect.    

      The following example uses SCP to download the firmware package. 

      UCS-A# scope firmware
UCS-A /firmware # download image scp://user1@192.168.10.10/images/ucs-k9-bundle-m-series.2.5.0.224.M.bin
UCS-A /firmware # show download-task
UCS-A /firmware #
      What to Do Next

      After the image file for the firmware bundles downloaded completes, update the firmware on the endpoints.

      Displaying the Firmware Package Download Status

      After a firmware download operation has been started, you can check the download status to see if the package is still downloading or if it has completely downloaded.

      Procedure
         Command or ActionPurpose
        Step 1UCS-A# scope firmware  

        Enters firmware mode.

         
        Step 2UCS-A /firmware # show download-task  

        Displays the status for your download task. When your image is completely downloaded, the task state changes from Downloading to Downloaded. The CLI does not automatically refresh, so you may have to enter the show download-task command multiple times until the task state displays Downloaded.

         

        The following example displays the download status for the firmware package. The show download-task command is entered multiple times until the download state indicates that the firmware package has been downloaded: 

        UCS-A# scope firmware
UCS-A /firmware # show download-task

Download task:
File Name 																																				Protocol     Server          Userid      State
--------- 																												 							--------			  --------------- ---------		 -----
ucs-k9-bundle-m-series.2.5.0.224.M.bin						 	Scp      				10.193.32.11    user1       Downloading

UCS-A /firmware # show download-task

Download task:
File Name 																																				Protocol     Server          Userid      State
--------- 																																			 --------			  --------------- ---------			-----
ucs-k9-bundle-m-series.2.5.0.224.M.bin 	      Scp      				10.193.32.11    user1       Downloaded

        Canceling an Image Download

        You can cancel the download task for an image only while it is in progress. After the image has downloaded, deleting the download task does not delete the image that was downloaded. You cannot cancel the FSM related to the image download task.

        Procedure
           Command or ActionPurpose
          Step 1 UCS-A# scope firmware  

          Enters firmware mode.

           
          Step 2 UCS-A /firmware # delete download-task image_filename  

          Deletes the specified image file.

           
          Step 3 UCS-A /firmware # commit-buffer  

          Commits the transaction to the system configuration.

           
          The following example cancels an image download: 
          UCS-A# scope firmware
UCS-A /firmware # delete download-task ucs-k9-bundle-m-series.2.5.0.202.M.bin
UCS-A /firmware* # commit-buffer
UCS-A /firmware* #

          Displaying All Available Software Images on the Fabric Interconnect

          This procedure is optional and displays the available software images on the fabric interconnect for all endpoints. You can also use the show image command in each endpoint mode to display the available software images for that endpoint.

          Procedure
             Command or ActionPurpose
            Step 1UCS-A# scope firmware  

            Enters firmware mode.

             
            Step 2UCS-A /firmware # show image  

            Displays all software images downloaded onto the fabric interconnect.

            Note   

            You must provide the software version number when directly updating an endpoint. If you intend to directly update firmware at an endpoint, note its version number in the right column.

             

            The following example displays all available software images on the fabric interconnect: 

            UCS-A# scope firmware
UCS-A /firmware # show image
Name                                          Type                 Version
--------------------------------------------- -------------------- -------
ucs-4308-brdprog.1.0.6.bin                    Board Controller     1.0.6
ucs-4308.2.0.2.45.bin                         Chassis Management Controller   
                                                                   2.0(2.45)
ucs-6100-k9-kickstart.5.2.3.N2.2.50.225.bin   Fabric Interconnect Kernel      
                                                                   5.2(3)N2(2.50.225)
ucs-6100-k9-system.5.2.3.N2.2.50.225.bin      Fabric Interconnect System      
                                                                   5.2(3)N2(2.50.225)
ucsme-142-m4-bios.UCSME.142M4.2.0.100.54.011620150100.bin             
                                              Server BIOS          UCSME.142M4.2.0.100.54.011620150100
ucsme-142-m4-k9-cimc.2.0.100.59.bin           CIMC                 2.0(100.59)

            Displaying All Available Packages on the Fabric Interconnect

            This procedure is optional and displays the available software packages on the fabric interconnect for all endpoints.. You can also use the show package command in each endpoint mode to display the available software images for that endpoint.

            Procedure
               Command or ActionPurpose
              Step 1UCS-A# scope firmware  

              Enters firmware mode.

               
              Step 2UCS-A /firmware # show package  

              Displays all software packages downloaded onto the fabric interconnect.

              Note   

              You must provide the software version number when directly updating an endpoint. If you intend to directly update firmware at an endpoint, note its version number in the right column.

               

              The following example displays all available software packages on the fabric interconnect: 

              UCS-A# scope firmware
UCS-A /firmware # show package

              Determining the Contents of a Firmware Package

              Procedure
                 Command or ActionPurpose
                Step 1 UCS-A# scope firmware  

                Enters firmware mode.

                 
                Step 2 UCS-A /firmware # show package package-name expand  

                Displays the contents of the specified firmware package.

                 
                The following example displays the contents of a firmware package: 
                UCS-A# scope firmware
UCS-A /firmware # show package ucs-k9-bundle-m-series.2.5.0.224.M.bin expand
Package ucs-k9-bundle-m-series.2.5.0.224.M.bin:

  Images:
      ucs-4308-brdprog.1.0.6.bin
      ucs-4308.2.0.2.45.bin
      ucs-m-lsi-mrsas-9361-8i.24.5.1.9.bin
      ucs-m83-8p40-vic.4.0.2S47.bin
      ucsme-142-m4-bios.UCSME.142M4.2.0.100.54.011620150100.bin
      ucsme-142-m4-k9-cimc.2.0.100.59.bin

UCS-A /firmware #

                Checking the Available Space on a Fabric Interconnect

                If an image download fails, check whether the bootflash on the fabric interconnect or fabric interconnects in the Cisco UCS has sufficient available space.

                Procedure
                   Command or ActionPurpose
                  Step 1 UCS-A# scope fabric-interconnect {a | b}  

                  Enters fabric interconnect mode for the specified fabric.

                   
                  Step 2 UCS-A /fabric-interconnect # show storage [detail | expand}  

                  Displays the available space for the specified fabric.

                  Note   

                  When you download a firmware image bundle, a fabric interconnect needs at least twice as much available space as the size of the firmware image bundle. If the bootflash does not have sufficient space, delete the obsolete firmware, core files, and other unneeded objects from the fabric interconnect.

                   

                  The following example displays the available space for a fabric interconnect: 

                  UCS-A# scope fabric-interconnect a
UCS-A /fabric-interconnect # show storage
Storage on local flash drive of fabric interconnect:
    Partition        Size (MBytes)    Used Percentage
    ---------------- ---------------- ---------------
    bootflash        8658             50
    opt              1917             2
    workspace        277              4
UCS-A /fabric-interconnect #

                  Deleting Firmware Packages from a Fabric Interconnect

                  Use this procedure if you want to delete an entire package. If you prefer, you can also delete only a single image from a package.

                  Procedure
                     Command or ActionPurpose
                    Step 1 UCS-A# scope firmware  

                    Enters firmware mode.

                     
                    Step 2 UCS-A /firmware # delete package package-name  

                    Deletes the specified firmware package.

                     
                    Step 3 UCS-A /firmware # commit-buffer  

                    Commits the transaction to the system configuration.

                     

                    Cisco UCS Manager deletes the selected package or packages and all images contained within each package.

                    The following example deletes a firmware package and commits the transaction: 
                    UCS-A# scope firmware
UCS-A /firmware # delete package ucs-k9-bundle-infra.2.5.0.224.A.bin
UCS-A /firmware* # commit-buffer
UCS-A /firmware #

                    Deleting Firmware Images from a Fabric Interconnect

                    Use this procedure if you want to delete only a single image from a package.

                    Procedure
                       Command or ActionPurpose
                      Step 1 UCS-A# scope firmware  

                      Enters firmware mode.

                       
                      Step 2 UCS-A /firmware # delete image image-name  

                      Deletes the specified firmware image.

                       
                      Step 3 UCS-A /firmware # commit-buffer  

                      Commits the transaction to the system configuration.

                       
                      The following example deletes a firmware image and commits the transaction: 
                      UCS-A# scope firmware
UCS-A /firmware # delete image ucs-m-lsi-mrsas-9361-8i.24.5.1.8.bin
UCS-A /firmware* # commit-buffer
UCS-A /firmware #