chpath 命令

在线编辑

用途

将路径的操作状态更改为具有多路径 I/O (MPIO) 能力的设备，或将与路径关联的属性更改为具有 MPIO 能力的设备。

语法

chpath -l Name -sOpStatus [ -p 父节点 ] [ -w 连接 ] [ -iPathID ]

奇路 -我 名称 -p 父代 [ -w 连接 ] [ - ] - 属性=值 [ - 属性=值 ... ] [ -g ]

chpath -l Name -i PathID [ -P ] -a Attribute=Value [ -a Attribute=Value ...]

chpath -h

描述

chpath 命令将路径的操作状态更改为指定的设备（-l Name 标志），或者它将一个或多个与特定路径关联的属性更改为指定的设备。 取决于进行的更改，要求的语法略有不同。

上边显示的第一个语法将一条或多条路径的操作状态更改为特定的设备。 通过接受匹配以下标准的路径集来获取要更改的路径集：
  • 目标设备匹配指定的设备。
  • 如果指定了父设备，那么父设备匹配指定的父设备 (-p Parent)。
  • 如果指定了连接，那么连接匹配指定的连接 (-w Connection)。
  • 路径状态是 PATH_AVAILABLE。

路径的操作状态指作为 MPIO 路径选择一部分的路径的用法。 值 enable 表示要使用该路径，而 disable 表示不使用该路径。 应该注意到，将路径设置为 disable 会影响将来的 I/O，而不是已在进行之中的 I/O。 同样，可以禁用路径，但仍然具有未完成的 I/O，直到已在进行中的所有 I/O 完成为止。 同样，如果为路径指定了 -s disable，而在该路径上 I/O 未完成，那么这一事实将输出。

禁用某条路径在设备驱动程序级别影响路径选择。 在设备配置数据库中不更改路径的 path_status。 必须使用 lspath 命令查看路径的当前操作状态。

上面显示的第二个语法将与特殊路径关联的一条或多条路径的特殊属性更改为特殊设备。 请注意，可以在 chpath 命令的单一调用中更改多个属性；但所有的属性都必须与单一路径关联。 换句话说，不能在 chpath 命令的单一调用中通过多条路径更改属性。 要通过多条路径更改属性，需要 chpath 的分别调用；要更改的每条路径进行一个调用。

标志

项 描述
-a 属性=值 标识要更改的属性和属性的新值。 Attribute 是路径特定的属性的名称。 Value 是要替换 Attribute 的当前值的值。 可以指定 -a Attribute=Value 的多个实例以更改多个属性。
-g 强制更改路径操作在已锁定设备上发生。
-h 显示命令用法的消息。
-i PathID 指示受更改影响的路径的标识。 此标志用于唯一地标识路径。
-l 名称 为更改影响的路径指定目标设备的逻辑设备名称。 在所有情况下都需要此标志。
-p 父级 指示父设备的逻辑设备名称以在限定要更改的路径时使用。 当更改属性时要求此标志，但在更改操作状态时该标志可选。
-P 在 ODM 对象类中永久性更改路径的特征，而实际上不更改路径。 下一次路径取消配置然后再配置（可能是下一次引导）时，更改在路径上生效。
-w 连接 指示连接信息以在限定要更改的路径时使用。 在更改操作状态时，此标志是可选的。 当更改属性时，如果设备只具有一条到指示的父设备的路径，那么它是可选的。 如果有多条从父设备到该设备的路径，那么要求此标志标识要更改的特定路径。
-s OpStatus 指示所指示的路径应该更改到的操作状态。 在设备驱动程序级别维护路径的操作状态。 它确定在执行路径选择时是否将考虑路径。 此标志的允许值为：
enable
对于 MPIO 路径选择，将操作状态标记为 enabled。 带有此状态的路径将考虑在执行路径选择时使用。 请注意启用路径是从 failed 条件恢复路径的唯一方式。
禁用
对于 MPIO 路径选择，将操作状态标记为 disabled。 带有此状态的路径将不考虑在执行路径选择时使用。
当更改操作状态时，要求此标志。 当与 -a Attribute =Value 标志一起使用时，生成用法错误。

安全性

特权控制：只有 root 用户和 system 组的成员对于该命令具有执行访问权限。

审计事件：
事件 信息
DEV_Change chpath 命令行。

示例

  1. 要禁用 scsi0 和 hdisk1 磁盘设备之间的路径，请输入：
    chpath -l hdisk1 -p scsi0 -s disable
    系统显示类似下列其中一项的消息：
    paths disabled
    或
    some paths disabled
    第一条消息指示已成功禁用从 scsi0 到 hdisk1 的所有 PATH_AVAILABLE 路径。 第二条消息指示只成功禁用了从 scsi0 到 hdisk1 的一些 PATH_AVAILABLE 路径。

文件

项 描述
/usr/sbin/chpath 包含 chpath 命令。

相关信息

lspath 命令， mkpath 命令， rmpath 命令。