No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

ES3000 V3 NVMe PCIe SSD User Guide 20

This document provides the product information about the Huawei ES3000 V3 PCIe SSD (ES3000 V3 for short) and describes how to install, configure, operate, and maintain the ES3000 V3.
Rate and give feedback :
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
Installing the ES3000 V3 Driver in Linux

Installing the ES3000 V3 Driver in Linux

Operation Scenario

If you decide to use Huawei's NVMe driver after reading Driver Information, install it by referring to this section before using the ES3000 V3 for the first time.

If you install multiple ES3000 V3s on a server, you need to install the driver only once.

NOTE:
The Linux driver package naming rules are as follows:
  • RHEL, CentOS, or OEL driver package name: kmod-hiodriver-Driver version-Supported kernel version.System distributor.Hardware platform.rpm, such as kmod-hiodriver-3.3.5.2-3.10.0_123.el7.centos.x86_64.rpm, kmod-hiodriver-3.3.5.2-3.10.0_123.el7.redhat.x86_64.rpm, or kmod-hiodriver-3.3.5.2-3.10.0_123.el7.oracle.x86_64.rpm.
  • SLES driver package name: hiodriver-kmp-Kernel feature-Driver version-Supported kernel version.System distributor.Hardware platform.rpm, such as hiodriver-kmp-default-3.3.5.2-3.12.28_4.suse12.x86_64.rpm.
  • Ubuntu or Debian driver package name: hiodriver -Driver version-Supported kernel version.System distributor.Hardware platform.deb, such as hiodriver-3.3.5.3-3.19.0_15_generic.ubuntu.amd64.deb.
  • UVP driver package name: hiodriver-kmp-xen-Driver version-Supported kernel version.System distributor.Hardware platform.rpm.

Preparations

Before installing the ES3000 V3 driver, check that:

  • You have correctly installed the ES3000 V3 on the server.
  • You have downloaded the ES3000 V3 driver package to the server, and verified the package integrity.
  • You have uploaded the driver package to a directory (for example, /home) on the server by using WinSCP.

Procedure

  1. Log in to the OS as an administrator.
  2. Go to the directory that stores the ES3000 V3 driver package, for example, /home.
  3. Run the installation command based on the OS type.

    • For RHEL, CentOS, OEL, SLES, or UVP, run rpm -ivh driver package name.

      An example package name for CentOS is rpm -ivh kmod-hiodriver-3.3.5.3-2.6.32_431.el6.centos.x86_64.rpm.

    • For Ubuntu or Debian, run dpkg -i driver package name.

      An example package name for Ubuntu is dpkg -i hiodriver-3.3.5.3-3.19.0_15_generic.ubuntu.amd64.deb.

      NOTE:
      • If the CPU hardware capabilities are insufficient for processing high-speed I/O services of NVMe devices during interruption, it is recommended that you configure the NVMe driver to work in threaded_irq mode before installing it. The configuration method is as follows:
        1. Run the vim /etc/modprobe.d/nvme.conf command to create or open the configuration file for editing.
        2. Enter i.
        3. In the configuration file, change the value of options nvme use_threaded_interrupts to 1:

          options nvme use_threaded_interrupts=1

        4. Press Esc, enter :wq, and press Enter to save the edits.
        5. Run the chmod +x /etc/modprobe.d/nvme.conf command to change the permission on nvme.conf.
      • If the NVMe driver works in threaded_irq mode, the I/O latency increases: Both the 4 KB read latency and write latency increase by 5 μs.

  4. Check whether the following message indicating an incorrect installation package is displayed.

    Error: The installing package does not match the current OS. Please execute command: rpm -e kmod-hiodriver to uninstall the installing rpm.
    • If yes, go to 5.
    • If no, go to 6.

  5. Uninstall the installed package as prompted. Upload the correct driver package for the OS to the server and perform 2 again to install the driver.
  6. Check whether the following message is displayed. The message indicates that the original NVMe driver fails to be uninstalled during the installation.

    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 9.
    • If no, go to 7.

  7. Check whether the following message is displayed. The message indicates that the new NVMe driver fails to be installed during the installation.

    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 8.
    • If no, go to 12.

  8. Check whether restarting the OS will affect services.

    • If yes, restart the OS when no service is running and go to 12.
    • If no, restart the OS and go to 12.

  9. Check whether restarting the OS will affect services.

    • If yes, go to 10.
    • If no, restart the OS and go to 12.

  10. Run the modprobe -r 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 when no service is running and go to 12.
    • If no, go to 11.

  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 12.
    • If no, go to 12.

  12. Run the modinfo nvme command to check the driver author information to determine whether the driver is successfully installed.

    If the author in the command output is as follows, the driver is successfully installed.

    author:         Huawei Technologies Co., Ltd.
    • If yes, go to 13.
    • If no, go to 15.

  13. If a PCIe SSD device has been installed on the server, check whether the driver has initialized the device.

    Check whether the NVMe device exists in the /dev directory to determine whether the device initialization is complete.

    • If yes, go to 14.
    • If no, go to 15.

  14. if the OS uses the irqbalance service to balance CPU interrupts, restart the service by using one of the following commands after re-loading the driver module:

    • For RHEL 6 or CentOs 6, run service irqbalance restart.
    • For SLES 11 or UVP, run service irq_balancer restart.
    • For SLES 12 or RHEL 7, run systemctl restart irqbalance.service.
    NOTE:
    • For RHEL 6, CentOs 6, or SLES 12, you can add IRQBALANCE_ARGS="--hintpolicy=exact" to the end of the /etc/sysconfig/irqbalance file content to better balance interrupts.
    • To configure the irqbalance service in other OSs, refer to documents related to the OSs.

    If the OS cannot find the service, it indicates that the OS does not use the irqbalance service for balance interrupts. If the command can be run, check whether errors are reported after running the command for restarting the irqbalance service.

    • If yes, go to 15.
    • If no, no further action is required.

  15. Contact Huawei technical support for help.

    NOTE:

    If the ES3000 V3 hiodriver is used, certain operating systems such as SUSE Linux will record the module verification failed error in dmesg logs. This error message is a notification indicating that an operating system detects a third-party driver with an unmatched signature. It does not affect services. For detailed reasons and solutions, see Why the "module verification failed " Message Is Displayed When ES3000 V3 PCIe SSDs Use Huawei-developed SUSE NVMe Drivers.

Translation
Download
Updated: 2019-03-12

Document ID: EDOC1000101091

Views: 58262

Downloads: 1240

Average rating:
This Document Applies to these Products
Related Documents
Related Version
Share
Previous Next