Professional Documents
Culture Documents
Upgrading NVMe
Upgrading NVMe
Upgrade Guide
Issue 02
Date 2018-10-17
All other trademarks and trade names mentioned in this document are the property of their respective
holders.
Notice
The purchased products, services and features are stipulated by the contract made between Huawei and
the customer. All or part of the products, services and features described in this document may not be
within the purchase scope or the usage scope. Unless otherwise specified in the contract, all statements,
information, and recommendations in this document are provided "AS IS" without warranties, guarantees
or representations of any kind, either express or implied.
The information in this document is subject to change without notice. Every effort has been made in the
preparation of this document to ensure accuracy of the contents, but all statements, information, and
recommendations in this document do not constitute a warranty of any kind, express or implied.
Website: http://www.huawei.com
Email: support@huawei.com
Issue 02 (2018-10-17) i
Copyright © Huawei Technologies Co., Ltd.
Huawei ES3000 V5 SSD
Upgrade Guide About This Document
Purpose
This document describes the procedures and precautions for upgrading the ES3000 V5 SSD
driver, management tool, and firmware in Linux, Windows, and VMware.
Intended Audience
This document is intended for:
Technical support engineers
Maintenance engineers
Symbol Conventions
The symbols that may be found in this document are defined as follows.
Symbol Description
Symbol Description
deterioration.
Change History
Issue Date Description
Contents
2 Upgrade Process.............................................................................................................................3
3 Preparing for the Upgrade...........................................................................................................4
3.1 Pre-upgrade Checklist....................................................................................................................................................4
3.2 Verifying the Versions....................................................................................................................................................5
3.2.1 Querying the PCIe SSD Driver, Management Tool, and Firmware Versions in Linux...............................................5
3.2.2 Checking Whether the PCIe SSD Driver Is Provided by Windows............................................................................6
3.2.3 Querying the PCIe SSD Driver, Management Tool, and Firmware Versions in Windows.........................................8
3.2.4 Querying the PCIe SSD Driver, Management Tool, and Firmware Versions in VMware..........................................9
3.3 Obtaining the Upgrade Package...................................................................................................................................11
3.4 Verifying the Software Package Integrity.....................................................................................................................11
1.2 Precautions
Table 1-2describes the precautions for upgrading the server.
1 Read this document carefully before the upgrade. For any problems or suggestions
pertaining to this document, contact Huawei technical support.
2 Perform the upgrade after services have been stopped to minimize the impact on
the system and services.
3 Time required:
SSD driver upgrade: 2 minutes
SSD management tool upgrade: less than 1 minute
SSD firmware upgrade: less than 1 minute
4 The SSD driver, management tool, and firmware work together. Upgrade the
driver, management tool, and firmware in sequence.
2 Upgrade Process
Figure 2-1 shows the upgrade process of the SSD driver and firmware.
1 Verify the Check whether the SSD driver is released by Huawei or built in the
SSD driver, OS.
management Check and record the SSD driver, management tool, and firmware
tool, and versions.
firmware
versions.
Check whether the new SSD driver, management tool, and firmware
version, confirm that you want to upgrade some or all software.
2 Stop the Before the SSD driver upgrade, you must stop services.
applications During the SSD management tool upgrade, the tool cannot be used.
that are
accessing the
Before the SSD firmware upgrade, you must stop services.
SSD.
parm: nvme_major:int
parm: use_threaded_interrupts:int
In this example, the version 5.0.1.0 is the SSD management tool version.
Step 4 Run the following command to query the SSD device list:
hioadm info
The following command output is an example:
NVMe SSD Information
Controller Namespace
|---- nvme0 (0503023HDCN107C80013)
|------------ nvme0n1 (512.0GB)
|------------ nvme0n2 (512.0GB)
|---- nvme1 (0503023HDCN107C80014)
|------------ nvme0n1 (1600.3GB)
In this example, two SSDs are displayed. Their serial numbers are 0503023HDCN107C80013
and 0503023HDCN107C80014 respectively.
Step 5 Run the following command to query the firmware version of the SSD nvme1:
hioadm info -d nvme1
The following command output is an example:
Namespace<1> size: 1600.3GB, 1600321314816Byte
formatted LBA size: 512 Byte
formatted metadata size: 0 Byte
If the device name is Standard NVM Express Controller, the NVMe driver is provided by
the OS. If the device name is Huawei ES3000 storage controller, the NVMe driver is
released by Huawei.
Step 4 If the OS is Windows 2012 R2 and the current NVMe driver in use is provided by the OS, you
can still directly install Huawei's SSD driver by referring to Step 7 in section 4.2. If the OS is
Windows 2008 R2 or Windows 2012, proceed to step 5.
Step 5 Choose Start > Control Panel > Programs and Features.
Step 6 Click View installed updates. The window shown in Figure 3-2 is displayed.
Step 7 Right-click the KB2990941 patch and choose Uninstall from the displayed shortcut menu.
----End
In this example, 5.0.0.9 shown in the Version column is the SSD driver version.
Step 4 Choose Start > Run.
The Windows CLI is displayed.
Step 5 Run the cd command to go to the directory where the tool package is stored.
Step 6 Run the following command to query the SSD management tool version:
hioadm -v
The following command output is an example:
hioadm version 5.0.0.9 Copyright (c) 2015-2020 Huawei
In this example, the version 5.0.0.9 is the SSD management tool version.
Step 7 Run the following command to query the SSD device list:
hioadm info
The following command output is an example:
NVMe SSD Information
Controller Namespace
|---- nvme0 (0503023HDCN107C80013)
|------------ nvme0n1[Disk3] (512.0GB)
|------------ nvme0n2[Disk4] (512.0GB)
|---- nvme1 (0503023HDCN107C80014)
|------------ nvme0n1[Disk5] (1600.3GB)
In this example, two SSDs are displayed. Their serial numbers are 0503023HDCN107C80013
and 0503023HDCN107C80014 respectively.
Step 8 Run the following command to query the firmware version of the SSD nvme1:
hioadm info -d nvme1
The following command output is an example:
4 - verbose
5 – debug
In this example, the version 5.0.0.9 is the SSD management tool version.
Step 4 Run the following command to query the SSD device list:
hioadm info
The following command output is an example:
NVMe SSD Information
Controller Namespace
|---- nvme0 (0503023HDCN107C80013)
|------------ nvme0n1[vmhba3:C0:T0:L0] (512.0GB)
|------------ nvme0n2[vmhba3:C0:T0:L1] (512.0GB)
|---- nvme1 (0503023HDCN107C80014)
|------------ nvme1n1[vmhba4:C0:T0:L0] (1600.3GB)
In this example, two SSDs are displayed. Their serial numbers are 0503023HDCN107C80013
and 0503023HDCN107C80014 respectively.
Step 5 Run the following command to query the firmware version of the SSD nvme1:
hioadm info -d nvme1
The following command output is an example:
Namespace<1> size: 1600.3GB, 1600321314816Byte
formatted LBA size: 512 Byte
formatted metadata size: 0 Byte
You can quickly locate the required packages by entering a keyword in the search text box in the upper
right corner on the web page.
----End
On the download page, click to obtain the digital software certificate, and click to
download the software.
To obtain the verification tool and method, visit the following link:
Software digital signature (OpenPGP) validation tool
If yes, go to Step 5.
If no, go to Step 6.
Step 5 Uninstall the installed package as prompted. Upload the correct upgrade package for the OS
to the server and perform Step 2 again to install the package.
Step 6 Check whether the following message is displayed. The message indicates that the original
NVMe driver fails to be uninstalled during the upgrade.
Warning: fail to uninstall the old nvme kernel module.
Please uninstall the old nvme kernel module manually or reboot the system.
If yes, go to Step 9.
If no, go to Step 7.
Step 7 Check whether the following message is displayed. The message indicates that the new
NVMe driver fails to be installed during the upgrade.
Warning: fail to install the new nvme kernel module.
Please install the new nvme kernel module manually or reboot the system.
If yes, go to Step 8.
If no, go to Step 12.
Step 8 Check whether restarting the OS will affect services.
If yes, go to Step 11.
If no, restart the OS and go to Step 12.
Step 9 Check whether restarting the OS will affect services.
If yes, go to Step 10.
If no, restart the OS and go to Step 12.
Step 10 Run the rmmod nvme command to uninstall the original driver. During the uninstallation,
check whether a message is displayed indicating that the driver is in use. If yes, the
uninstallation fails.
If yes, restart the OS and go to Step 12.
If no, go to Step 11.
Step 11 Run the modprobe nvme command to install the new driver. Check whether a warning or
error is displayed during the installation.
If yes, restart the OS and go to Step 12.
If no, go to Step 12.
Step 12 Run the modinfo nvme command to check the version information to determine whether the
driver is successfully upgraded.
If the version number in the command output is the target version number, the upgrade is
successful.
The following is an example:
version: 5.0.1.0
Step 5 Right-click the program and choose Uninstall/Change from the displayed shortcut menu. The
confirmation dialog box shown in Figure 4-2 is displayed.
Step 6 Click Yes to uninstall the ES3000 V5 driver and its components.
Step 7 Open the windows\Windows Driver\Installer directory that stores the driver installation file.
Double-click the driver installation file, such as hiodriver_v5.0.1.0_2008R2_x84_64.msi.
There are three driver installation file types for three Windows versions. *.*.*.* indicates the version
number. This procedure uses hiodriver_v5.0.1.0_2008R2_x84_64.msi as an example.
hiodriver_v*.*.*.*_2008R2_x84_64.msi
hiodriver_v*.*.*.*_2012_x84_64.msi
hiodriver_v*.*.*.*_2012R2_x84_64.msi
Step 8 Click Next. The End-User License Agreement window is displayed, as shown in Figure 4-4.
Step 9 Select I agree the terms in the License Agreement and click Next.
The Choose Setup Type window is displayed, as shown in Figure 4-5.
Step 10 Click Complete. The Ready to install window is displayed, as shown in Figure 4-6.
----End
In the driver file name, 5.0.1.0 is the driver version. The actual driver version may differ.
Enter a complete directory after -v.
If the "Could not find a trusted signer" error occurs indicating that the driver version is not certified
by VMware IOVP, add --no-sig-check at the end of the command to skip signature check.
Step 3 After the upgrade is complete, run the reboot command to restart the OS.
Step 4 After the restart is successful, run the esxcli software vib list | grep hiodriver command.
If the device is displayed, the driver is properly installed.
[root@esxi113:~] esxcli software vib list | grep hiodriver
hiodriver 5.0.1.0-1OEM.600.0.0.2768847 OEM
VMwareCertified 2016-01-04
Step 5 If the SSD device is inserted into the server, run the lspci | grep Huwei command.
If the device is displayed, it is discovered successfully by the OS.
[root@esxi113:~] lspci | grep Huwei
0000:06:00.0 Mass storage controller: Huawei Technologies Co Ltd. Huawei ES3000
storage Controller [vmhba3]
----End
Step 4 Right-click the program and choose Uninstall/Change from the displayed shortcut menu. The
confirmation dialog box shown in Figure 5-2 is displayed.
Step 8 Select I agree the terms in the License Agreement and click Next.
The Destination Folder window is displayed, as shown in Figure 5-5.
Step 9 Select a folder for installing the tool and click Next.
The Ready to install window is displayed, as shown in Figure 5-6.
Step 3 Run the esxcli software vib list | grep hioadm command.
If the package is properly installed, information similar to the following is displayed:
[root@esxi113:~] esxcli software vib list | grep hioadm
hioadm 5.0.1.0-1vmw
Step 4 Run the following command to obtain help information about the tool:
hioadm -h
----End
Table 1.1 Checklist for verifying the SSD management tool upgrade
No. Check Item Expected Result
The activation column indicates the firmware version in use. The next column indicates the firmware
version that will take effect after a reset.
Step 3 Navigate to the folder where the controller firmware is stored, for example, /home.
You can use an absolute path or a relative path when upgrading the driver. If you do not perform this
step, you must enter an absolute path in the command in the next step.
In the activation column, current indicates the firmware version in use, and next indicates the firmware
version that will take effect after a reset.
Step 3 Navigate to the folder where the controller firmware is stored, for example, /home.
You can use an absolute path or a relative path when upgrading the driver. If you do not perform this
step, you must enter an absolute path in the command in the next step.
Step 4 Upgrade the controller firmware and make it take effect immediately.
hioadm updatefw -d sdc -f fw_image.bin -a 1
Step 5 Enter y and press Enter.
Step 6 Run the following command to check whether the SSD controller firmware is upgraded:
hioadm updatefw -d sdc
----End
Step 5 Place the firmware file in the directory where the hioadm.exe file is stored.
Run the following command to upgrade the controller firmware and make it take effect
immediately.
hioadm updatefw -d sdc -f fw_image.bin -a 1
Step 6 Enter y and press Enter.
Step 7 Run the following command again to check whether the SSD controller firmware is upgraded:
hioadm updatefw -d sdc
----End
1 Check the SSD firmware The SSD firmware version is the target one.
version.