Documentation
Rate This Document
Findability
Accuracy
Completeness
Readability
SubmitClose

Obtaining RoCE NIC and Switch Configurations

Function

This script connects the host and switch in SSH mode and uses commands to obtain the ai-fabric, ai-ecn, and PFC parameters of the switch and the PFC and DCQCN of the RoCE NIC on the target host and in the local environment. It also provides configuration suggestions and details by comparison.

  • The system must be AArch64, and the target environment must support SSH commands.
  • The script output displayed in green indicates that the configuration is proper, the output displayed in blue indicates the obtained result only, and the output displayed in red indicates that the configuration is improper.
  • Unless otherwise specified, script parameters can be combined.

Procedure

  1. Go to the /usr/bin/malluma_tools directory and view how to use the script.
    cd /usr/bin/malluma_tools
./roce_check -h
    Table 1 Script parameter description

    Parameter

    Description

    -e,--exchanges <arg>

    Obtains the IP address of the switch. The format of <arg> is username@IP:PORT. If the port number is not specified, port 22 is used by default. Use slashes (/) to separate multiple switches.

    -o,--hosts <arg>

    Obtains the IP address of the server. The format of <arg> is username@IP:PORT. If the port number is not specified, port 22 is used by default. Use slashes (/) to separate multiple servers.

    -E,--exchange-file <filePath>

    Obtains the switch address in a file. <filePath> indicates the absolute or relative path of the file. Each line in the file indicates a remote connection. The format is username@IP:PORT (the port number can be omitted).

    -O,--host-file <filePath>

    Obtains the server address in a file. <filePath> indicates the absolute or relative path of the file. Each line in the file indicates a remote connection. The format is username@IP:PORT (the port number can be omitted).

    -v,--verbose

    Obtains the detailed configurations of the switch and target host and writes the configurations to roce_check_default in the current directory. This parameter must be used together with -e/-o/-E/-O/-l. To change the directory location, use -d.

    -d <dir>

    Specifies the directory to which the detailed configurations of the switch and target host are written. This parameter must be used together with -v. In other cases, this parameter is invalid. <dir> indicates the file path of the specified directory.

    -l,--local

    Obtains the RoCE NIC configuration of the local server.

    -h,--help

    Obtains help information.
  2. Obtain the RoCE NIC configuration.
    ./roce_check -o username@IP:port

    View parameters PFC and DCQCN of the RoCE NIC. If you do not specify the port number, port 22 is used by default.

  3. Obtain switch parameters.
    ./roce_check -e username@IP:port

    View the parameters ai-fabric, ai-ecn, and PFC of the switch. If you do not specify the port number, port 22 is used by default.

Parent topic: Common Operations