Go to main content

Oracle® Flash Accelerator F320 PCIe Card and Oracle 3.2 TB NVMe SSD Product Notes Release 1.3

Exit Print View

Updated: December 2017
 
 

Update the NVMe Storage Drive Firmware

This topic provides instructions to update Oracle 3.2 TB NVMe SSD NAND flash controller firmware for the host for supported Oracle Solaris and Oracle Linux operating systems. Oracle 3.2 TB NVMe SSD firmware is updated as a single package using Oracle Hardware Management Pack utility CLI tools.


Note -  Refer to the server documentation for detailed instructions.

Before You Begin

  • Update your system to the latest software release.

  • Verify that the latest supported software release of Oracle Hardware Management Pack is installed on the host.

    Refer to the Oracle Hardware Management Pack documentation for instructions at: http://www.oracle.com/goto/ohmp/docs.

  1. Check the Product Notes for the latest firmware requirements at

    Minimum Supported Oracle 3.2 TB NVMe SSD Firmware Version

  2. Log into the target system through SSH or through Oracle ILOM Remote System Console.

    Refer to the server installation guide.

  3. Download and store any firmware image file updates on the server that are required to support the Oracle 3.2 TB NVMe SSD.
    1. Download firmware image files from this location:

      https://support.oracle.com

      See Downloading the SSD Software Package.

    2. Copy the firmware image files obtained to the target system root directory.
  4. Identify all Oracle 3.2 TB NVMe SSDs and controller firmware versions in the server using either Oracle Hardware Management Pack command in the examples below.
    1. To identify all 3.2 TB NVMe SSD NVMe controllers and current firmware versions in the system, type:

      # fwupdate list controller

      In the following examples, 3.2 TB NVMe SSD controllers c0 to c1 are enumerated in the output returned by the above command.

      # fwupdate list controller
      
      ==================================================
      CONTROLLER
      ==================================================
      ID    Type   Manufacturer   Model     Product Name              FW Version     BIOS Version   EFI Version    FCODE Version  Package Version  NVDATA Version    XML Support
      ----------------------------------------------------------------
      c0    NVMe   Samsung        0xa821    MS1PC2DD3ORA3.2T          KPYA8R3Q       -
      c1    NVMe   Samsung        0xa821    MS1PC2DD3ORA3.2T          KPYA8R3Q       -
      c2    SAS    LSI Logic      0x005d    LSI MegaRAID 9361-8i      4.230.40-3739  6.17.04.2      06.06.10.05    4.16.08.00     -
      c3    FC     Qlogic         0x8031    QLE8362                   7.03.00        3.24           5.50           4.06           -
      c4    NET    Intel          0x1528    Intel(R) Ethernet Control -              -    80000479
      c5    NET    Intel          0x1528    Intel(R) Ethernet Control -              -    8000047A
      1. Verify that the firmware package file that is installed in the Oracle 3.2 TB NVMe SSD requires updating.

        To identify NVMe controllers that need updated firmware image files, view the FW Version column in the output from the fwdupdate list controller command. All 3.2 TB NVMe SSD controllers c0 through c1 are enumerated in the output returned by the above command.

        For example, 3.2 TB NVMe SSD controllers c0 and c1show firmware version KPYA8R3Q, but the current NVMe controller firmware version is KPYAIR3Q.

    2. View the Firmware Revision in the output from the nvmeadm list -v command. (Optional)

      To identify NVMe controllers and current firmware versions type:

      # nvmeadm list -v

      To identify NVMe controllers that need updated firmware image files, view the Firmware Revision: line in the output from the nvmeadm list -v command.

      In the following example, controllers SUNW-NVME-1 and SUNW-NVME-2 show firmware version KPYAB3RQ in the output returned by the command.

      # nvmeadm list -v
      SUNW-NVME-1
              PCI Vendor ID:                  144d
              Serial Number:                  S2ETNYAG800224
              Model Number:                   MS1PC2DD3ORA3.2T
              Firmware Revision:              KPYAB3RQ
              Number of Namespaces:           1
      SUNW-NVME-2
              PCI Vendor ID:                  144d
              Serial Number:                  S2ETNYAG800063
              Model Number:                   MS1PC2DD3ORA3.2T
              Firmware Revision:              KPYAB3RQ
              Number of Namespaces:           1
  5. Quiesce the Oracle 3.2 TB NVMe SSD device.

    Manually quiesce I/O and device usage.


    Caution

    Caution  -  System hang or data loss. Before updating device firmware, ensure that the device is quiesced and the following events are not occurring:

    • The operating system is not accessing the disk (for example, the system boot disk).
    • An application is not accessing the disk (for example, a database application).


  6. Update the selected 3.2 TB NVMe SSDs with the specified firmware package.

    The fwupdate command can update firmware for all similar devices in the system utilizing an XML metadata file. This method is called Automatic Mode and is the recommended method for upgrades. (See below for alternative methods.)


    Caution

    Caution  -  The XML metadata file does not update device firmware on SPARC servers. When running the fwupdate command with -x metadata.xml on SPARC servers, the update does not complete successfully and generates FMA errors. An error message may be output when the fwupdate command is executed, the command may terminate abnormally, and the device taken off-line. See Updating Device Firmware Using XML Metadata File Fails On SPARC Servers (26234240)



    Note -  Alternately, if you determine that each device must be updated with a separate fwupdate command, perform the fwupdate Automatic Single Drive method, or the fwupdate Manual method (if an XML metadata file is not available). Refer to the Oracle Hardware Management Pack documentation for instructions at http://www.oracle.com/goto/ohmp/docs.
    1. Verify that an XML metadata file is available for the server.

      An XML metadata file must be included with the firmware update package to use Automatic Mode. Refer to the update package release notes for more information.

    2. To update device firmware on Oracle 3.2 TB NVMe SSDs, type:

      fwupdate update controller -x metadata.xml

      # fwupdate update controller -x metadata.xml 
      
      The following components will be upgraded as shown:
      ==========================================================
      ID        Priority Action     Status      Old Firmware Ver.   Proposed Ver.       New Firmware Ver.   System Reboot     
      ----------------------------------------------------------------------------------
      c0        1        Check FW   Success     KPYAB3RQ           KPYAIR3Q            N/A                 System Power Cycle
      c1        1        Check FW   Success     KPYAB3RQ           KPYAIR3Q            N/A                 System Power Cycle
      Do you wish to process all of the above component upgrades? [y/n]? y

      If the current firmware package version on the selected drive is higher than the specified firmware package version, the command returns an error. Refer to the Oracle Hardware Management Pack documentation for error codes at http://www.oracle.com/goto/ohmp/docs.

    3. To upgrade the firmware packages and process all of the above component upgrades, type y.
      # fwupdate update controller -x metadata.xml 
      
      The following components will be upgraded as shown:
      ==========================================================
      ID        Priority Action     Status      Old Firmware Ver.   Proposed Ver.       New Firmware Ver.   System Reboot     
      ----------------------------------------------------------------------------------
      c0        1        Check FW   Success     KPYAB3RQ            KPYAIR3Q            N/A                 System Power Cycle
      c1        1        Check FW   Success     KPYAB3RQ            KPYAIR3Q            N/A                 System Power Cycle
      Do you wish to process all of the above component upgrades? [y/n]? y
      Updating c0:  Success
      Sleeping for 10 seconds for component to recover
      Updating c1:  Success
      Sleeping for 10 seconds for component to recover
      
      Verifying all priority 1 updates
      
      Execution Summary
      ==========================================================
      ID        Priority Action     Status      Old Firmware Ver.   Proposed Ver.       New Firmware Ver.   System Reboot     
      ----------------------------------------------------------------------------------
      c0        1        Post Power Pending     KPYAB3RQ            KPYAIR3Q            N/A                 System Power Cycle
      c1        1        Post Power Pending     KPYAB3RQ            KPYAIR3Q            N/A                 System Power Cycle
      System Reboot required for some applied firmware
      Do you wish to automatically reboot now? [y/n]? y
    4. Reboot the host server to initialize the firmware update.

      Type y to reboot the system.

  7. Re-access the console.

    Refer to the server installation guide.

  8. Verify that the updated firmware package is installed in the Oracle 3.2 TB NVMe SSD.
    1. Type the following from a terminal:

      # fwupdate list controller

      # fwupdate list controller
      
      ==================================================
      CONTROLLER
      ==================================================
      ID    Type   Manufacturer   Model     Product Name              FW Version     BIOS Version   EFI Version    FCODE Version  Package Version  NVDATA Version    XML Support
      -------------------------------------------------------------------------------
      c0    NVMe   Samsung        0xa821    MS1PC2DD3ORA3.2T          KPYAIR3Q       - 
      c1    NVMe   Samsung        0xa821    MS1PC2DD3ORA3.2T          KPYAIR3Q       - 
      c2    SAS    LSI Logic      0x005d    LSI MegaRAID 9361-8i      4.230.40-3739  6.17.04.2      06.06.10.05    4.16.08.00
      c3    FC     Qlogic         0x8031    QLE8362                   7.03.00        3.24           5.50           4.06
      c4    NET    Intel          0x1528    Intel(R) Ethernet Control -              -      80000479 
      c5    NET    Intel          0x1528    Intel(R) Ethernet Control -              -      8000047A 
    2. Verify host recognition of all 3.2 TB NVMe SSDs by checking ID enumeration.

      In the above example, 3.2 TB NVMe SSD controller IDs c0 and c1 are enumerated in the output returned by the above command.

    3. Ensure that the 3.2 TB NVMe SSD firmware was updated in the output returned by the above command.
  9. Verify Oracle 3.2 TB NVMe SSD operation.

    See Verify Oracle 3.2 TB NVMe SSD Operation.

  10. Repeat the firmware upgrade process as required until the Oracle 3.2 TB NVMe SSD has the most up to date firmware release.

    For example, upgrade firmware revision from KPYAB3RQ to KPYA8R3Q, and then to KPYABR3Q.

    See Minimum Supported Oracle 3.2 TB NVMe SSD Firmware Version.

Related Information