lsmpio 命令
用途
显示有关 MultiPath I/O (MPIO) 存储设备的信息。
语法
lsmpio -a [ -r ] [ -e ] [ -z ]
lsmpio -h
描述
lsmpio 命令显示有关 AIX® MPIO 存储设备的信息。 此命令只能用于由为 lsmpio 命令支持启用的路径控制模块 (PCM) 控制的 AIX MPIO 存储设备。 某些 AIX® MPIO 存储设备不支持 lsmpio 命令查询。 不过，所有AIXMPIO 存储设备都支持路径运行状态查询。
lsmpio 命令显示以下类型的信息:
路径操作状态
您可以运行不带任何标志的 lsmpio 命令，也可以使用 -l 标志来显示路径操作状态。
# lsmpio
name path_id status path_status parent connection
===============================================================================
hdisk1234 0 Enabled Opt,Sel,Deg,Rsv fscsi0 500a098186a7d4ca,0008000000000000
hdisk1234 1 Enabled Non fscsi0 500a098196a7d4ca,0008000000000000
hdisk1234 2 Enabled Opt,Sel fscsi1 500a098186a7d4ca,0008000000000000
hdisk1234 3 Enabled Non fscsi1 500a098196a7d4ca,0008000000000000lspath -F "path_id status parent connection"status列的有效值为启用、禁用、失败或缺失。 扩展的 "path_status字段可能包含一个或多个三个字母的状态缩写，以提供更详细的路径状态。注: 并非所有扩展
path_status 字段都适用于所有 MPIO 存储设备。 仅当存储区域网络 (SAN) 光纤网支持有关 SAN 拥塞的通知时，才会显示某些 path_status 值。path_status字段的可能值如下：- Opt
- 指示 MPIO 磁盘路径是优化路径。 此值指示连接到具有多个控制器的设备中的首选控制器的 MPIO 磁盘路径。 只要可能， PCM 就会选择其中一个首选 MPIO 磁盘路径用于 I/O 操作。
- Non
- 表示 MPIO 磁盘路径为非优化路径。 在具有首选 MPIO 磁盘路径的设备上，不会将此路径视为首选路径。 PCM 避免选择此路径执行 I/O 操作，除非所有首选路径失效。
Chg
- 表示存储目标上 MPIO 磁盘的访问特性正在发生变化。 这种状态是临时的，直到路径转换到新的状态。
- -"
- 表示 MPIO 磁盘路径永久失去数据访问权，在主机中不再可用。 应评估或诊断存储目标可能存在的问题。
- Act
- 指示 MPIO 磁盘路径是具有主动和被动控制器的设备上的主动路径。 PCM 为此类设备上的 I/O 操作选择活动 MPIO 磁盘路径。
- Pas
- 指示 MPIO 磁盘路径是具有主动和被动控制器的设备上的被动路径。 PCM 避免选择被动路径。
- Sel
- 表示在运行 "lsmpio命令时，选择 MPIO 磁盘路径进行 I/O 操作。
- Rsv
- 表示 MPIO 磁盘路径发生意外保留冲突。 此值可能指示用法或配置错误（有多个主机访问同一磁盘）。
- 故障
- 指示 MPIO 磁盘路径发生故障。 路径的路径状态值有可能是启用，但扩展路径状态值仍有可能是Fai。 这种情况表明在此 MPIO 磁盘路径上发送的操作失败，但AIXMPIO 未将该路径标记为 "失败"。 在某些情况下，即使所有 MPIO 磁盘路径都出现错误，AIXMPIO 也会将一条通往设备的路径保留在启用状态。
- Deg
- 指示 MPIO 磁盘路径处于降级状态。 此方案指示 MPIO 磁盘路径正在用于 I/O 操作。 这些操作遇到了错误，从而导致 PCM 临时避免使用该路径。 任何其他错误都可能导致 MPIO 磁盘路径失败。
- 关闭
- 指示 MPIO 磁盘路径已关闭。 如果设备的所有 MPIO 磁盘路径都已关闭，则认为设备已关闭。 如果仅关闭了某些 MPIO 磁盘路径，那么在上次打开设备期间，这些路径可能发生了错误。 AIX MPIO 会定期尝试恢复已关闭的路径，直到设备路径打开为止。
- PFa
- 指示远程端口发生故障。 当 PCM 收到表明 MPIO 磁盘路径使用的远程端口不再属于 SAN Fabric 的事件时，PCM 会将该路径标记为故障路径。 当远程端口重新加入 SAN Fabric 时，PCM 会清除PFa状态。
- PCn
- 指示 SAN 光纤网向 MPIO 磁盘路径所使用的远程端口报告网络流量阻塞。 如果没有网络流量阻塞的其他 MPIO 磁盘路径可用于 MPIO 设备，那么 PCM 不会使用此 MPIO 磁盘路径。 如果 SAN Fabric 未报告任何最近的网络流量拥塞事件，PCM 会自动清除PCn状态。
- PDg
- 指示已降级的远程端口。 即使远程端口的 MPIO 磁盘路径保持活动状态，降级的端口也可能会迂到许多错误。 此类降级端口无法处理数据。 PCM 可避免此类磁盘路径。 要清除端口的降级状态，必须先禁用端口所属交换机上的降级端口，然后再启用该端口。 如果 "
PDg状态在路径上重复出现，请调查路径使用的端口和光纤，以确定 SAN 硬件是否存在问题。 - LCn
- 指示由于向 AIX 适配器发送大量数据或从该适配器发送大量数据，因此与 AIX 适配器关联的链路已拥塞。 如果没有链路拥塞的其他 MPIO 磁盘路径可用，那么 PCM 将避免此类 MPIO 磁盘路径。 如果 SAN Fabric 未报告任何最近的链路拥塞事件，PCM 会自动清除LCn状态。
- 延迟
- 表示新添加到当前打开磁盘的路径。 由于内部限制，无法立即打开和使用 MPIO 磁盘路径。 不过，磁盘路径可以打开，并在下次重新打开磁盘时使用。
- CtlrRstErr
- 表示目标中与 MPIO 磁盘路径相关联的非易失性存储器 express (NVMe) 控制器可能未重置。 启用控制器前需要重置。
- CtlrRdyErr
- 表示目标中与 MPIO 磁盘路径相关联的 NVMe 控制器无法启用（使其就绪）。 控制器必须准备就绪，路径才能工作。
- HostDDErr
- 表示AIX中的 NVMe 主机驱动程序检测到软件错误或系统资源耗尽。
- 脱机
- 表示 NVMe 控制器已被手动设置为脱机状态，无法用于磁盘 I/O 操作。
- AdminCmdErr
- 表示 NVMe 管理命令（如 "Identify）失败。 在 MPIO 磁盘路径初始化期间会发出某些 NVMe 管理命令。 如果命令失败，MPIO 磁盘路径将被标记为失败。
- FabCmdErr
- 表示 NVMe Fabrics 命令（如 "Set Property）失败。 在 MPIO 磁盘路径初始化期间会发出某些 NVMe Fabrics 命令。 如果命令失败，MPIO 磁盘路径将被标记为失败。
- ConnectErr
- 表示 "Connect命令失败。 Connect命令是一条 Fabrics 命令，用于在主机和目标设备中的 NVMe 控制器之间建立关联。 成功连接是建立工作 MPIO 磁盘路径的第一步。
- AuthErr
- 表示目标设备要求主机通过身份验证，但身份验证失败。
- HbaErr
- 表示包含本地连接的 NVMe 硬盘的主机总线适配器发生故障，或其所在的 PCIe 插槽发生故障。 当 NVMe 硬盘在访问系统内存时反复出错时，可能会发生这种情况。
- CrqErr
- 表示 "Create I/O Queue命令失败。 此 NVMe 命令用于在本地连接的 NVMe 硬盘中创建队列。 如果 MPIO 磁盘路径未关联 I/O 队列，则该路径无法使用。
- LinkDwnErr
- 表示主机端口上的光纤通道链路目前处于中断状态。
- FCloginErr
- 表示光纤通道 (FC) 登录（PLOGI、FLOGI或PRLI）失败。
- CassErr
- 表示 "Create Association服务失败。 Create Association服务是一种 NVMe over FC 链接服务，用于在主机和 NVMe 控制器之间建立传输层关联。 在建立通往 FC 连接的 NVMe 存储子系统的路径之前，需要进行此关联。
- CiocErr
- 表示 "Create I/O Connection服务失败。 Create I/O Connection服务是一种 NVMe over FC 链接服务，用于在主机和 NVMe 控制器之间建立传输层 I/O 连接。 在建立通往 FC 连接的 NVMe 存储子系统的路径之前，必须先建立此连接。
- FCDDErr
- 表示AIX中的光纤通道驱动程序遇到软件错误或系统资源耗尽。
- EndpntMiss
- 表示 FC Fabric 上缺少一个或多个 NVMe 存储子系统端口。 存储子系统的物理连接可能已受损。
附加 NVMe 扩展状态
当 MPIO 磁盘路径的状态为 "
Failed时，以下扩展状态可作为路径故障原因的额外详细信息：| 状态 | 描述 |
|---|---|
Offline |
表示磁盘路径已被手动设置为脱机。 除非技术支持人员建议，否则不得手动将路径设置为脱机。 |
FCloginErr, LinkDwnErr, CassErr, CiocErr, EndpntMiss |
指示各种 NVMe over 光纤通道错误条件。 最有可能的情况是 "CassErr，这意味着目标控制器的 "Create Association服务失败。 这通常意味着主机（NQN）没有正确映射到目标设备。 |
CtlrRstErr, CtlrRdyErr, AdminCmdErr, ConnectErr, AuthErr, FabCmdErr, HbaErr, CrqErr |
指示对技术支持人员有用的各种 NVMe 错误条件。 |
FCDDErr, HostDDErr |
指示驱动程序错误，例如超出内部资源限制。 |
路径统计信息
-S 标志以及可选的 -d 标志使 lsmpio 命令显示正常或详细的路径统计信息。 可选的 -l 标志将显示限制为仅包含一个 MPIO 存储设备的统计信息。 统计信息包括 MPIO 磁盘路径被选中进行 I/O 操作的次数、MPIO 磁盘路径发生错误的次数以及 MPIO 磁盘路径发生故障的次数。 详细统计信息会将失败计数拆分为不同类型的失败计数。
设备查询数据
lsmpio 命令的 -q 标志通过使用小型计算机系统接口 (SCSI) 命令来检索和显示有关连接的设备的信息，使 AIX MPIO 查询设备。 由于每个查询的设备都是使用 SCSI 命令打开和查询的，因此对许多设备运行此操作可能需要时间。
父适配器信息
-a 标志以及可选的 -r 标志使 lsmpio 命令显示有关 AIX MPIO 存储设备所使用的光纤通道适配器的信息。 此信息包含有关本地适配器标识的详细信息，例如光纤通道适配器的全球名称以及 MPIO 磁盘路径的当前状态 (如果可用)。 -r 标志添加有关由光纤通道适配器访问的远程端口的信息。
可以使用 -z 标志将所有统计信息重置为零。
标志
| 项 | 描述 |
|---|---|
| -a | 列示父光纤通道适配器信息。 |
| -d | 显示详细统计信息。 该标记仅在使用 "-S标记时有效。 |
| -e | 当此标志与 -a 标志一起使用时，将显示本地适配器端口的错误计数。 当此标志与 -a 和 -r 标志一起使用时，将显示本地适配器端口和远程端口的错误计数。 这些错误计数指示本地适配器与远程存储器端口之间的物理连接存在问题。 这些错误计数还指示不同时间范围的最近错误数。 |
| -h | 显示命令用法信息。 |
| -l 磁盘名 | 指定一个设备。 如果包括此标志，那么此命令作用于单个设备。 如果省略此标志，那么此命令作用于所有 AIX MPIO 设备。 This flag can be used by itself for the summary path status, or with the -q, -S, or -z flags. |
| -o | 指示 AIX 磁盘驱动器尝试访问与指定 MPIO 磁盘相关联的所有多路径 I/O (MPIO)。 此尝试包括访问上次关闭 MPIO 磁盘时标记为失败的 MPIO 路径。 此标志提供有关 MPIO 路径的最新状态。 注意: 如果尝试访问失败的 MPIO 磁盘路径，那么 lsmpio 命令的响应时间可能较慢。 响应时间可延迟几秒或几分钟，具体取决于若干因素，例如受影响的 MPIO 磁盘数和 lsmpio 命令的作用域。
|
| -q | 查询设备信息。 此命令使用标准 SCSI 命令来查询设备以获取信息。 根据设备类型不同，返回的精确信息也会不同。 |
| -r | 显示远程端口信息。 该标记与 "-a标记一起用于显示适配器访问的远程端口信息。 返回的信息可能取决于适配器使用的网络协议。 |
| -S | 显示一个设备或所有设备的统计信息。 此标志显示针对路径用法和路径错误的基本计数器。 如果同时使用 "-d标记，则会显示更详细的统计数据。 |
| -z | 重置所有统计信息。 如果使用此标志，那么会导致 PCM 将所有统计计数器重置为零。 注意：您可以使用 "-z标记和 "-a标记来重置适配器错误计数。
|
安全性
RBAC 用户和可信AIX用户请注意：此命令可执行特权操作。 只有特权用户才能执行特权限定的操作。 有关授权和权限的更多信息，请参阅安全中的特权命令数据库。 要获取与此命令相关联的特权和权限的列表，请参阅
lssecattr 命令或 getcmdattr 子命令。
示例
显示 MPIO 信息的示例：
- 要显示 hdisk1234 设备的摘要信息，请输入以下命令：
系统显示类似以下的输出：lsmpio -l hdisk1234name path_id status path_status parent connection =============================================================================== hdisk1234 0 Enabled Opt,Sel,Deg,Rsv fscsi0 500a098186a7d4ca,0008000000000000 hdisk1234 1 Enabled Non fscsi0 500a098196a7d4ca,0008000000000000 hdisk1234 2 Enabled Opt,Sel fscsi1 500a098186a7d4ca,0008000000000000 hdisk1234 3 Enabled Non fscsi1 500a098196a7d4ca,0008000000000000 - 要显示 hdisk10 设备的详细设备统计信息，请输入以下命令：
系统显示类似以下的输出：lsmpio -Sdl hdisk10Disk: hdisk10 Path statistics since Tue May 21 17:38:43 CDT 2013 Path 0: (fscsi0:500a098186a7d4ca,8000000000000) Path Selections: 0 Adapter Errors: 0 Software: 0 Hardware: 0 Transport Dead: 0 Transport Busy: 0 Transport Fault: 0 No Device Response: 0 Target Port ID Changed: 0 Command Timeouts: 0 Reservation Conflicts: 0 SCSI Queue Full: 0 SCSI Busy: 0 SCSI ACA Active: 0 SCSI Task Aborted: 0 SCSI Aborted Command: 0 SCSI Check Condition: 0 Medium Error: 0 Hardware Error: 0 Not Ready: 0 Other: 0 Last Error: N/A Last Error Time: N/A Path Failure Count: 0 Due to Adapter Error: 0 Due to I/O Error: 0 Due to Health Check: 0 Due to SCSI Sense: 0 Due to Qualifier Bit: 0 Due to Opening Error: 0 Last Path Failure: N/A Last Path Failure Time: N/A注意：如果报告了一些 SCSI 错误计数，这并不表明存在问题，也不表明 I/O 操作失败。 在常规处理过程中，可能会经常报告临时的、可恢复的错误，因此可能会再次尝试 I/O 操作。 - 要显示 MPIO 适配器信息以及远程端口信息，请输入以下命令:
系统显示类似以下的输出：lsmpio -arAdapter Driver: fscsi0 - AIX PCM Adapter WWPN: 10000000c94c7bd6 Link State: Up Paths Paths Paths Paths Remote Ports Enabled Disabled Failed Missing ID 500a098186a7d4ca 31 0 0 0 0x20a00 500a098196a7d4ca 31 0 0 0 0x20b00 500507630a18016b 19 0 0 0 0x31200 500507630a18416b 19 0 0 0 0x31300 500507630a18816b 19 0 0 0 0x31400 500507630a18c16b 19 0 0 0 0x31500 Adapter Driver: fscsi1 - AIX PCM Adapter WWPN: 10000000c94c7bd7 Link State: Up Paths Paths Paths Paths Remote Ports Enabled Disabled Failed Missing ID 500a098186a7d4ca 31 0 0 0 0x20a00 500a098196a7d4ca 31 0 0 0 0x20b00 500507630a18016b 19 0 0 0 0x31200 500507630a18416b 19 0 0 0 0x31300 500507630a18816b 19 0 0 0 0x31400 500507630a18c16b 19 0 0 0 0x31500 5001738000330150 1 0 0 0 0x10100 5001738000330162 1 0 0 0 0x10200 - 要查询 MPIO 存储设备并显示有关该设备的信息，请输入以下命令:
系统显示类似以下的输出：lsmpio -ql hdisk48Device: hdisk48 Vendor Id: IBM Product Id: 2107900 Revision: .160 Capacity: 10G Volume Serial: 600507630AFFC16B0000000000001505 (Page 83 NAA)注: 显示的输出派生自标准查询数据和设备标识重要产品数据 (VPD)。 如果设备代表Peer-to-Peer Remote Copy(PPRC) 对（"san_rep_device属性值为yes），则显示内容包括 PPRC 对中每个逻辑单元编号 (LUN) 的卷序号，以及 PPRC 对中两个 LUN 共享的特定于供应商的 ID，如以下输出所示：Device: hdisk33 Vendor Id: IBM Product Id: 2107900 Revision: .160 Capacity: 10G Volume Serial: 600507630AFFC16B0000000000000113 (Page 83 NAA) Volume Serial: 600507630AFFC16B000000000000031F (Page 83 NAA) Vendor LUN Id: 3735544C37373130313133005022AD6A - 要显示本地端口和远程端口错误计数，请输入以下命令：
输出可能与以下样本相似：lsmpio -areAdapter Driver: fscsi3 -> AIX PCM Adapter WWPN: 21000024ff6aee7d Link State: Up Connectivity Errors: Last 10 Minutes: 74 Last 60 Minutes: 222 Last 24 Hours: 12345 Connectivity Errors Last 10 Last 60 Last 24 Remote Ports Minutes Minutes Hours 5001738000330171 0 0 0 5001738000330173 0 0 0 500a098286a7d4ca 2 9 45 500a098196a7d4ca 72 213 12300