Huawei IN200 User Manual

Ethernet nic
Table of Contents

Advertisement

Huawei IN200 NIC
User Guide
Issue
06
Date
2019-07-27
HUAWEI TECHNOLOGIES CO., LTD.

Advertisement

Table of Contents
loading

Summary of Contents for Huawei IN200

  • Page 1 Huawei IN200 NIC User Guide Issue Date 2019-07-27 HUAWEI TECHNOLOGIES CO., LTD.
  • Page 2 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"...
  • Page 3: About This Document

    User Guide About This Document About This Document Purpose This document describes the IN200 PCIe NIC physical structure, features, specifications, and installation and management methods, as well as how to install and use management tools of the IN200. Intended Audience...
  • Page 4 Windows in 6 Management Tools. l Added 2.3 Maintaining the RoCE Driver. l Added 3 Configuring SR-IOV. 2019-01-30 This issue is the third official release. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 5 Huawei IN200 NIC User Guide About This Document Issue Date Description 2018-08-10 This issue is the second official release. 2018-05-20 This issue is the first official release. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 6: Table Of Contents

    2.2.2 Installing the Driver..............................12 2.2.3 Upgrading the Driver..............................15 2.2.4 Uninstalling the Driver.............................. 17 2.3 Maintaining the RoCE Driver............................19 2.3.1 Preparing OSs Supported by Huawei In-House OFED.....................19 2.3.2 Installing the Driver..............................19 2.3.3 Upgrading the Driver..............................23 2.3.4 Uninstalling the Driver.............................. 26 2.4 Upgrading the IN200 Firmware........................... 27 3 Configuring SR-IOV........................29...
  • Page 7 6.1.4.15 Querying and Setting the Auto-Negotiation Mode of a Specified Device (autoneg)...........74 6.1.4.16 Querying the Queue Information of a Specified Device (nic_queue)..............75 6.1.4.17 Querying and Setting the Work Mode of a Specified Device (mode)..............76 Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 8 6.1.4.42.2 Configuring a Management VLAN (-t cpath_vlan -v -s)................103 6.1.4.42.3 Deleting the Configured Management VLAN (-t cpath_vlan -v -c)............... 104 6.1.4.42.4 Querying the TX Rate Limit of a Specified PF (-t pf_tx_rate)................104 Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 9 7.2 Restarting the Server..............................121 7.3 Transferring a File Using the Virtual Directory......................123 7.4 Common BIOS Configuration............................123 A FAQ............................. 131 A.1 An Exception Occurs During Driver Installation or Uninstallation................131 B Acronyms and Abbreviations....................132 Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd. viii...
  • Page 10: Getting To Know The In200

    1.5 System Requirements 1.1 Overview The IN200 Ethernet NIC (IN200 for short) is a PCIe card for Huawei servers. It supports four 25GE SFP28 optical ports as external service ports. The IN200 is a PCIe card based on the Huawei HiSilicon Hi1822 NIC chip. It supports PCIe 3.0 x16 and Inter-integrated Circuit (I...
  • Page 11: Physical Structure

    Huawei IN200 NIC User Guide 1 Getting to Know the IN200 1.2 Physical Structure Components Figure 1-2 shows the components of the IN200. Figure 1-2 IN200 components Bracket PCIe connector Hi1822+heat sink Mainboard Table 1-1 describes the components of the IN200.
  • Page 12 SFP28 optical port 2 SFP28 optical port 3 SFP28 optical port 4 Active/Link indicator Speed indicator Indicators The indicators display the working status of the IN200. Table 1-2 describes the indicators on the IN200 panel. Table 1-2 Indicator description Indicator...
  • Page 13: Features

    Half-height half-length PCIe x16 card with a half-height or full-height bracket, applicable for various application scenarios. Huawei HiSilicon Hi1822 NIC chip, up to four 25GE SFP28 ports, and excellent compatibility with the x86 architecture. Supports 25GE, 10GE, and GE modes.
  • Page 14: Technical Specifications

    Supports Ethernet port auto-negotiation. NOTE l The IN200 supports the Legacy and UEFI modes. The PXE is not supported in Legacy mode. l The GE mode supports only GE optical modules, basic packet receiving and sending, and stateless offload, and does not support features such as SR-IOV, DPDK, and RoCE.
  • Page 15 Huawei IN200 NIC User Guide 1 Getting to Know the IN200 Software Requirements Table 1-4 lists the OSs supported by the IN200 NIC. Table 1-4 Supported OSs by the IN200 NIC x86 version ARM version BCLinux CentOS 6.8/6.9/6.10/7.0/7.1/7.2/7.3/7.4/7.5/7.6 7.4/7.5/7.6 Citrix 7.1/7.2/7.3/7.4/7.5/7.6...
  • Page 16 Huawei IN200 NIC User Guide 1 Getting to Know the IN200 x86 version ARM version EulerOS V2.0 SP3 V2.0 SP3/V2.0 SP8 V2R5/V3R0 V2R5 NOTE The preceding OSs are for reference only. For details about the OSs that can be purchased, see the Intelligent Computing Compatibility Checker or consult the local Huawei sales representatives.
  • Page 17: Installation And Maintenance

    2 Installation and Maintenance Installation and Maintenance The IN200 is a standard PCIe card. Its hardware installation method is the same as that of a common NIC. For details about how to install the IN200, see the user guide of the target server.
  • Page 18 *.sh Management \collect_scripts Tool - NOTE hinicadm This is a one-click information collection script, which is also applicable to the ARM platform. Linux_arm tools\linux_arm *.rpm or *.deb \nic\ tools\linux_arm *.sh \nic\collect_scripts Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 19: Maintaining The Nic Driver

    Boot mode) and gpg public key of the installation package. (Optional) Importing the SUSE PLDP Certificate Before installing the IN200 driver on the server in the BIOS UEFI safe mode, import the SUSE PLDP UEFI certificate in the BIOS to support the certificated IN200 driver.
  • Page 20 Step 2 Upload the public file such as gpg-pubkey-c2bea7e6-4c2de264.asc to any directory of the operating system on the server. Step 3 Run the rpm --import command to import the public key to the operating system. rpm --import gpg-pubkey-c2bea7e6-4c2de264.asc ----End Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 21: Installing The Driver

    2 Installation and Maintenance 2.2.2 Installing the Driver Prerequisites The driver package of the IN200 has been downloaded. The NIC driver package is included in the IN200 software package. For details about how to obtain the IN200 package, see 2.1 Obtaining Software Packages.
  • Page 22 For details, see 7.1 Logging In to the Real-Time Server Desktop. Step 2 Go to the directory where the driver package is stored, for example, "C:\". Step 3 Install the driver package. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 23 – If no command output is displayed, the driver has not taken effect, and you need to perform the operation again. – If the command output about the IN200 driver is displayed, the driver has taken effect. Run the version command to query the current driver version using hinicadm tool.
  • Page 24: Upgrading The Driver

    The driver of the IN200 already exists in the server OS. The driver package of the IN200 has been downloaded. The NIC driver is included in the IN200 software package. For details about how to obtain the IN200 package, see 2.1 Obtaining Software...
  • Page 25 Run the reboot command on the OS. Method 2: Check that the current IN200 program has stopped. Run the rmmod hinic on the OS to install the existing driver. Run the modprobe hinic command on the OS to load the new driver.
  • Page 26: Uninstalling The Driver

    After the driver is installed, you can run the version command to query the current driver version using hinicadm tool. 2.2.4 Uninstalling the Driver Prerequisites The driver of the IN200 already exists on the OS. To upgrade the driver corresponding to SUSE Linux, ensure that the preparations are ready. For details, see 2.2.1 Preparations (SUSE Linux).
  • Page 27 Desktop. Step 2 Click , choose Control Panel > Programs and Features. Step 3 Right-click the HinicDriver program name for example "Huawei IN200 Ethernet Controller Driver", choose Uninstall/Change from the short-cut menu. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 28: Maintaining The Roce Driver

    2.3 Maintaining the RoCE Driver 2.3.1 Preparing OSs Supported by Huawei In-House OFED Before running RDMA over Converged Ethernet (RoCE) services on the IN200, you need to install the OpenFabrics Enterprise Distribution (OFED) and RoCE drivers in advance. OFED software packages are classified into Huawei in-house and non-Huawei OFED software packages.
  • Page 29 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).
  • Page 30 Setting up hiroce (2.3.0.2) ... Installing... Please wait for a moment. Install hiroce driver package successfully. Step 8 Make the driver take effect. Run the following commands on the OS. modprobe hiroce service network restart Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 31 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. ----End On the OS Supported by Non-Huawei OFED Step 1 Log in to the OS of the standby server. For details, see 7.1 Logging In to the Real-Time Server...
  • Page 32: Upgrading The Driver

    – 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. Run the hiroce gids command, view the command output, and check whether the driver takes effect.
  • Page 33 The upgrade process cannot be interrupted. During the upgrade, the OS cannot be restarted. Otherwise, the OS may be abnormal or cannot be started. On the OS Supported by Huawei In-House OFED Step 1 Log in to the server OS.
  • Page 34 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. ----End On the OS Supported by Non-Huawei OFED Step 1 Log in to the OS of the standby server. For details, see 7.1 Logging In to the Real-Time Server...
  • Page 35: Uninstalling The Driver

    2.3.4 Uninstalling the Driver Prerequisites The RoCE driver already exists on the OS. Impact During the uninstallation, the OS cannot be restarted. Otherwise, the OS may be abnormal or cannot be started. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 36: Upgrading The In200 Firmware

    On the OS supported by Huawei in-house OFED, run the bash uninstall.sh command to uninstall the OFED driver. On the OS supported by non-Huawei OFED, run the rpm -e X or dpkg -r X command to uninstall the OFED driver.
  • Page 37 ----End Follow-up Procedure After the firmware upgrade is complete, you can run the hinicadm version -i hinicX command to query the IN200 firmware version to confirm that the upgrade is successful. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 38: Configuring Sr-Iov

    Huawei IN200 NIC User Guide 3 Configuring SR-IOV Configuring SR-IOV When the IN200 works in an SR-IOV environment, enable SR-IOV in the kernel to ensure good performance. 3.1 x86 Version 3.2 ARM Version 3.1 x86 Version 3.1.1 Configuring the Server BIOSs The following uses the BIOS of the 2288H V5 as an example to describe how to enable the SR-IOV function in the BIOS.
  • Page 39 Press F11 to access the BIOS screen, as shown in Figure 3-2. Go to Step Figure 3-2 BIOS screen (1) If the BIOS version is V658 or later, the message shown in Figure 3-3 is displayed. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 40 Figure 3-4 BIOS screen (2) Step 4 Use arrow keys to select BIOS Configuration in the lower right corner and press Enter. The Setup Utility configuration screen is displayed. Go to Step Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 41 Step 7 Use arrow keys to select Peripheral Configuration and press Enter. The Peripheral Configuration configuration screen is displayed, as shown in Figure 3-6. Set PCIe SR-IOV to Enbled. Press Esc to return to the Advanced screen. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 42 3 Configuring SR-IOV Figure 3-6 Peripheral Configuration screen Step 8 Use the arrow keys to select Socket Configuration and press Enter to access the Socket Configuration screen, as shown in Figure 3-7. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 43 3 Configuring SR-IOV Figure 3-7 Socket Configuration screen Step 9 Use arrow keys to select IIO Configuration and press Enter to access the IIO Configuration screen, as shown in Figure 3-8. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 44 Step 10 Use arrow keys to select Intel(R) TV for Directed I/O (TV-d) and press Enter to access the Intel(R) TV for Directed I/O (TV-d) screen, as shown in Figure 3-9. Set Intel(R) TV for Directed I/O (TV-d) to Enabled. Press Esc to exit the screen. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 45: Modifying The Grub Configuration File

    Step 1 Run the following command to check whether SR-IOV is enabled: If yes, no further action is required. If no, go to Step Step 2 In the system, run the find command to search for the GRUB file. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 46: Arm Version

    Step 1 Log in to the real-time server desktop using the Remote Virtual Console. For details, see 7.1 Logging In to the Real-Time Server Desktop. Step 2 Restart the server. Step 3 Press Delete when the information shown in Figure 3-10 is displayed. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 47 Huawei IN200 NIC User Guide 3 Configuring SR-IOV Figure 3-10 Startup information The Setup Utility screen is displayed, as shown in Figure 3-11. Figure 3-11 Setup Utility screen Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 48 Step 5 Press ↓ or ↑ to select MISI Config and press Enter. The MISI Config screen is displayed. Step 6 Set Support Smmu to Enabled and keep default values of other options, as shown in Figure 3-13. Press F10 to exit BIOS configuration. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 49: Modifying The Grub Configuration File

    Step 1 Run the following command to check whether SR-IOV is enabled: If yes, no further action is required. If no, go to Step Step 2 In the system, run the find command to search for the GRUB file. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 50 Step 4 Restart the system. reboot Step 5 Check whether intel_iommu=on iommu=pt is added to /proc/cmdline. If yes, no further action is required. If no, repeat Step 2 Step ----End Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 51: Configuring Qos

    4.2 Configuring Flow Control 4.1 Overview of Flow Control IN200 flow control is enabled by default. You can run the ethtool -a DEV_NAME command to query the status of flow control. Enabling PFC disables flow control. The QoS can be configured only when the RoCE driver is used.
  • Page 52: Configuring Roce Bonding

    Figure 5-1 shows Active-backup mode1. Figure 5-1 Active-backup mode1 Balance-XOR mode2: Data is transmitted based on the selected hash policy. This mode provides load balancing and fault tolerance capabilities. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 53: Preparing Oss Supported By The Roce Bonding

    You can implement bonding by creating, destroying, and configuring bonding devices using commands or a configuration file. NetworkManager is not recommended for bonding configuration. Prerequisites The RoCE driver package of the IN200 NIC has been installed. The VLAN has been configured. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 54: Using Commands

    Step 1 Log in to the server OS as the root user, right-click the OS desktop, and choose Open Terminal from the shortcut menu. Step 2 Run the following command to find the port in the up state: ibdev2netdev Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 55 After the modification is complete, press Esc to exit editing mode and enter :wq! to save the modification and exit. Step 6 Run the following command to restart the network: service network restart ----End Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 56: Management Tools

    Management Tools 6.1 Customized Management Tool - hinicadm 6.2 Standard Management Tools 6.1 Customized Management Tool - hinicadm The hinicadm is a management tool customized for the IN200. You can use this tool to manage the IN200. 6.1.1 Installing hinicadm Prerequisites The hinicadm installation package has been downloaded.
  • Page 57: Using Hinicadm

    3. Enter hinicadm.exe<major cmd> <minor cmd> <parameter> …<minor cmd> <parameter>. Obtaining Help Information When using the hinicadm tool, you can use the following commands to obtain help information: Obtaining the tool version information Short command: hinicadm -v Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 58: Command List

    Queries the chip temperature and optical module temperature. event Queries asynchronous event statistics. clear Clears statistics. Queries and Sets the User Priority For Linux only and CGE Pause Time Queries the device register information. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 59 These commands can be used only after the iommu (for an x86 version) or Smmu (for an ARM version) parameter is enabled in the SR-IOV pass- through mode. For details, see Configuring SR-IOV. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 60: Command Reference

    This section describes the meanings, parameters, and usage of the common commands of the hinicadm tool. For more information about the commands, you can run the -h command on the hinicadm. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 61: Querying The Version Information Of A Device (Version)

    1.2.0.0 hinic driver: 1.2.0.0 6.1.4.2 Querying Basic Information (info) Function The info command is used to query basic information about all IN200s or a specified IN200 on a server. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 62: Collecting Logs (Log)

    Example: hinic0 and IN200 to be queried in the hinic1 system. Usage Instruction None Example # Query information about all the IN200 cards in the server. [root@localhost tool]# hinicadm info Hi1822 device Information Card PCIe Function |---- hinic0(ETH) |------------ 08:00.0 (NIC:eth5) |------------ 08:00.1 (NIC:eth6)
  • Page 63: Collecting All Firmware Logs Of A Specified Device (-A)

    Example: hinic0 and IN200 to be queried in the hinic1 system. Usage Instruction None Example # Query all logs on a specified IN200. [root@localhost tool]# hinicadm log -i hinic0 -a /opt/hinic/fwlog/ucode_flash_hinic0_2018_01_15_17_05_41.log create succeed. /opt/hinic/fwlog/ucode_ram_hinic0_2018_01_15_17_05_41.log create succeed. /opt/hinic/fwlog/ucode_lastword_flash_hinic0_2018_01_15_17_05_41.log create succeed. /opt/hinic/fwlog/up_lastword_flash_hinic0_2018_01_15_17_05_41.log create succeed.
  • Page 64: Parsing Run Logs Offline (-O1)

    4: indicates the last words of the firmware and microcode. Usage Instruction None Example # Query the firmware logs in the flash memory on a specified IN200. [root@localhost tool]# hinicadm log -i hinic0 -t 1 /opt/hinic/fwlog/ up_flash_hinic0_2018_01_15_17_05_41.log create succeed. 6.1.4.3.3 Parsing Run Logs Offline (-o1) Function The log -o1 command is used to parse firmware and microcode run logs offline and save the parsing results to /opt/hinic/fwlog in the tool installation directory.
  • Page 65: Parsing Last Words Offline (-O2)

    Indicates the name of the log file to be parsed. Example: err_log.bin NOTE This file is the out-of-band run log file of the IN200 obtained using the one-click information collection function of the iBMC. For details about the file obtaining method and save path, see the iBMC User Guide.
  • Page 66: Exporting Windows System Event Logs (-E)

    Indicates the name of the last-word file to be parsed. Example: last_word.bin NOTE This file is the out-of-band last-word file of the IN200 obtained using the one-click information collection function of the iBMC. For details about the file obtaining method and save path, see the iBMC User Guide.
  • Page 67: Upgrading Firmware (Updatefw)

    -i <devicename> -f <fwfile> Parameters Parameter Description Value devicename Indicates the name of the Example: hinic0 and IN200 to be upgraded in the hinic1 system. fwfile Indicates the path to the Format: Path/Upgrade firmware upgrade package. package name...
  • Page 68: Hot-Upgrading Firmware (-F, -A)

    Huawei IN200 NIC User Guide 6 Management Tools NOTE Currently, the IN200 firmware is upgraded as a whole. Therefore, do not use this command for the upgrade. To perform the upgrade, see Cold-Upgrading All Firmware (-f). Format hinicadm updatefw -i <devicename> -f <fwfile> -c <configfile>...
  • Page 69: Activating Firmware (-A)

    If the command does not contain -t, all firmware is activated. Usage Instruction None Example # Upgrade abd activate the IN200 firmware. [root@localhost tool]#hinicadm updatefw -i hinic0 -f ./Hi1822_nic_std_4_25G.bin - a now Please do not remove driver or network device. Loading...
  • Page 70: Querying Statistics (Counter)

    Parameter Description Value devicename Indicates the name Example: hinic0 and hinic1 of the IN200 to be upgraded in the system. Usage Instruction Before running this command, ensure that hot-upgraded firmware that has not been activated exists in the system. Example # Activate firmware.
  • Page 71 127 mag:err_mag_rf_lf: 252 mag:err_mag_linkdown: 250 mag:err_mag_linkup: 127 …… # Query the microcode statistics of the IN200. [root@localhost tool]# hinicadm counter -i hinic0 -t 1 uCode Statistics: NIC MIB TX UC Counter: func1:tx_uc: 0x00000193b7694888 00000000197c70de func76:tx_uc: 0x0000000002e9c940 00000000000b4b76...
  • Page 72: Parsing Inspection Information Offline (-O)

    User Guide 6 Management Tools func76:tx_mc: 0x00000000000001b6 0000000000000005 …… # Query the statistics of a specified sequence of the microcode type of the IN200. [root@localhost tool]# hinicadm counter -i hinic0 -t 1 -x 1 uCode Statistics: NIC MIB TX BC Counter:...
  • Page 73 If the value of tabletype is 4, the value of tableindex ranges from 0 to 4095. Usage Instruction None Example # Query information about the linear table of the IN200. [root@localhost tool]# hinicadm table -i hinic0 -t 0 static er_id vlan_id forward_type...
  • Page 74: Querying Mac Addresses (Mac)

    Example: hinic0 and IN200 to be queried in the hinic1 system. Usage Instruction None Example # Query the MAC address of the IN200. [root@localhost tool]# hinicadm mac -i hinic0 mac[0]: 00:02:03:04:05:06 mac[1]: 00:02:03:04:05:07 mac[2]: 00:02:03:04:05:08 mac[3]: 00:02:03:04:05:09 mac[4]: 00:02:03:04:05:10 mac[5]: 00:02:03:04:05:11...
  • Page 75: Querying And Setting The Port Fec Mode (Fec)

    Usage Instruction None Example # Query the FEC mode of port 0 of the IN200. [root@localhost tool]# hinicadm fec -i hinic0 -p 0 Port0 FEC mode: nofec 6.1.4.8.2 Setting the Port FEC Mode (-p -m)
  • Page 76: Clearing Existing Configurations (-P -C)

    FEC mode is install; otherwise, the original mode is used. Example # Set the FEC mode of port 0 of the IN200 to rsfec and use persistent configurations. [root@localhost tool]# hinicadm nic_fec -i hinic0 -p 0 -m rsfec -d Set default FEC mode succeed.
  • Page 77: Querying And Setting A Port Rate Limit (Rate)

    Parameter Description Value devicename Indicates the name of the Example: eth0 and eth1 IN200 port to be set or queried in the system. limitvalue Indicates the percentage of the An integer ranging from 1 actual transmit rate to the to 100 maximum rate of the port.
  • Page 78: Querying The Chip And Optical Module Temperatures (Temperature)

    IN200 to be queried in the hinic1 system. Usage Instruction None Example # Query the chip and optical module temperatures of the IN200. [root@localhost tool]# hinicadm temperature -i hinic0 current temperature (unit: degree centigrade) controller: 55 sfp1: 59 sfp2: absent...
  • Page 79: Querying Asynchronous Event Statistics (Event)

    IN200 to be queried in the hinic1 system. Usage Instruction None Example # Query asynchronous event statistics of the IN200. [root@localhost tool]# hinicadm event -i hinic0 SDK Statistics: Heartbeat Lost Counter: heartbeat lost: 0 CQM Counter: cqm cmd alloc: 0...
  • Page 80: Clearing Statistics Of A Specified Device (Clear)

    # Clear the asynchronous event statistics of the IN200. [root@localhost]# hinicadm clear -i hinic0 -t 0 Clear event stats succeed. # Clear the I/O statistics of the eth0 port on the IN200. [root@localhost]# hinicadm clear -i eth0 -t 2 Clear driver stats succeed.
  • Page 81: Querying And Setting The User Priority And Cge Pause Time (Qos)

    Usage Instruction None Example # Set the user priority of the IN200 to 6 5 3 0. [root@localhost tool]# hinicadm qos -i hinic0 -c 6530 Set cos2up succeed. # Query the user priority of the IN200. Issue 06 (2019-07-27)
  • Page 82: Querying The Registerinformation Of A Specified Device (Reg)

    -i <devicename> -t <registertype> -a <address> [-n <num>] [-c <channel>] Parameters Parameter Description Value devicename Indicates the name of the Example: hinic0 and IN200 to be queried in the hinic1 system. registertype Indicates the type of the l 0: mag register register to be queried l 1: read register...
  • Page 83: Querying And Setting The Auto-Negotiation Mode Of A Specified Device (Autoneg)

    Usage Instruction None Example # Set the auto-negotiation mode of port 1 on the IN200 to ieee. [root@localhost tool]# hinicadm autoneg -i hinic0 -p 1 -m ieee Set port1 auto-negotiation mode to ieee mode succeed. # Query the auto-negotiation mode of port 1 on the IN200.
  • Page 84: Querying The Queue Information Of A Specified Device (Nic_Queue)

    Usage Instruction None Example # Query the queue information of eth0 on the IN200. [root@localhost tool]# hinicadm nic_queue -i eth0 -d 1 -t 0 -q 0 Receive queue0 information: Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 85: Querying And Setting The Work Mode Of A Specified Device (Mode)

    [root@localhost tool]# hinicadm mode -i hinic0 -m ovs Set work mode to ovs succeed. Please reboot OS for the new mode to take effect. # Query the IN200 work mode. [root@localhost tool]# hinicadm mode -i hinic0 Current work mode: NIC Work mode in permanent configuration: OVS 6.1.4.18 Querying FE Error Information (fe_epc)
  • Page 86: Obtaining Fe Error Information Of A Specified Device (Show)

    Usage Instruction The -b is used to display all abnormal records. Example # Query all the error information about history FE threads of the IN200. [root@localhost tool]# hinicadm fe_epc -i hinic0 show -b index: 192 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00...
  • Page 87: Triggering A Fe Thread And Recording Error Information (-C -T)

    Usage Instruction If the command contains -a, all the threads are triggered. Example # Query all the error information about all FE threads of the IN200. [root@localhost tool]# hinicadm fe_epc -i hinic0 -a index: 192 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00...
  • Page 88: Querying Basic Information Of A Specified Port (Hilink_Port)

    -i <devicename> -p <portid> Parameters Parameter Description Value devicename Indicates the name of the Example: hinic0 or hinic1 IN200 to be queried in the system. portid Indicates the number of a port to be queried. Usage Instruction None Example # Queries basic information of port 0.
  • Page 89: Querying Statistics Of A Specified Port (Hilink_Count)

    -i <devicename> -p <portid> Parameters Parameter Description Value devicename Indicates the name of the Example: hinic0 or hinic1 IN200 to be queried in the system. portid Indicates the number of a port to be queried. Usage Instruction None Example # Query statistics of port 0.
  • Page 90: Querying Physical Parameters Of A Device In Specified Mode (Hilink_Param)

    6 Management Tools Parameters Parameter Description Value devicename Indicates the name of the Example: hinic0 or hinic1 IN200 to be queried in the system. portid Indicates the port number to be queried. Usage Instruction None Example # Queries information about the an_train register numbered 0.
  • Page 91: Querying And Setting Port Rate Parameters (Hilink_Speed)

    -i <devicename> -p <portid> Parameters Parameter Description Value devicename Indicates the name of the Example: hinic0 or hinic1 IN200 to be configured in the system. portid Indicates the number of the port to be set. Usage Instruction None Example # Query the transmission rate of port 0.
  • Page 92: Setting The Transmission Rate Of A Specified Port (-S)

    -i <devicename> -p <portid> -s <speed> [-d] Parameters Parameter Description Value devicename Indicates the name of the Example: hinic0 or hinic1 IN200 to be configured in the system. portid Indicates the number of the port to be set. speed Indicates the port rate 10 or 25 when the auto-negotiation mode is disabled.
  • Page 93: Setting The Network Port Connection Mode (-M)

    6 Management Tools Parameters Parameter Description Value devicename Indicates the name of the Example: hinic0 or hinic1 IN200 to be configured in the system. portid Indicates the number of the port to be set. l on state Indicates whether the...
  • Page 94: Clearing Rate Permanence Configuration Of A Specified Port (-C)

    Parameters Parameter Description Value devicename Indicates the name of the Example: hinic0 or hinic1 IN200 to be configured in the system. portid Indicates the number of the port to be set. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 95: Querying The Serdes Information Of A Specified Configuration Type (Serdes)

    1: hi16 or hi30 macro Indicates the macro digit. Usage Instruction If the value of ethdevicename is an IN200 name, this command queies serdes information of all ports of the NIC. Example # Queries serdes information of the hinic0 port.
  • Page 96: Querying Optical Module Information Of A Specified Port (Sfp)

    Parameter Description Value devicename Indicates the name of the Example: hinic0 or hinic1 IN200 to be queried in the system. portid Indicates the number of a port This parameter takes effect when type is to be queried. set to 1.
  • Page 97: Querying And Setting The Virtualization Control Status Of A Port (Sriov)

    Parameters Parameter Description Value devicename Indicates the name of the Example: hinic0 and hinic1 IN200 to be queried or set in the system. portid Indicates the number of the port to be queried or set in the system. sriov Indicates the status of the l enable virtualization control mode.
  • Page 98: Restoring Factory Settings (Reset)

    Pf3 restore factory settings succeed. Please reboot OS to take effect. 6.1.4.28 Querying Chip Back Pressure Information (bp) Function The bp command is used to query chip back pressure information of the IN200. Format hinicadm bp -i <devicename> Issue 06 (2019-07-27)
  • Page 99: Querying Statistics On Chip Data Path Modules (Dp)

    Example: hinic0 and hinic1 target IN200 in the system. Usage Instruction None Example # Query chip back pressure information of the IN200. [root@localhost tool]#hinicadm bp -i hinic0 ===[ Hi1822 backpressure info]=== ********** Hi1822 TX bp history counter ********** *** TX link level ***...
  • Page 100: Querying The Status Of A Microcode Threads (Tile_Io)

    Parameters Parameter Description Value devicename Indicates the name of the Example: hinic0 and hinic1 target IN200 in the system. Usage Instruction None Example # Query the status of microcode threads. [root@localhost tool]#hinicadm tile_io -i hinic0 *************** tile IO status ***************...
  • Page 101: Querying The Usage Of Chip Cpb Cells (Cpb)

    Parameter Description Value devicename Indicates the name of the Example: hinic0 and hinic1 target IN200 in the system. Usage Instruction None Example # Query the usage of chip CPB cells. [root@localhost tool]#hinicadm cpb -i hinic0 ****** CPB CELL NUM STATIC ******...
  • Page 102: Writing Chip Register (Csr_Wr)

    Parameters Parameter Description Value devicename Indicates the name of the Example: hinic0 and hinic1 target IN200 in the system. module name Module type. cpb, ipsurx, ipsutx, qu, pe, esch, mqm, lcam, sml0, sml1, smf, tile0, ppe0, tile1, or ppe1 address...
  • Page 103: Reading Chip Register Values In Batches (Csr_Dump)

    Usage Instruction Stop the services before running this command. Do not run this command twice on the same IN200. When this command is run, the registers of the chip cannot be read or written. Example # Read and save the register values of the hinic0 chip in batches.
  • Page 104: Queryingthe Cpb Cell Resource Allocation And Current Resource Usage (Pdm)

    Description Value devicename Indicates the name of the Example: hinic0 and hinic1 IN200 whose FEC mode is to be queried in the system. module name Indicates the resource type. all, glb, pg, tx, rx, yzone, rzone, nport, ncos, host, hsrv, hport, hpri, hep, or...
  • Page 105: Querying The Interrupt Information Reported By A Hardware Module (Fm_Show)

    Description Value devicename Indicates the name of the Example: hinic0 and hinic1 IN200 whose FEC mode is to be queried in the system. module name Indicates the resource type. all, glb, pg, tx, rx, yzone, rzone, nport, ncos, host, hsrv, hport, hpri, hep, or...
  • Page 106: Querying And Setting The Status Of The Port Auto-Adaptation Mode (Self_Adaption)

    Parameter Description Value devicename Indicates the name of the Example: hinic0 and hinic1 IN200 whose FEC mode is to be queried in the system. Usage Instruction None Example # Display the interrupt information reported by the hinic0 hardware module. [root@localhost ~]# hinicadm fm_show -i hinic0 ********no fm info!******** 6.1.4.37 Querying and Setting the Status of the Port Auto-adaptation Mode...
  • Page 107: Querying And Setting The Lro Coalesce Time (Lro)

    Parameters Parameter Description Value devicename Indicates the name of the Example: hinic0 and IN200 whose FEC mode is to hinic1 be queried in the system. Usage Instruction None Example # Query the LRO coalesce time. [root@localhost tool]# hinicadm lro -i hinic0 LRO coalesce time: 10us.
  • Page 108: Querying The Statistics Of Received And Sent Packets Of A Nic Port (Xstats)

    Parameters Parameter Description Value devicename Indicates the name of the Example: hinic0 and IN200 whose FEC mode is to hinic1 be set in the system. lro coalesce time Indicates the coalesce time. The value is an integer Unit: us ranging from 1 to 1024.
  • Page 109: Querying And Setting The Interrupt Coalescence Parameters (Inter_Coal)

    <usecs_low>] [-pl <pend_low>] [-rh <rate_high>] [-uh <usecs_high>] [-ph <pend_high>] Parameters Parameter Description Value devicename Indicates the name of the Example: hinic0 or hinic1 IN200 to be queried in the system. coal_timer Indicates the coalescence time. pend_limit Indicates the number of coalescence packets. rate_low Indicates the lower threshold of the packet rate.
  • Page 110: Querying And Setting The Sdi Card Mode (Sdi_Mode)

    Parameters Parameter Description Value devicename Indicates the name of the Example: hinic0 and IN200 whose FEC mode is to hinic1 be queried in the system. Usage Instruction None Example # Query the SDI card mode. linux-EXvCVE:~ # hinicadm sdi_mode -i hinic0...
  • Page 111: Setting The Sdi Card Mode (-M)

    Parameters Parameter Description Value devicename Indicates the name of the Example: hinic0 and IN200 whose FEC mode is to hinic1 be set in the system. mode Indicates the SDI card mode. l vm: virtual machine mode l bm: bare-metal mode...
  • Page 112: Configuring A Management Vlan (-T Cpath_Vlan -V -S)

    Parameters Parameter Description Value devicename Indicates the name of the Example: hinic0 and IN200 whose FEC mode is to hinic1 be queried in the system. Usage Instruction None Example # Query the configured management VLAN. linux-xvUVkf:~ # hinicadm sdi_cfg -i hinic0 -t cpath_vlan None control path vlan configured.
  • Page 113: Deleting The Configured Management Vlan (-T Cpath_Vlan -V -C)

    Parameters Parameter Description Value devicename Indicates the name of the Example: hinic0 and IN200 whose FEC mode is to hinic1 be set in the system. vlan Indicates the VLAN ID. It is an integer ranging from 0 to 4095. Usage Instruction...
  • Page 114: Setting The Tx Rate Limit Of A Specified Pf (-T Pf_Tx_Rate -L)

    Parameters Parameter Description Value devicename Indicates the name of the IN200 Example: hinic0 and hinic1 whose FEC mode is to be set in the system. cir,cbs,pir,pbs Indicates the TX rate limit. l The unit of cir and pir is kbit/s.
  • Page 115: Querying The Rx Rate Limit Of A Specified Pf (-T Pf_Rx_Rate)

    Parameters Parameter Description Value devicename Indicates the name of the Example: hinic0 and IN200 whose FEC mode is to hinic1 be set in the system. Usage Instruction None Example # Delete the TX rate limit of a specified eth4 device.
  • Page 116: Setting The Rx Rate Limit Of A Specified Pf (-T Pf_Rx_Rate -L)

    Parameter Description Value devicename Indicates the name of the Example: hinic0 and IN200 whose FEC mode is to hinic1 be set in the system. cir,cbs Indicates the TX rate limit. l The unit of cir is kbit/s. l The unit of cbs is kbit.
  • Page 117: Querying The Real-Time Traffic Sent And Received By Each Port Of A Nic Where A Roce Device Is Located (Roce_Port_Traffic)

    0.000000 0.000 0.000000 | 1 0.000 0.000000 0.000 0.000000 | 0.004 0.000768 0.004 0.001024 | 3 0.000 0.000000 0.000 0.000000 | | port tx(Mpps) tx(Gbps) rx(Mpps) rx(Gbps) | port tx(Mpps) tx(Gbps) rx(Mpps) Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 118: Setting Nic Packet Data To Be Sent And Triggering Nic Packet Sending When Ac Power Is Lost (Reboot_Notice)

    Description Value devicename Indicates the name of the Example: hinic0 and hinic1 IN200 whose FEC mode is to be queried in the system. mode Reads packet data to be sent l read: obtains packet data to be sent from the NIC, or writes data from the NIC and saves the data to the to the NIC.
  • Page 119: Querying And Setting The Dcb Function (Dcb)

    Parameters Parameter Description Value devicename Indicates the name of the For example, the value can IN200 to be queried and set in be enp6s0 or enp7s0. the system. mode Enables or disables the DCB l 1: Enables the DCB function.
  • Page 120: Setting The Ets Function (Ets)

    Parameters Parameter Description Value devicename Indicates the name of the For example, the value can IN200 to be queried and set in be enp6s0 or enp7s0. the system. l 1: Enables PFC. mode Enables or disables the PFC function. l 0: Disables PFC.
  • Page 121: Setting Sp Scheduling (-T)

    Parameters Parameter Description Value devicename Indicates the name of the For example, the value can IN200 to be queried and set in be enp6s0 or enp7s0. the system. mode Enables or disables the ETS l 1: enables ETS. function. l 0: disables ETS.
  • Page 122: Setting Dwrr Scheduling (-T -P)

    Parameters Parameter Description Value devicename Indicates the name of the For example, the value can IN200 to be queried and set in be enp6s0 or enp7s0. the system. mode Enables or disables the ETS l 1: enables ETS. function. l 0: disables ETS.
  • Page 123: Upgrading Hinicadm

    RPM Package: Run the rpm -Uvh hinicadm-<version>-<release>.<arch>.rpm command. Example: linux-uueJIR:/Hi1822/tools/linux # rpm -Uvh hinicadm-1.2.8.0-1.x86_64.rpm Preparing... ################################# [100%] Updating / installing... 1:hinicadm-1.2.8.0-1 ################################# [ 50%] Cleaning up / removing... 2:hinicadm-1.2.7.0-1 ################################# [100%] Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 124: Uninstalling Hinicadm

    If you don't need them, you can delete them manually. ----End Uninstalling hinicadm from Microsoft Windows Step 1 Log in to the server OS. For details, see 7.1 Logging In to the Real-Time Server Desktop. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 125: Standard Management Tools

    6.2 Standard Management Tools The ethtool, ifconfig, ip link, vconfig, and dcbtool tools are standard NIC management tools delivered with the Linux system. They can be used to configure and manage the IN200 because the IN200 is a standard PCIe card.
  • Page 126 -L ethx Configures the number of queues. Some ethtool standard commands are not applicable to an IN200, and their functions are substituted by hinicadm. For example: l ethtool -e: provides the eeprom burning function, which is used in NIC firmware update.
  • Page 127 Sets the link status of the virtual network port. <staus> Table 6-5 lists the common vconfig commands supported by the IN200 and their functions. For details about how to use the commands, see the help information provided on the CLI. Table 6-5 Common vconfig commands...
  • Page 128: Appendix

    For example, set the IP address to 192.168.2.10 and the subnet mask to 255.255.255.0. Step 2 Log in to the iBMC WebUI. Open a browser, enter https://IP address of the iBMC management network port in the address box, and press Enter. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 129 – If HTML5 is integrated, click HTML5 Integrated Remote Console. The following uses the Java integrated Remote Virtual Console as an example. The Remote Virtual Console screen is displayed, as shown in Figure 7-2. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 130: Restarting The Server

    For details, see 7.1 Logging In to the Real-Time Server Desktop. Step 2 In the navigation tree, choose Power > Power Control. The Power Control page is displayed, as shown in Figure 7-3. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 131 For details, see 7.1 Logging In to the Real-Time Server Desktop. Step 2 On the toolbar of the Remote Virtual Console, click The power control menu is displayed, as shown in Figure 7-4. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 132: Transferring A File Using The Virtual Directory

    The device type and location of a virtual directory varies depending on the operating system type. For details, see the official website of each respective OS vendor. ----End 7.4 Common BIOS Configuration The following uses the BIOS of the 2288H V5 as an example. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 133 If the BIOS version is V363 or earlier, the message shown in Figure 7-6 is displayed. Figure 7-6 Startup information (1) Press F11 to access the BIOS screen, as shown in Figure 7-7. Go to Step Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 134 If the BIOS version is V658 or later, the message shown in Figure 7-8 is displayed. Figure 7-8 Startup information (2) Press Delete to access the BIOS screen, as shown in Figure 7-9. Go to Step Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 135 Figure 7-9 Front Page screen (2) Step 4 Use arrow keys to select Device Manager and press Enter. The Device Manager screen is displayed, as shown in Figure 7-10. Figure 7-10 Device Manager screen Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 136 Figure 7-11 Network Device List screen Step 6 Select the MAC address of the target NIC, and press Enter. The NIC configuration screen is displayed, as shown in Figure 7-12. Figure 7-12 NIC configuration screen Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 137 Huawei IN200 NIC User Guide 7 Appendix Step 7 Select Huawei Network Adapter Configuration and press Enter. The Huawei Network Adapter Configuration screen is displayed, as shown in Figure 7-13. Figure 7-13 Huawei Network Adapter Configuration screen Table 7-1 describes the parameters on the Huawei Network Adapter Configuration screen.
  • Page 138 – 100GE, NO FEC – 40GE, NO FEC – 40GE, BASE FEC SRIOV Control Specifies whether to enable the SRIOV l ON function for the port. The default value l OFF is ON. Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 139 Reset to Factory Specifies whether to restore the port to l Disable Default factory settings. l Enable Step 8 Set parameters as required. Step 9 Save the settings and exit. ----End Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 140: A Faq

    Step 2 Open the registry and find the name of the residual registry entries. The paths are HKEY_LOCAL_MACHINE\DRIVERS\DriverDatabase\DriverPackages \hinic.inf_amd64xxxx . Step 3 Open the cmd window and run the following command to delete the residual registry entries. PsExec.exe -d -i -s reg delete HKEY_LOCAL_MACHINE\DRIVERS\DriverDatabase \DriverPackages\hinic.inf_amd64xxxx /f ----End Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 141: B Acronyms And Abbreviations

    Data Center Bridging DPDK Data Plane Development Kit Enhanced Transmission Selection Forward Error Correction Inter-integrated Circuit large receive offload LACP Link Aggregation Control Protocol Media Access Control MCTP Management Component Transport Protocol Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.
  • Page 142 Receive Side Scaling SMBus System Management Bus SR-IOV Single Root I/O Virtualization Traffic Classifier TCP Segmentation Offload UEFI Unified Extensible Firmware Interface VLAN Virtual Local Area Network VXLAN Virtual eXensible Local Area Network Issue 06 (2019-07-27) Copyright © Huawei Technologies Co., Ltd.

Table of Contents