Updating Oracle Flash Accelerator F640 PCIe Card Software and Firmware

This section provides information on updating Oracle Flash Accelerator F640 PCIe Card firmware and software.

Accessing Software Updates and Firmware Downloads

Parent topic: Oracle Flash Accelerator F640 PCIe Card v3 Product Information

Accessing Software Updates and Firmware Downloads

Product patches, updates and firmware are available on My Oracle Support at https://support.oracle.com . from the Patches and Updates tab.

This section provides information on updating Oracle Flash Accelerator F640 PCIe Card v3 firmware and software.

Parent topic: Updating Oracle Flash Accelerator F640 PCIe Card Software and Firmware

Download the Device Software Package

To find the device software package, access My Oracle Support and download the latest software package for Oracle Flash Accelerator F640 PCIe Card v3s.

Go to the My Oracle Support web site: https://support.oracle.com.
Sign in to My Oracle Support.
At the top of the page, click the Patches & Updates tab.

The Patch Search pane appears at the right of the screen.
Within the Search tab area, click Number/Name or Bug Number (Simple).

The Search tab area appears with search fields.
In the Product field, enter the patch number for Oracle Flash Accelerator F640 PCIe Card v3s.

See Minimum Supported Card Firmware Version.
In the Release field, select a software release from the drop-down list.

Expand the list to see all available software releases.
Click Search.

The Patch Advanced Search Results screen appears, listing the patches for the software release.
To select a patch for a software release, click the patch number next to the software release version.

You can use the Shift key to select more than one patch.

A pop-up action panel appears. The panel contains several action options, including the ReadMe, Download, and Add to Plan options. For information about the Add to Plan option, click the associated button and select “Why use a plan?”.
To review the ReadMe file for this patch, click ReadMe.
To download the patch for the software release, click Download.
In the File Download dialog box, click the patch zip file name.

The patch for the software release downloads. The download is an archive zip file, which you must extract to find the directory containing the image.pkg file.

Parent topic: Accessing Software Updates and Firmware Downloads

Update the NVMe Storage Drive Firmware

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.

For CLI command instructions, refer to Oracle Hardware Management Pack documentation at https://www.oracle.com/goto/ohmp/docs .

This procedure provides instructions to update Oracle F640 Flash Card NAND flash controller firmware on the host for supported Oracle Solaris and Linux operating systems. Oracle F640 Flash Card firmware is updated as a single package using Oracle Hardware Management Pack utility command-line interface (CLI) tools.

Note:

For detailed instructions on system software updates, refer to the server documentation.

Check Oracle Flash Accelerator F640 PCIe Card v3 Product Information for the latest firmware requirements.

See Minimum Supported Card Firmware Version.
Log in to the target system.

For detailed instructions, refer to the server installation guide. For example, to log in to the target system through SSH or through Oracle ILOM Remote System Console Plus, do one of the following:
- If you are using an SSH client connection.
  1. From a shell command line in a terminal window, establish an SSH connection to the server host.
    
    Type: ssh root@hostname, where hostname can be the DNS name or the IP address for the server host.
  2. Log in to the system using an account with root access.
  3. Proceed to Step 3.
- If you are using a remote system console, first refer to the server Administration Guide and then perform these steps.
  
  To launch an Oracle ILOM Remote System Console Plus session, refer to Launching Remote KVMS Redirection Sessions in the server Administration Guide.
  1. Establish a remote connection to the host console.
    
    Start an Oracle ILOM serial console session, type:
    
    -> start /HOST/console
    
    Are you sure you want to start /HOST/console (y/n)? y
  2. Ensure that the server is powered on and booted.
  3. Access the operating system command-line interface.
    
    You issue Oracle Hardware Management Pack commands from the operating system command-line interface.
Download and store any firmware image file updates on the server that are required to support Oracle Flash Accelerator F640 PCIe Card v3s.
1. Download firmware image files from this location:
  
  https://support.oracle.com
  
  See Download the Device Software Package.
2. Copy the downloaded firmware image files obtained to the target system root directory.

Identify all Oracle Flash Accelerator F640 PCIe Card v3 controller firmware versions in the server.

Type # fwupdate list controller.

In the following examples, Oracle Flash Accelerator F640 PCIe Card v3 controllers c1 to c11 are enumerated in the output returned by the above command.

# fwupdate list controller
==================================================
CONTROLLER
==================================================
ID    Type   Manufacturer   Model     Product Name              FW Version   
-----------------------------------------------------------------------------
c0    NVMe   Samsung        0xa824    SAMSUNG MZWLR7T6HALA-00AU3MPK94R5Q     
c1    NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC50     
c2    HDC    Intel          0xa182    0x4873                    -            
c3    NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC50     
c4    NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC50     
c5    NVMe   Intel          0x0b60    INTEL SSDPFCKE064T9S      2CV1RC30     
c6    NVMe   Intel          0x0b60    INTEL SSDPFCKE064T9S      2CV1RC30     
c7    NVMe   Intel          0x0b60    INTEL SSDPFCKE064T9S      2CV1RC50     
c8    NVMe   Intel          0x0b60    INTEL SSDPFCKE064T9S      2CV1RC50     
c9    NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC50     
c10   NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC50     
c11   NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC50

Verify that the firmware package files that are installed in Oracle Flash Accelerator F640 PCIe Card v3s require 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 following example, Oracle Flash Accelerator F640 PCIe Card v3 controllers c5, c6 show firmware version 2CV1RC30, while the other NVMe controllers show firmware version 2CV1RC50.

# fwupdate list controller
==================================================
CONTROLLER
==================================================
ID    Type   Manufacturer   Model     Product Name              FW Version   
-----------------------------------------------------------------------------
c0    NVMe   Samsung        0xa824    SAMSUNG MZWLR7T6HALA-00AU3MPK94R5Q     
c1    NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC50     
c2    HDC    Intel          0xa182    0x4873                    -            
c3    NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC50     
c4    NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC50     
c5    NVMe   Intel          0x0b60    INTEL SSDPFCKE064T9S      2CV1RC30     
c6    NVMe   Intel          0x0b60    INTEL SSDPFCKE064T9S      2CV1RC30     
c7    NVMe   Intel          0x0b60    INTEL SSDPFCKE064T9S      2CV1RC50     
c8    NVMe   Intel          0x0b60    INTEL SSDPFCKE064T9S      2CV1RC50     
c9    NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC50     
c10   NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC50     
c11   NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC50

View the Firmware Revision in the output from the nvmeadm list -v command.

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 version 2CV1RC50 in the output returned by the above command.

# nvmeadm list -v
SUNW-NVME-1
SMART/Health Information:
        Critical Warning: 0
        Temperature: 315 Kelvin
        Available Spare: 100 percent
        Available Spare Threshold: 10 percent
        Percentage Used: 0 percent
        Data Unit Read: 0x2fa1c314 of 512k bytes.
        Data Unit Written: 0x23bd12c7 of 512k bytes.
        Number of Host Read Commands: 0x3f0bb9308
        Number of Host Write Commands: 0x1c2433434
        Controller Busy Time in Minutes: 0x525
        Number of Power Cycle: 0x56e
        Number of Power On Hours: 0x55f
        Number of Unsafe Shutdown: 0x307
        Number of Media Errors: 0x0
        Number of Error Info Log Entries: 0x0

SUNW-NVME-2
SMART/Health Information:
        Critical Warning: 0
        Temperature: 310 Kelvin
        Available Spare: 99 percent
        Available Spare Threshold: 10 percent
        Percentage Used: 1 percent
        Data Unit Read: 0x138a818a of 512k bytes.
        Data Unit Written: 0x2d71a25d of 512k bytes.
        Number of Host Read Commands: 0xe75e59ca
        Number of Host Write Commands: 0x7a604b45c
        Controller Busy Time in Minutes: 0xe0
        Number of Power Cycle: 0x89
        Number of Power On Hours: 0x1443
        Number of Unsafe Shutdown: 0x78
        Number of Media Errors: 0x0
        Number of Error Info Log Entries: 0x0

SUNW-NVME-3
SMART/Health Information:
        Critical Warning: 0
        Temperature: 310 Kelvin
        Available Spare: 99 percent
        Available Spare Threshold: 10 percent
        Percentage Used: 6 percent
        Data Unit Read: 0xe41b09fd of 512k bytes.
        Data Unit Written: 0xa86d0cea of 512k bytes.
        Number of Host Read Commands: 0x1b278da767
        Number of Host Write Commands: 0x1695d69510
        Controller Busy Time in Minutes: 0xc0b
        Number of Power Cycle: 0x1eb
        Number of Power On Hours: 0x19f1
        Number of Unsafe Shutdown: 0xb1
        Number of Media Errors: 0x0
        Number of Error Info Log Entries: 0x0

Quiesce Oracle Flash Accelerator F640 PCIe Card v3 devices.
Before removing the card, manually quiesce I/O and device usage.
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).
Update the selected Oracle Flash Accelerator F640 PCIe Card v3s 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.

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). For CLI command instructions, refer to Oracle Hardware Management Pack documentation at: https://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 Flash Accelerator F640 PCIe Card v3s, type # fwupdate update controller -x metadata.xml.
  In the following example, controllers c5 and c6 will be upgraded to firmware version 2CV1RC50.
```
# 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
-------------------------------------------------------------------------------------------------------------------
c5        1        Check FW    Success     2CV1RC30            2CV1RC50            N/A                 None
c6        1        Check FW    Success     2CV1RC30            2CV1RC50            N/A                 None
Do you wish to process all of the above component upgrades? [y/n]? 
```
  If the current firmware package version on the selected controller is higher than the specified firmware package version, the command returns an error. For error codes, refer to Oracle Hardware Management Pack documentation at https://www.oracle.com/goto/ohmp/docs .
3. To upgrade the firmware packages and process all of the above component upgrades, type y.
```
Updating c5:  Success
Updating c6:  Success

Verifying all priority 1 updates

Execution Summary
==========================================================
ID        Priority Action      Status      Old Firmware Ver.   Proposed Ver.       New Firmware Ver.   System Reboot
-------------------------------------------------------------------------------------------------------------------
c5        1        Check FW    Success     2CV1RC30            2CV1RC50            N/A                 None
c6        1        Check FW    Success     2CV1RC30            2CV1RC50            N/A                 None
System Reboot required for some applied firmware
Do you wish to automatically reboot now? [y/n]?
```
4. Type y to reboot the host server to initialize the firmware update.
Re-access the console. See step 2.

For more instructions, refer to the server Installation Guide.

Verify that updated firmware packages are installed in Oracle Flash Accelerator F640 PCIe Card v3s.

Type the following from a terminal:

# fwupdate list controller

In the following example, Oracle Flash Accelerator F640 PCIe Card v3s are displayed.

# fwupdate list controller
==================================================
CONTROLLER
==================================================
ID    Type   Manufacturer   Model     Product Name              FW Version   
-----------------------------------------------------------------------------
c0    NVMe   Samsung        0xa824    SAMSUNG MZWLR7T6HALA-00AU3MPK94R5Q     
c1    NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC50     
c2    HDC    Intel          0xa182    0x4873                    -            
c3    NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC50     
c4    NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC50     
c5    NVMe   Intel          0x0b60    INTEL SSDPFCKE064T9S      2CV1RC50     
c6    NVMe   Intel          0x0b60    INTEL SSDPFCKE064T9S      2CV1RC50     
c7    NVMe   Intel          0x0b60    INTEL SSDPFCKE064T9S      2CV1RC50     
c8    NVMe   Intel          0x0b60    INTEL SSDPFCKE064T9S      2CV1RC50     
c9    NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC50     
c10   NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC50     
c11   NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC50

Verify host recognition of all Oracle Flash Accelerator F640 PCIe Card v3s by checking PCIe ID enumeration.

In the above example, Oracle Flash Accelerator F640 PCIe Card v3 controllers c0 and c11 are enumerated in the output returned by the above command.
Ensure that Oracle Flash Accelerator F640 PCIe Card v3 firmware was updated in the output returned by the above command.

In the above example, Oracle Flash Accelerator F640 PCIe Card v3 controllers c0 to c11 show firmware version 2CV1RC50.

Verify Oracle Flash Accelerator F640 PCIe Card v3 operation.

See Verify Oracle Flash Accelerator F640 PCIe Card v3 Operation.
Repeat the firmware upgrade process until Oracle Flash Accelerator F640 PCIe Card v3s have the most up to date firmware release.
See Minimum Supported Card Firmware Version.

For example, upgrade firmware revision to 2CV1RC50.

Related Information
- Minimum Supported Card Firmware Version
- For CLI command instructions, refer to Oracle Hardware Management Pack documentation at https://www.oracle.com/goto/ohmp/docs .
  
  Oracle Server CLI Tools User's Guide

Parent topic: Accessing Software Updates and Firmware Downloads

Verify Oracle Flash Accelerator F640 PCIe Card v3 Operation

Verify that Oracle Hardware Management Pack is installed on the host.

For CLI command instructions, refer to Oracle Hardware Management Pack documentation at https://www.oracle.com/goto/ohmp/docs .
Ensure that you have access to the server (either directly or over the network).

This procedure provides instructions to verify Oracle Flash Accelerator F640 PCIe Card v3 operation on the host for supported Oracle Solaris and Oracle Linux operating systems. Verify Oracle Flash Accelerator F640 PCIe Card v3 and 6.4 TB NVMe SSD operation using Oracle Hardware Management Pack utility CLI tools.

Observe Oracle Flash Accelerator F640 PCIe Card v3 status indicator LEDs.

Verify that the Fault-Service Action Required Oracle Flash Accelerator F640 PCIe Card v3 status indicator is not lit and that the green Power status indicator is lit on Oracle Flash Accelerator F640 PCIe Card v3s and 6.4 TB NVMe SSDs that you updated.

Refer to LED Status Indicator Characteristics in Oracle Flash Accelerator F640 PCIe Card v3 NVMe Solid State Drive Specification.
Log in to the target system.

For detailed instructions, refer to the server installation guide. For example, to log in to the target system through SSH or through Oracle ILOM Remote System Console Plus, do one of the following:
- If you are using an SSH client connection.
  1. From a shell command line in a terminal window, establish an SSH connection to the server host.
    
    Type: ssh root@hostname, where hostname can be the DNS name or the IP address for the server host.
  2. Log in to the system using an account with root access.
  3. Proceed to Step 3.
- If you are using a remote system console, refer to the server administration guide and perform these steps.
  1. Establish a remote connection to the host console.
    
    Start an Oracle ILOM serial console session, type:
    
    -> start /HOST/console
    
    Are you sure you want to start /HOST/console (y/n)? y
    
    To launch an Oracle ILOM Remote System Console Plus session, refer to Launching Remote KVMS Redirection Sessions in the server administration guide.
  2. Ensure that the server is powered on and booted.
  3. Access the operating system command-line interface.
    
    You issue Oracle Hardware Management Pack commands from the operating system command-line interface.

Identify all Oracle F640 Flash Cards and verify that the latest firmware packages are installed.

Type the following command: # fwupdate list controller.

                        #
                        fwupdate list controller
==================================================
CONTROLLER
==================================================
ID    Type   Manufacturer   Model     Product Name              FW Version   
-----------------------------------------------------------------------------
c0    NVMe   Samsung        0xa824    SAMSUNG MZWLR7T6HALA-00AU3MPK94R5Q     
c1    NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC30     
c2    HDC    Intel          0xa182    0x4873                    -            
c3    NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC30     
c4    NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC30     
c5    NVMe   Intel          0x0b60    INTEL SSDPFCKE064T9S      2CV1R105     
c6    NVMe   Intel          0x0b60    INTEL SSDPFCKE064T9S      2CV1R105     
c7    NVMe   Intel          0x0b60    INTEL SSDPFCKE064T9S      2CV1R103     
c8    NVMe   Intel          0x0b60    INTEL SSDPFCKE064T9S      2CV1R103     
c9    NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC30     
c10   NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC30     
c11   NVMe   Intel          0x0b60    INTEL SSDPF2KX076T9S      2CV1RC30

Verify host recognition of all Oracle F640 Flash Cards by checking controller ID enumeration.

In the above example, Oracle F640 Flash Card controllers c0 and c1 are enumerated in the output returned by the above command.
Ensure that all Oracle F640 Flash Card firmware revisions are current in the FW Version output returned by the above command.

See Minimum Supported Card Firmware Version.

Check NVMe device status.

To identify NVMe controllers and current firmware versions, type # nvmeadm list -v.

To identify NVMe controllers that have updated firmware, view the Firmware Revision row in the output from the nvmeadm list -v command.

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

                  #
                  nvmeadm list -v
SUNW-NVME-1
        PCI Vendor ID:                  0x144d
        Serial Number:                  S64TNE0N800033
        Model Number:                   SAMSUNG MZWLR7T6HALA-00AU3
        Firmware Revision:              MPK94R5Q
        Number of Namespaces:           32
SUNW-NVME-2
        PCI Vendor ID:                  0x8086
        Serial Number:                  PHAB011200LV7P6GGN
        Model Number:                   INTEL SSDPF2KX076T9S
        Firmware Revision:              2CV1RC30
        Number of Namespaces:           128

Check Oracle Flash Accelerator F640 PCIe Card v3 health and SMART information.

To check the selected 6.4 TB NVMe SSD health and SMART (Self-Monitoring, Analysis, and Reporting Technology) information, type:

# nvmeadm getlog -h

Ensure that Oracle F640 Flash Cards have remaining drive life (Percentage Used) in the output returned by the above command.

                  #
                  nvmeadm getlog -h 
SUNW-NVME-1
SMART/Health Information:
        Critical Warning: 0
        Temperature: 315 Kelvin
        Available Spare: 100 percent
        Available Spare Threshold: 10 percent
        Percentage Used: 0 percent
        Data Unit Read: 0x2fa1c314 of 512k bytes.
        Data Unit Written: 0x23bd12c7 of 512k bytes.
        Number of Host Read Commands: 0x3f0bb9308
        Number of Host Write Commands: 0x1c2433434
        Controller Busy Time in Minutes: 0x525
        Number of Power Cycle: 0x56e
        Number of Power On Hours: 0x55f
        Number of Unsafe Shutdown: 0x307
        Number of Media Errors: 0x0
        Number of Error Info Log Entries: 0x0

SUNW-NVME-2
SMART/Health Information:
        Critical Warning: 0
        Temperature: 310 Kelvin
        Available Spare: 99 percent
        Available Spare Threshold: 10 percent
        Percentage Used: 1 percent
        Data Unit Read: 0x138a818a of 512k bytes.
        Data Unit Written: 0x2d71a25d of 512k bytes.
        Number of Host Read Commands: 0xe75e59ca
        Number of Host Write Commands: 0x7a604b45c
        Controller Busy Time in Minutes: 0xe0
        Number of Power Cycle: 0x89
        Number of Power On Hours: 0x1443
        Number of Unsafe Shutdown: 0x78
        Number of Media Errors: 0x0
        Number of Error Info Log Entries: 0x0

Related Information

Minimum Supported Card Firmware Version
Oracle Hardware Management Pack documentation at: https://www.oracle.com/goto/ohmp/docs

Parent topic: Accessing Software Updates and Firmware Downloads