Update the NVMe Storage Drive Firmware

Language:

This topic provides instructions to update Oracle F320 Flash Card NAND flash controller firmware for the host for supported Oracle Solaris and Oracle Linux operating systems. Oracle F320 Flash Card 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.

Check the Product Notes for the latest firmware requirements at:
Minimum Supported Card Firmware Version
Log into the target system through SSH or through Oracle ILOM Remote System Console.
Refer to the server installation guide.
Download and store any firmware image file updates on the server that are required to support the Oracle Flash Accelerator F320 PCIe Card and 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.
Identify all Oracle Flash Accelerator F320 PCIe Card and controller firmware versions in the server using either Oracle Hardware Management Pack command in the examples below.
1. To identify all Oracle Flash Accelerator F320 PCIe Card controllers and current firmware versions in the system, type:
  # fwupdate list controller
  
  In the following examples, Oracle Flash Accelerator F320 PCIe Card controllers c1 and c2 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    SAS    LSI Logic      0x005d    LSI MegaRAID 9361-8i      4.230.40-3739  6.17.04.2      06.06.10.05    4.16.08.00     -                -     N/A 
c1    NVMe   Samsung        0xa821    MS1PC5ED3ORA3.2T          KPYAB3RQ         
c2    NVMe   Samsung        0xa821    MS1PC5ED3ORA3.2T          KPYAB3RQ  
c3    NET    Intel          0x1528    Intel(R) Ethernet Control -              -             80000479 
c4    NET    Intel          0x1528    Intel(R) Ethernet Control -              -             8000047A 
```
  Verify that the firmware package file that is installed in the Oracle Flash Accelerator F320 PCIe Card 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.
  
  In the above example, Oracle Flash Accelerator F320 PCIe Card controllers c1 and c2 show firmware version KPYAB3RQ.
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
  
  In the following example, controllers SUNW-NVME-1 and SUNW-NVME-2 show Firmware Revision KPYAB3RQ in the output returned by the above command.
```
# nvmeadm list -v         
SUNW-NVME-1
        PCI Vendor ID:                  144d
        Serial Number:                  S2FHNYAG800126
        Model Number:                   MS1PC5ED3ORA3.2T
        Firmware Revision:              KPYAB3RQ
        Number of Namespaces:           1
SUNW-NVME-2
        PCI Vendor ID:                  144d
        Serial Number:                  S2FHNYAG800030
        Model Number:                   MS1PC5ED3ORA3.2T
        Firmware Revision:              KPYAB3RQ
        Number of Namespaces:           1
```
  Verify that the firmware package file that is installed in the Oracle Flash Accelerator F320 PCIe Card requires updating.
  
  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 above example, Oracle Flash Accelerator F320 PCIe Card controllers SUNW-NVME-1and SUNW-NVME-2 show firmware version KPYAB3RQ.

Quiesce the Oracle Flash Accelerator F320 PCIe Card and 3.2 TB NVMe SSD devices.

Manually quiesce I/O and device usage.

Caution - System hang or data loss. Before updating device firmware, make sure 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).

Update the selected Oracle Flash Accelerator F320 PCIe Cards 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 - 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 Oracle F320 Flash Card 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.

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.

To update device firmware on Oracle Flash Accelerator F320 PCIe Card and 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     
----------------------------------------------------------------------------------
c1        1        Check FW   Success     KPYAB3RQ            KPYAIR3Q            N/A                 System Power Cycle
c2        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.

To upgrade the firmware packages and process all of the above component upgrades, type y.

Do you wish to process all of the above component upgrades? [y/n]? y
Updating c1:  Success
Sleeping for 10 seconds for component to recover
Updating c2:  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     
----------------------------------------------------------------------------------
c1        1        Post Power Pending     KPYAB3RQ            KPYAIR3Q            N/A                 System Power Cycle
c2        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

Reboot the host server to initialize the firmware update.
Type y to reboot the system.

Re-access the console.
Refer to the server installation guide.

Verify that the updated firmware package is installed in the Oracle Flash Accelerator F320 PCIe Card.

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    SAS    LSI Logic      0x005d    LSI MegaRAID 9361-8i      4.230.40-3739  6.17.04.2      06.06.10.05    4.16.08.00     -          
c1    NVMe   Samsung        0xa821    MS1PC5ED3ORA3.2T          KPYAIR3Q       -              -              -              -         
c2    NVMe   Samsung        0xa821    MS1PC5ED3ORA3.2T          KPYAIR3Q       -              -              -              -         
c3    NET    Intel          0x1528    Intel(R) Ethernet Control -              -                                            80000479  
c4    NET    Intel          0x1528    Intel(R) Ethernet Control -              -                                            8000047A

Verify host recognition of all Oracle Flash Accelerator F320 PCIe Cards by checking PCIe ID enumeration.
In the above example, Oracle Flash Accelerator F320 PCIe Card controllers c1 and c2 are enumerated in the output returned by the above command.
Ensure that the Oracle Flash Accelerator F320 PCIe Card firmware was updated in the output returned by the above command.

Verify Oracle Flash Accelerator F320 PCIe Card operation.
See Verify Oracle Oracle Flash Accelerator F320 PCIe Card Operation.
Repeat the firmware upgrade process until the Oracle Flash Accelerator F320 PCIe Card has the most up to date firmware release.
For example, upgrade firmware revision from KPYA6R3Q to KPYAB3RQ, and then to KPYABR3Q.

See Minimum Supported Card Firmware Version.

Related Information

Minimum Supported Card Firmware Version
Oracle Server CLI Tools User's Guide at: http://www.oracle.com/goto/ohmp/docs