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

Huawei IN200 NIC User Guide 06

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 Driver

Installing the Driver

Prerequisites

  • The RoCE driver package has been downloaded.

    The RoCE driver package is included in the IN200 software package. For details about how to obtain the IN200 package, see Obtaining Software Packages.

  • The IN200 driver has been installed.

    For details, see Maintaining the NIC Driver.

  • The driver package has been uploaded to the server OS.

Impact

  • If a non-OFA OFED 4.8-2 package (for example, an OFED package from a third party or an open-source OFED package of a different version) has been installed on the server, you need to uninstall the existing OFED package and then install the OFA OFED 4.8-2 package and IN200 RoCE driver before using the IN200 RoCE function (the unistallation and installation operations do not conflict with the IN200 NIC functions).
  • It takes about 30 seconds to install the driver. The installation process cannot be interrupted. During the installation, the OS cannot be restarted. Otherwise, the OS may be abnormal or cannot be started.

On the OS Supported by Huawei In-House OFED

  1. Log in to the server OS.

    For details, see Logging In to the Real-Time Server Desktop.

  2. Run either rpm -qa | grep rdma and rpm -qa | grep libib commands or dpkg -l | grep rdma and dpkg -l | grep libib commands to check whether the OFED has been installed.

    • If the OFED is installed, go to 3.
    • If the OFED is not installed, go to Step 4.

  3. Run the rpm -e X or dpkg -r X command to uninstall the original OFED package. In the command, X indicates the names of all OFED packages displayed in the command output in 2.
  4. Run the following command in the directory where the RoCE driver package is stored to decompress the OFED package:

    tar -xvf OFED-*.tar.gz

  5. Run the following command to go to the OFED package directory:

    cd OFED-*

  6. Run the following commands to install the OFED package:

    bash ofed_install.sh

    The command output is as follows:
    2019-07-10 09:30:43 
    2019-07-10 09:30:43 
    2019-07-10 09:30:43 [INSTALL] install OFED software start.
    2019-07-10 09:30:43 [INSTALL] check RPMS/compat-rdma-devel*rpm ok
    2019-07-10 09:30:43 [INSTALL] check RPMS/compat-rdma*rpm ok
    2019-07-10 09:30:43 [INSTALL] check RPMS/rdma-core-devel*rpm ok
    2019-07-10 09:30:43 [INSTALL] check RPMS/rdma-core*rpm ok
    2019-07-10 09:30:43 [INSTALL] check RPMS/libibverbs*rpm ok
    2019-07-10 09:30:43 [INSTALL] check RPMS/libibverbs-utils*rpm ok
    2019-07-10 09:30:43 [INSTALL] check RPMS/libibumad*rpm ok
    2019-07-10 09:30:43 [INSTALL] check RPMS/librdmacm*rpm ok
    2019-07-10 09:30:43 [INSTALL] check RPMS/librdmacm-utils*rpm ok
    2019-07-10 09:30:43 [INSTALL] check RPMS/perftest-debuginfo*rpm ok
    2019-07-10 09:30:43 [INSTALL] check RPMS/perftest*rpm ok
    This program will install the OFED package on your machine.
    Note that all other Mellanox, OEM, OFED, RDMA or Distribution IB packages will be removed.
    Those packages are removed due to conflicts with OFED, do not reinstall them.
    Do you want to continue?[y/N]:y
    ……………………………………………………………………………………………………………………………………………………………………………………………………………….
    ……………………………………………………………………………………………………………………………………………………………………………………………………………….
    Preparing...                          ################################# [100%]
    Updating / installing...
       1:perftest-debuginfo-4.4-0.5.g1ceab################################# [ 50%]
       2:perftest-4.4-0.5.g1ceab48        ################################# [100%]
    2019-07-10 09:33:26 [INSTALL] install_rpm perftest ok
    2019-07-10 09:33:26 [INSTALL] install driver   -----------------pass
    2019-07-10 09:33:26 [INSTALL] install OFED software ok.
    To load the new driver, run:
    /etc/init.d/openibd restart

  7. Install the RoCE driver in the directory where the RoCE driver package is stored.

    • On the CentOS, SUSE, EulerOS, or RHEL:

      Run the rpm -ivh<name of the driver software package command to install the driver package.

      The following commands use CentOS 7.4 as an example:

      [root@localhost driver]# rpm -ivh hiroce-2.3.1.0_3.10.0_693.el7.x86_64-1.el7.centos.x86_64.rpm
      Preparing...                          ################################# [100%] 
      Updating / installing...    
        1:hiroce-2.3.1.0_3.10.0_693.el7.x86################################# [100%]
    • On the Ubuntu:
      NOTE:

      The NIC driver installation depends on the module-init-tools component. If the module-init-tools component is not installed on the OS, download and install the module-init-tools component based on the OS version from the official Ubuntu/Debian website.

      1. Download the module-init-tools component.
      2. Upload the module-init-tools component file to the OS by referring to Transferring a File Using the Virtual Directory.
      3. Run the following command to install the module-init-tools component:

        dpkg -i module-init-tools.deb

      Run the dpkg -i<name of the driver software package command to install the RoCE driver.

      The following commands use Ubuntu 18.04.1 as an example:

      root@ubuntu18041:/home/ubuntu # dpkg -i hiroce-2.3.0.2-4.15.0_29_generic.ubuntu.amd64.deb
      Selecting previously unselected package hiroce.
      (Reading database ... 80445 files and directories currently installed.)
      Preparing to unpack hiroce-2.3.0.2-4.15.0_29_generic.ubuntu.amd64.deb ...
      Unpacking hiroce (2.3.0.2) ...
      Setting up hiroce (2.3.0.2) ...
      Installing... Please wait for a moment.
      Install hiroce driver package successfully.

  8. Make the driver take effect.

    Run the following commands on the OS.

    modprobe hiroce

    service network restart

    NOTE:

    This method takes effect temporarily. If you require the OS to automatically load the driver upon startup, add the preceding two commands to the automatic startup script of the OS.

On the OS Supported by Non-Huawei OFED

  1. Log in to the OS of the standby server.

    For details, see Logging In to the Real-Time Server Desktop.

  2. Run either rpm -qa | grep rdma and rpm -qa | grep libib commands or dpkg -l | grep rdma and dpkg -l | grep libib commands to check whether the OFED has been installed.

    • If the OFED is installed, go to 3.
    • If the OFED is not installed, go to 4.

  3. Run the rpm -e X or dpkg -r X command to uninstall the original OFED package. In the command, X indicates the names of all OFED packages displayed in the command output in 2.
  4. Click OFA OFED-4.8-2 to download the OFA OFED package of the 4.8-2 version.
  5. Compile the rpm/deb package (including compat-rdma and rdma-core) by referring to README.txt in the OFA OFED package.
  6. Upload the rpm/deb package to the OS by referring to 7.3 Transferring a File Using the Virtual Directory.
  7. Run therpm -ivh *.rpm or dpkg -i *.deb command to install the OFA OFED V4.8-2.
  8. Install the RoCE driver in the directory where the RoCE driver package is stored.

    • On the CentOS, SUSE, EulerOS, or RHEL:

      Run the rpm -ivh<name of the driver software package command to install the driver package.

      The following commands use RHEL 7.3 as an example:

      [root@localhost driver]# rpm -ivh hiroce-2.3.1.0_3.10.0_514.el7.x86_64-1.el7.x86_64.rpm
      Preparing...                          ################################# [100%] 
      Updating / installing...    
        1:hiroce-2.3.1.0_3.10.0_514.el7.x86################################# [100%]
    • On the Ubuntu:
    NOTE:

    The NIC driver installation depends on the module-init-tools component. If the module-init-tools component is not installed on the OS, download and install the module-init-tools component based on the OS version from the official Ubuntu/Debian website.

    1. Download the module-init-tools component.
    2. Upload the module-init-tools component file to the OS by referring to Transferring a File Using the Virtual Directory.
    3. Run the following command to install the module-init-tools component:

      dpkg -i module-init-tools.deb

    Run the dpkg -i<name of the driver software package command to install the RoCE driver.

    The following commands use Ubuntu 18.04.1 as an example:

    root@ubuntu18041:/home/ubuntu # dpkg -i hiroce-2.3.0.2-4.15.0_29_generic.ubuntu.amd64.deb
    Selecting previously unselected package hiroce.
    (Reading database ... 80445 files and directories currently installed.)
    Preparing to unpack hiroce-2.3.0.2-4.15.0_29_generic.ubuntu.amd64.deb ...
    Unpacking hiroce (2.3.0.2) ...
    Setting up hiroce (2.3.0.2) ...
    Installing... Please wait for a moment.
    Install hiroce driver package successfully.

  9. Make the driver take effect.

    Run the following commands on the OS.

    modprobe hiroce

    service network restart

    NOTE:

    This method takes effect temporarily. If you require the OS to automatically load the driver upon startup, add the preceding two commands to the automatic startup script of the OS.

Follow-up Procedure

Check whether the driver has taken effect after the installation.

  1. Run the lsmod | grep hiroce command on the OS.
    • If no command output is displayed, the driver has not taken effect. Reinstall the driver.
    • If the command output about the IN200 driver is displayed, the driver has taken effect.
  2. Run the hiroce gids command, view the command output, and check whether the driver takes effect.
    • If the command output is displayed, the driver has taken effect.
    • If no command output is displayed, the driver has not taken effect, and you need to perform the operation again.
Translation
Download
Updated: 2019-07-30

Document ID: EDOC1100063073

Views: 8247

Downloads: 46

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