AIX命令参考大全,卷 1,a - c - chpath 命令

[ 页的底部 | 上一页 | 下一页 | 目录 | 索引 | 法律条款 ]

AIX命令参考大全,卷 1,a - c

chpath 命令

用途

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

语法

chpath -l Name -s OpStatus [ -p Parent ] [ -w Connection ]

chpath -l Name -p Parent [ -w Connection ] [ -P ] -a Attribute=Value [ -a Attribute=Value ... ]

chpath -h

描述

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

上边显示的第一个语法将一条或多条路径的操作状态更改为特定的设备。通过接受匹配以下标准的路径集来获取要更改的路径集:

路径的操作状态指作为 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 是路径特定的属性的名称。Value 是要替换 Attribute 的当前值的值。可以指定 -a Attribute=Value 的多个实例以更改多个属性。
-h 显示命令用法消息。
-l Name 为更改影响的路径指定目标设备的逻辑设备名称。在所有情况下都要求此标志。
-p Parent 指示父设备的逻辑设备名称以在限定要更改的路径时使用。当更改属性时要求此标志,但在更改操作状态时该标志可选。
-P 在 ODM 对象类中永久性更改路径的特征,而实际上不更改路径。下一次路径取消配置然后再配置(可能是下一次引导)时,更改在路径上生效。
-w Connection 指示连接信息以在限定要更改的路径时使用。在更改操作状态时,此标志是可选的。 当更改属性时,如果设备只具有一条到指示的父设备的路径,则它是可选的。如果有多条从父设备到该设备的路径,则要求此标志标识要更改的特定路径。
-s OpStatus 指示所指示的路径应该更改到的操作状态。在设备驱动程序级别维护路径的操作状态。它确定在执行路径选择时是否考虑路径。此标志的允许值为:
enable
对于 MPIO 路径选择,将操作状态标记为 enabled。带有此状态的路径将考虑在执行路径选择时使用。请注意启用路径是从 failed 条件恢复路径的唯一方式。
disable
对于 MPIO 路径选择,将操作状态标记为 disabled。带有此状态的路径将不考虑在执行路径选择时使用。
当更改操作状态时,要求此标志。当与 -a Attribute=Value 标志一起使用时,生成用法错误。

安全性

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

审计事件:

事件 信息
DEV_Change chpath 命令行。

示例

  1. 要禁用 scsi0hdisk1 磁盘设备之间的路径,请输入:
    chpath -l hdisk1 -p scsi0 -s disable
    系统显示类似于以下各项之一的消息:
    路径已禁用
    或者
    启用了一些路径
    第一条消息表示已成功启用从 scsi0hdisk1 的所有 PATH_AVAILABLE 路径。第二条消息指示只成功禁用了从 scsi0hdisk1 的一些 PATH_AVAILABLE 路径。

文件

/usr/sbin/chpath 包含 chpath 命令。

相关信息

lspath 命令、mkpath 命令和 rmpath 命令。

[ 页的顶部 | 上一页 | 下一页 | 目录 | 索引 | 法律条款 ]