文档目录

问题说明

本文用于排查“云平台无法识别 USB 设备”相关问题,适用于 ZStack Cloud 环境中同类现象的初步定位和处理。

适用环境

  • 产品:ZCF
  • 组件:Cloud
  • 版本:3.x-5.5.30

可能原因

USB 设备的 iSerial 字段过长,导致云平台无法识别设备。

排查步骤

  1. 执行以下命令,查询所有 USB 设备详情信息,判断物理机是否识别 USB 设备:
  [root@localhost ~]# lsusb.py -u
  1. 执行以下命令,查看单个 USB 设备详情信息,检查 iSerial 字段是否过长:
  [root@localhost ~]# lsusb -v -d  1908:1320
  1. 执行以下命令,调整数据库中 UsbDeviceVO 的 iSerial 字段字符串长度:
Note:

修改数据库表结构前,需备份管理节点数据库,并确认该操作适用于当前版本。建议在技术支持指导下执行。

  [root@localhost ~]# mysql -uroot -pzstack.mysql.password
  MariaDB [(none)]> ALTER TABLE `zstack`.`UsbDeviceVO` modify column iSerial varchar(1024) DEFAULT NULL;
  1. 升级云平台至 4.0 以上版本即可解决上述问题。
云平台无法识别 USB 设备,怎么办? | 故障排查 · KB | ZStack 资源中心