DOCA DPU CLI

本指南提供对 NVIDIA® BlueField® DPU 环境中有用的一组 CLI 命令和实用程序的快速访问。

简介

本指南提供了关于 DOCA 部署和配置的有用命令的简明指南。

本指南中的表格提供了两类命令

用于 Linux/网络环境的通用命令
DOCA/DPU 特定命令

注意

有关这些命令的更多信息，例如用法说明、标志选项、参数等，请在命令后使用 -h 选项或使用手册（例如，man lspci）。

通用命令

命令	描述
`ifconfig`	用于配置内核常驻网络接口。它在启动时用于根据需要设置接口。此后，通常仅在调试或需要系统调优时才需要它。如果未提供任何参数，`ifconfig` 将显示当前活动接口的状态。如果提供单个接口参数，则仅显示给定接口的状态。如果提供单个 `-a` 参数，则显示所有接口的状态，即使是已关闭的接口。否则，它会配置一个接口。
`ethtool <devname>`	用于查询和控制网络设备驱动程序和硬件设置，特别是对于有线以太网设备。 `<devname>` 是 `ethtool` 应在其上运行的网络设备的名称。注意此命令显示 DPU 网卡的速度。
`lspci`	显示系统中 PCIe 总线以及连接到这些总线的设备的信息。默认情况下，它显示设备的简短列表。
`tcpdump`	转储网络上的流量。用法：`tcpdump -i <interface>`，其中 `<interface>` 是任何端口接口（物理/SF rep/VF port rep）。
`ovs-vsctl`	用于查询和配置 `ovs-vswitchd` 的实用程序。`ovs-vsctl` 程序支持 Open vSwitch 实现的桥接模型，其中单个桥接器支持多个 VLAN 上的端口。
`mount 10.0.0.10:/vol/myshare/ myshare/`	用于在 DPU 上挂载工作目录。注意必须在 root 下创建名为 `myshare` 的新目录后使用（即，`mkdir /myshare`）
`scp`	安全复制（远程文件复制程序）。用于将文件从 BlueField 复制到主机，反之亦然。
`iperf`	用于服务器-客户端连接。用于检查网络连接是否达到 DPU 网卡的速度（线速）。

DPU/DOCA 命令

命令	描述
`ibdev2netdev`	显示可用的 `mlnx` 接口
`mst`	用于启动 MST 服务、停止服务以及对 NVIDIA 设备执行其他操作，例如重置和启用远程访问
`cat /etc/mlnx-release`	显示完整的 BlueField 镜像 (bfb) 版本
`cat /etc/os-release`	显示安装在 BlueField 上的底层操作系统的详细信息
`ibv_devinfo`	显示当前 InfiniBand 连接的设备和相关信息。用于检查当前固件版本。
`ipmitool power cycle`	电源循环注意在执行电源循环之前，请确保执行正常关机。
`echo '1024' \| sudo tee -a /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepagessudo mkdir /mnt/hugesudo mount -t hugetlbfs -o pagesize=2M nodev /mnt/huge`	DPDK 设置。为 DPDK 环境抽象层 (EAL) 分配大页。
`mlxdevm tool`	`mlxdevm tool` 位于 `/opt/mellanox/iproute2/sbin/` 下。使用此工具，可以创建 SF 并将其状态设置为 active，配置 HW 地址并将其设置为 trusted，部署创建的 SF 并打印有关它的信息。
`/opt/mellanox/iproute2/sbin/mlxdevm port add pci/<pci_address> flavour pcisf pfnum <correspondig_physical_function_number> sfnum <unique_sf_number>`	以给定的 PF 的风格和给定的唯一 SF 编号创建 SF。示例复制已复制！ /opt/mellanox/iproute2/sbin/mlxdevm port add pci/0000:03`:00.0 flavour pcisf pfnum 0 sfnum 4
`/opt/mellanox/iproute2/sbin/mlxdevm port show`	显示有关可用 SF 的信息
`/opt/mellanox/iproute2/sbin/mlxdevm port function set pci/0000:03:00.0/<sf_index> hw_addr <HW_address> trust on state active`	配置 SF 功能，例如设置 HW 地址，使其“受信任”，并将其状态设置为 active。`<sf_index>` SF。要获取此索引，您可以运行 `mlxdevm port show`。示例复制已复制！ `/opt/mellanox/iproute2/sbin/mlxdevm port function set pci/0000:03:00.0/229377 hw_addr 02:25:f2:8d:a2:4c trust on state active`
`$ echo mlx5_core.sf.<next_serial> > /sys/bus/auxiliary/drivers/mlx5_core.sf_cfg/unbind` `$ echo mlx5_core.sf. <next_serial> > /sys/bus/auxiliary/drivers/mlx5_core.sf/bind`	这两个命令部署创建的 SF。第一个命令将 SF 从默认驱动程序取消绑定，而第二个命令将 SF 绑定到实际驱动程序。部署阶段应在配置 SF 的功能后完成。SF 由 `<next_serial>` 标识，可以通过运行以下命令获得。
`ls /sys/bus/auxiliary/devices/mlx5_core.sf.*`	显示有关已创建 SF 及其“下一个序列号”的附加信息。例如，如果 `mlx5_core.sf.2` 存在于命令的输出中，则运行 `cat /sys/bus/auxiliary/devices/mlx5_core.sf.2/sfnum` 将输出与 `mlx5_core.sf.2` 相关的 sfnum。
`/opt/mellanox/iproute2/sbin/mlxdevm port function set pci/<pci_address>/<sf_index> state inactive` `/opt/mellanox/iproute2/sbin/mlxdevm port del pci/<pci_address>/<sf_index>`	必须执行这两个命令才能删除给定的 SF。首先，用户必须将 SF 的状态设置为 inactive，然后才能删除它。
`/opt/mellanox/iproute2/sbin/mlxdevm port help`	显示有关可用于创建的 SF 端口的操作的附加信息
`crictl pods`	显示当前活动的 K8S Pod 及其 ID（Pod 可能需要 20-30 秒才能启动）
`crictl ps`	显示当前活动的容器及其 ID
`crictl ps -a`	显示所有容器，包括最近完成执行的容器
`crictl logs <container-id>`	检查给定容器的日志
`crictl exec -it <container-id> /bin/bash`	将 shell 附加到正在运行的容器
`journalctl -u kubelet`	检查 Kubelet 日志。当 Pod/容器无法生成时很有用。
`crictl stopp <pod-id>`	停止正在运行的 K8S Pod
`crictl stop <container-id>`	停止正在运行的容器
`crictl rmi <image-id>`	从本地 K8S 注册表中删除容器镜像

本页内容

简介

通用命令

DPU/DOCA 命令