chpath 命令

用途

更改支持多路径 I/O (MPIO) 的设备的路径操作状态,或者更改支持 MPIO 的设备的路径关联属性。

语法

chpath -dev 名称 -opOpStatus [ -pdev 父设备 ] [ -conn 连接 ]

奇路 -开发 名称 -pdev 父代 [ -康恩 连接 ] [ -佩尔姆 ] -属性 属性 = 值...

描述

chpath 命令用于更改指定设备(-dev Name 标志)的路径的操作状态,或者更改与指定设备的特定路径关联的一个或多个属性。 根据要进行的更改,所需语法略有不同。

此处提及的第一个语法将更改特定设备的一条或多条路径的操作状态。 要更改的这组路径将通过接受符合以下条件的这组路径来获取:
  • 目标设备与指定的设备匹配。
  • 父设备与指定的父设备 (-pdev Parent) 匹配(如果指定了父设备)。
  • 连接与指定的连接 (-conn Connection) 匹配(如果指定了连接)。
  • 路径状态为 PATH_AVAILABLE

路径的操作状态指作为 MPIO 路径选择一部分的路径的用法。 值 enable 表示将使用该路径,而 disable 表示不使用该路径。 应该注意的是,将路径设置为 disable 会影响今后的 I/O,而不会影响已在进行中的 I/O。 因此,可以禁用路径,但仍会运行未完成的 I/O,直到已在进行中的所有 I/O 完成为止。 同样,如果对路径指定了 -op disable,而在该路径上 I/O 未完成,那么将显示此事实。

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

此处提到的第二个语法将更改一个或多个特定于路径的属性,这些属性与特定设备的特定路径相关联。 请注意,可以在 chpath 命令的单一调用中更改多个属性。 但所有属性都必须与单一路径相关联。 换句话说,不能在 chpath 命令的单一调用中通过多条路径更改属性。 要跨多条路径更改属性,需要分别调用 chpath;对要更改的每条路径进行一个调用。

标志

标志名称 描述
-attr 属性 = 值 标识要更改的属性和该属性的新值。 Attribute 是特定于路径的属性的名称。 Value 是要替换 Attribute 的当前值的值。 Attribute=Value 参数可以将一个或多个属性值对用于一个 -attr 标志。 如果您将 -attr 标志与多个属性值对配合使用,那么属性值对的列表必须括在引号中,并且对与对之间以空格分隔。 例如,输入 -attr Attribute=Value 将对每个标志列示一个属性值对,而输入 -attr 'Attribute1=Value1 Attribute2=Value2' 将列示多个属性值对。
-dev Name 对于受更改影响的一条或多条路径,指定目标设备的逻辑设备名。 此标志在所有情况下都是必需的。
-pdev 父级 指示父设备的逻辑设备名称以在限定要更改的路径时使用。 更改属性时,此标志是必需的,但更改操作状态时,此标志是可选的。
-烫头发 更改路径的特征,而不更改路径。 下次取消配置路径然后再进行配置(可能是下一次引导)时,更改对路径生效。
-conn 连接 指示连接信息以在限定要更改的路径时使用。 在更改操作状态时,此标志是可选的。 当更改属性时,如果设备只具有一条到指示的父设备的路径,那么它是可选的。 如果有多条从父设备到该设备的路径,那么此标志是标识要更改的特定路径所必需的。
-op OpStatus 指示一种操作状态,所指示路径的状态必须更改为此状态。 在设备驱动程序级别维护路径的操作状态。 路径的操作状态确定路径选择期间是否考虑该路径。 此标志的允许值为:
启用
对于 MPIO 路径选择,将操作状态标记为 enabled。 在路径选择期间,将考虑使用具有此状态的路径。 请注意,启用路径是从失败情况中恢复路径的唯一方法。
禁用
对于 MPIO 路径选择,将操作状态标记为 disabled。 在路径选择期间,不会考虑使用具有此状态的路径。
更改操作状态时,此标志是必需的。 与 -attr Attribute=Value 标志配合使用时,将生成用法错误。

退出状态

请参阅 Virtual I/O Server 命令的退出状态

示例

  1. 要禁用 scsi0hdisk1 磁盘设备之间的路径,请输入:
    chpath -dev hdisk1 -pdev scsi0 -op disable
    系统显示类似下列其中一项的消息:
    paths disabled
    some paths disabled
    第一条消息表示已成功启用从 scsi0hdisk1 的所有 PATH_AVAILABLE 路径。 第二条消息表示只成功禁用了从 scsi0hdisk1 的部分 PATH_AVAILABLE 路径。