powermt 命令简介
powermt 命令简介
PowerPath 将多路径 I/O 功能、自动负载平衡和路径故障切换功能集成于一身，使存储管理更加轻松。本文总结了 PowerPath 常用命令的使用方法操作注意事项，为主机系统管理员对 HBA/ 路径 / 端口 / 磁盘设备 / 存储系统执行配置、查看、删除、保存、恢复等操作提供参考。
powermt 语法
[root@ora27 ~]# powermt -h
Usage:
powermt <command>
[class={all|symm|vnx|clariion|vplex|invista|netapp|hitachi|hpxp|ess|xtremio|generic}]
powermt check [hba=<hba#>|all] [dev=<path>|<device>|all] [class=<class>|all]
[force]
powermt check_registration
powermt config
powermt disable hba=<hba#>
powermt display [dev=<device>|all] [class=<class>|all] [every=<#seconds>]
[wide|width=<#col>]
powermt display alua dev=<device>|all [class=<class>|all] [every=<#seconds>]
[wide|width=<#col>]
powermt display hba_mode [class=<class>|all]
powermt display latency [dev=<device>|all] [class=<class>|all]
[every=<#seconds>] [wide|width=<#col>]
powermt display nonvirtual dev=<device>|all
[every=<#seconds>] [class=<class>|all] [wide|width=<#col>]
powermt display options
powermt display bus [class=<class>|all] [every=<#seconds>]
[wide|width=<#col>]
powermt display perf dev=<device>|all [continuous] [verbose] [xml] [nowait]
powermt display perf bus [continuous] [verbose] [xml] [nowait]
powermt display port_mode [class=<class>|all]
powermt display ports [dev=<device>|all] [class=<class>|all]
[every=<#seconds>] [wide|width=<#col>]
powermt display unmanaged
powermt enable hba=<hba#>
powermt help [<command>]
powermt load [file=<filename>]
powermt manage dev=<path>|<device> | class=<class>
powermt release
powermt remove hba=<hba#>|all | dev=<path>|<device>|all [class=<class>|all]
[force]
powermt restore [hba=<hba#>|all] dev=<path>|<device>|all [class=<class>|all]
powermt save [file=<filename>]
powermt set all_paths_dead_retry_timeout={default|<#seconds>} [class=<class>|all]
powermt set autostandby={on|off|reinitialize}
[trigger={prox|iopf}]
powermt set autostandby iopflimit=<value>
powermt set autostandby agingperiod={<#days>|<#hours>h|<#hours>H}
powermt set auto_host_registration={on|off}
powermt set mode={active|standby} [hba=<hba#>|all]
[dev=<path>|<device>|all] [class=<class>|all] [force]
powermt set path_latency_monitor={on|off}
powermt set path_latency_threshold=<#seconds>|<#milliseconds>ms
powermt set path_retry_timeout={default|<#seconds>} [class=<class>|all]
powermt set perfmon={on [interval=<#seconds>] | off}
powermt set periodic_autorestore={on|off} [class=<class>|all]
powermt set policy={ad|co|lb|li|re|rr|so|si}
[dev=<device>|all] [class=<class>|all]
powermt set port_disable={on|off} dev=<device>
powermt set reactive_autorestore={on|off} [class=<class>|all]
powermt set streamio_threshold=<threshold_count>
[dev=<device>|all] [class=<class>|all]
powermt set port_mode={active|standby} dev=<path> [force]
powermt unmanage dev=<path>|<device> | class=<class>
powermt update lun_names
powermt version
[root@ora27 ~]#
更多信息
power check
功能：检查 PowerPath 配置
平台：所有 PowerPath 平台
存储系统：所有存储系统
格式： powermt check
[class=symm|clariion|ess|hitachi|hpxp|hphsx|invista|all][force][reconfig]
注释：对路径进行检查，并在需要的情况下从 PowerPath 配置中中删除标记为 dead 的路径。
如果路径标记为 dead 或路径配置信息中的序列号与本地设备序列号不符，则出现如下提示用户删除路径：
Warning: storage_system I/O path path_name is dead.
Do you want to remove it (y/n/a/q)?
y ：删除 dead path ， 并继续检查剩余路径；
n ：不删除 dead path ，但继续检查剩余路径；
a ：删除 dead path 以及后续所有标记为 dead 的路径；
q ：不删除 dead path 并退出该命令。已删除路径保持删除状态。
参数：
class=symm|clariion|ess|hitachi|hpxp|hphsx|invista|all ：限制命令检查指定存储类型，默认为 all ；
force ：禁止出现确认提示并删除所有标记为 dead 的路径；
hba=hba#|all ：限制检查指定的 HBA 。默认为 all ；
dev=path|device|all ：限制检查指定的 path ，或指定 device 的所有 path 。默认为 all 。
reconfig ：重新配置不匹配路径。该命令只对 Windows 和 Solaris 有效。
powermt check_registration
功能：检查 license 信息
平台：所有 PowerPath 平台
存储系统：所有存储系统
格式： powermt check_registration
注释：检查主机上 PowerPath license 信息：有效、过期、无效或没有 license 。
powermt config
功能：为逻辑设备配置路径
平台： UNIX 和 Linux 平台
存储系统：所有存储系统
格式： powermt config
注释：将检测到的所有 Symmetrix 和 Clariion 逻辑磁盘设备配置为 PowerPath 磁盘设备并将它们加入 PowerPath 配置，同时对所支持的第三方存储系统逻辑设备。
该命令同时将所有检测到的路径配置给 PowerPath 磁盘设备并将这些路径加到 PowerPath 配置中。
之前配置的路径成为 dead path 时该命令不会将其删除。
powermt disable hba
功能：禁用 HBA 端口
平台： AIX 和 Solaris 的光纤通道， HP-UX 的 iSCSI 和光纤通道， Linux 的 iSCSI 和光纤通道
存储系统：所有存储系统
格式： powermt disable hba=hba
注释：禁用指定 HBA 配置的所有路径。停止端口上所有 I/O ，关闭端口配置的所有磁盘设备。
用户在更换 HBA 停止其上的 I/O 时需执行此命令。禁用 HBA 端口后，所有通过 HBA 端口配置的路径在命令 powermt display dev=device 的输出中被打上 Dead 标签。
注意如下限制条件：
· 禁用的 HBA 在主机重启后将不再存在；
· 如果 PowerPath 负载均衡和 failover 策略为 bf 或 nr 时此命令会返回失败。
查看 HBA 状态为禁用或激活，使用命令 powermt display hba_mode 。
参数：
hba=hba ： 使用主机上 HBA ID 来禁用指定 HBA 端口，例如： 1280 。
powermt display
功能：监控 HBA 和磁盘设备
平台：所有 PowerPath 平台
存储系统：所有存储系统
格式：
powermt display [paths|ports]
[class=symm|clariion|ess|hitachi|hpxp|hphsx|invista|all]
powermt display [ports] [dev=device|all]
[class=symm|clariion|ess|hitachi|hpxp|hphsx|invista|all]
参数：
paths ：每一行显示一条路径信息
[root@irora27 ~]# powermt display paths
Symmetrix logical device count=26
==============================================================================
----- Host Bus Adapters --------- ------ Storage System ----- - I/O Paths -
### HW Path ID Interface Total Dead
==============================================================================
4 lpfc 000498700534 FA 2e:00 26 0
4 lpfc 000498700534 FA 1e:00 26 0
5 lpfc 000498700534 FA 2g:00 26 0
5 lpfc 000498700534 FA 1g:00 26 0
[root@irora27 ~]#
行显示一条端口信息
[root@irora27 ~]# powermt display ports
Storage class = Symmetrix
==============================================================================
----------- Storage System --------------- -- I/O Paths -- --- Stats ---
ID Interface Wt_Q Total Dead Q-IOs Errors
==============================================================================
000498700534 FA 2g:00 256 26 0 0 0
000498700534 FA 1g:00 256 26 0 0 0
000498700534 FA 2e:00 256 26 0 0 0
000498700534 FA 1e:00 256 26 0 0 0
[root@irora27 ~]#
dev=device|all ：显示指定磁盘设备信息， all 显示所有磁盘设备。
class=symm|clariion|ess|hitachi|hpxp|hphsx|invista|all ：列出指定存储系统信息， all 显示所有存储系统。默认为 all 。
[root@ora27 ~]# powermt display dev=all |head -n42
Pseudo name=emcpowera
Symmetrix ID=000498700534
Logical device ID=036D
Device WWN=60000970000498700534533030333644
state=alive; policy=SymmOpt; queued-IOs=0
==============================================================================
--------------- Host --------------- - Stor - -- I/O Path -- -- Stats ---
### HW Path I/O Paths Interf. Mode State Q-IOs Errors
==============================================================================
5 lpfc sdck FA 2g:00 active alive 0 0
5 lpfc sdbo FA 1g:00 active alive 0 0
4 lpfc sdas FA 2e:00 active alive 0 0
4 lpfc sdw FA 1e:00 active alive 0 0
Pseudo name=emcpowerb
Symmetrix ID=000498700534
Logical device ID=02F1
Device WWN=60000970000498700534533030324631
state=alive; policy=SymmOpt; queued-IOs=0
==============================================================================
--------------- Host --------------- - Stor - -- I/O Path -- -- Stats ---
### HW Path I/O Paths Interf. Mode State Q-IOs Errors
==============================================================================
5 lpfc sdcj FA 2g:00 active alive 0 0
5 lpfc sdbn FA 1g:00 active alive 0 0
4 lpfc sdar FA 2e:00 active alive 0 0
4 lpfc sdv FA 1e:00 active alive 0 0
Pseudo name=emcpowerc
Symmetrix ID=000498700534
Logical device ID=02ED
Device WWN=60000970000498700534533030324544
state=alive; policy=SymmOpt; queued-IOs=0
==============================================================================
--------------- Host --------------- - Stor - -- I/O Path -- -- Stats ---
### HW Path I/O Paths Interf. Mode State Q-IOs Errors
==============================================================================
5 lpfc sdci FA 2g:00 active alive 0 0
5 lpfc sdbm FA 1g:00 active alive 0 0
4 lpfc sdaq FA 2e:00 active alive 0 0
4 lpfc sdu FA 1e:00 active alive 0 0
[root@ora27 ~]#
powermt display hba_mode
功能：监控 HBA 模式
平台： UNIX 和 Linux 平台
存储系统：所有存储系统
格式： powermt display hba_mode
注释：显示主机上配置所有 HBA 信息。列出 HBA 的激活或禁用状态。
[root@irora27 ~]# powermt display hba_mode
Symmetrix logical device count=26
==============================================================================
----- Host Bus Adapters --------- ------ I/O Paths ----- Stats
### HW Path Summary Total Dead Q-IOs Mode
==============================================================================
4 lpfc optimal 52 0 0 Enabled
5 lpfc optimal 52 0 0 Enabled
[root@irora27 ~]#
powermt display port_mode
功能：显示存储系统端口模式
平台： UNIX 和 Linux 平台
存储系统：所有存储系统
格式： powermt display port_mode dev=device
注释：显示主机上配置所有端口模式信息。列出 HBA 的激活或禁用状态。
参数：
dev=device ： 指定需要查看的磁盘设备端口。磁盘设备名需为 native 设备名。
[root@irora27 ~]# powermt display port_mode
Storage class = Symmetrix
==============================================================================
----------- Storage System --------------- -- I/O Paths -- --- Stats ---
ID Interface Wt_Q Total Dead Q-IOs Mode
==============================================================================
000498700534 FA 2g:00 256 26 0 0 Enabled
000498700534 FA 1g:00 256 26 0 0 Enabled
000498700534 FA 2e:00 256 26 0 0 Enabled
000498700534 FA 1e:00 256 26 0 0 Enabled
[root@irora27 ~]#
powermt enable hba
功能：激活 HBA 端口
平台： AIX 和 Solaris 的光纤通道， HP-UX 的 iSCSI 和光纤通道， Linux 的 iSCSI 和光纤通道
存储系统：所有存储系统
格式： powermt enable hba=hba
注释：激活之前禁用的 HBA 端口。运行此命令恢复指定 HBA 端口及其磁盘设备的 I/O 。如果 PowerPath 负载均衡及 failover 模式为 bf 或 nr 则命令会返回失败。
参数：
hba=hba 激活指定 hba 端口。
powermt load
功能：加载用户配置
平台：所有 PowerPath 平台
存储系统：所有存储系统
格式： powermt load
[class=symm|clariion|ess|hitachi|hpxp|hphsx|invista|all]
[file=pathname]
注释：将以下内容从已保存的配置文件读出并应用于当前配置： PowerPath 磁盘设备策略和优先级；写阀值设定和写队列深度；周期性自动还原设定和路径模式。
如果配置是由 powermt save 命令保存在默认文件名，在系统启动时将会自动加载该配置，（ AIX 除外，总是在启动时加载默认配置）；如果没有使用默认文件名，配置不会在启动时自动加载，用户需使用 powermt load 命令手动加载配置。
参数：
class=symm|clariion|ess|hitachi|hpxp|hphsx|invista|all ：将命令限制在指定存储系统，默认为 all 。
file=pathname ：保存配置文件的全路径名。
powermt manage
功能：将磁盘设备或存储系统放入 PowerPath 管理
平台： UNIX 和 Linux 平台
存储系统：所有存储系统
格式： powermt manage {dev=device|
class={symm|clariion|hitachi|hpxp|hphsx|invista|ess}}
注释：默认情况下，所有存储系统都在 PowerPath 管理下。用户可使用 powermt unmanage 使存储系统不受 PowerPath 管理。当存储系统在 PowerPath 管理下默认其所有逻辑磁盘设备都由 PowerPath 管理。使用 powermt unmanage 命令之后可使用此命令恢复 PowerPath 对磁盘设备的管理。
参数：
dev=device ： 指定需由 PowerPath 管理的逻辑磁盘设备路径名。
class=symm|clariion|hitachi|hpxp|hphsx|invista|ess ：指定需由 PowerPath 管理的存储系统名。
powermt release
功能：释放伪磁盘设备名供重用
平台： Linux 平台
存储系统：所有存储系统
格式： powermt release
注释：在多次添加和删除 LUN 配置之后， Linux 主机和 PowerPath 能够发现所有设备，但 PowerPath 已经用完磁盘设备的伪设备名时，运行此命令。
powermt remove
功能：从 PowerPath 管理中删除路径
平台：所有 PowerPath 平台
存储系统：所有存储系统
格式： powermt remove
[class=symm|clariion|ess|hitachi|hpxp|hphsx|invista|all]
[force] hba=hba#|all | dev=path|device|all
注释：从 PowerPath 配置路径列表中删除指定路径。此命令不删除路径涉及的磁盘设备。只要逻辑设备在系统中可见，就可用 powermt config 命令对逻辑设备进行配置。
在所有平台上，如果 native 路径是打开状态，那么此命令无法将其删除，例如，一个文件系统加载在路径磁盘设备上，或一个应用程序已将该路径磁盘设备打开。此命令删除所有指定并且不是打开状态的路径。
如果 PowerPath 磁盘设备是打开的，此命令不会删除该磁盘设备以及该设备的最后一条路径。
从 PowerPath 配置中永久删除一条路径：
\1. 运行 powermt check 或 powermt remove ；
\2. 物理上删除该路径；
\3. 删除与路径和 / 或磁盘设备相关的操作系统对象；
\4. 运行 powermt save 。
参数：
class=symm|clariion|ess|hitachi|hpxp|hphsx|invista|all ：将命令限制在指定存储系统，默认为 all 。
force ：不弹出确认对话并删除所有指定路径，包括逻辑设备的最后一条路径。
hba=hba#|all ：移除指定 HBA 的路径，默认为 all 。
dev=path|device|all ：移除指定路径，或连接指定磁盘设备的路径，默认为 all 。
powermt restore
功能：恢复路径
平台：所有 PowerPath 平台
存储系统：所有存储系统
格式： powermt restore
[class=symm|clariion|ess|hitachi|hpxp|hphsx|invista|all]
[hba=hba#|all] [dev=path|device|all]
注释：此命令测试并恢复指定路径，发出测试 I/O 并针对测试结果作出反应如下：
· 如果 live 路径通过测试，则此命令不做任何操作；
· 如果 dead 路径通过测试，此命令将其标识为 alive 状态； PowerPath 此时可以使用该路径；此外，同一 HBA 和 / 或存储系统端口上的其他路径也将被测试。
· 如果 live 路径测试失败，此命令将其标识为 dead 并打印告警。此外，共享 HBA 和端口的其他路径也可能标示为 dead 并被测试。
· 如果 dead 路径测试失败，此命令会打印告警。
此外，该命令还会尝试复活 dead 卷：
参数：
class=symm|clariion|ess|hitachi|hpxp|hphsx|invista|all ：将命令限制在指定存储系统，默认为 all 。
hba=hba#|all ：恢复指定 HBA 的路径，默认为 all 。
dev=path|device|all ：恢复指定路径，或连接指定磁盘设备的路径，默认为 all 。
powermt save
功能：保存用户配置
平台：所有 PowerPath 平台
存储系统：所有存储系统
格式： powermt save [file=pathname]
注释：默认情况下，此命令保存 powermt.custom 文件中的 PowerPath 配置。用户可指定其他文件名。对逻辑设备，命令记录它的序列号，策略，优先级，写阀值和队列，以及伪设备名。对路径，命令记录它的模式。对存储系统，此命令记录它的周期性自动还原设定。
配置被保存后可用 powermt load 命令加载。
参数：
file=pathname ：保存配置的文件路径名。
如果配置保存在默认文件名，之前的配置文件都会被覆盖。
无论何时用户对主机硬件作出改动，都要运行此命令来更新 PowerPath 配置。
powermt set mode
功能：设置路径模式
平台：所有 PowerPath 平台
存储系统：所有存储系统
格式： powermt set mode=active|standby
[class=symm|clariion|ess|hitachi|hpxp|hphsx|invista|all]
[hba=hba#|all] [dev=path|device|all]
注释：将路径设置为 active 或 standby 状态。
参数：
mode=active|standby ：决定路径能否传送 I/O ，或是保留。
class=symm|clariion|ess|hitachi|hpxp|hphsx|invista|all ：将命令限制在指定存储系统，默认为 all 。
hba=hba#|all ：设置指定 HBA 的路径，默认为 all 。
dev=path|device|all ：设置指定路径，或连接指定磁盘设备的路径的模式，默认为 all 。
powermt set policy
功能：设置负载均衡和 failover 策略
平台：所有 PowerPath 平台
存储系统：所有存储系统
格式： powermt set policy=li|lb|rr|re
[class=symm|clariion|ess|hitachi|hpxp|hphsx|invista|all]
[dev=device|all]
powermt set policy=si [dev=device|all]
powermt set policy=so|nr [dev=device|all]
powermt set policy=bf|co [dev=device|all]
powermt set policy=ad|nr
参数：
policy=ad|bf|co|lb|li|nr|re|rr|si|so ： ad(adaptive), bf(basic failover), co(CLARIION optimization), lb(least blocks), li(least I/O), nr(no redirect), re(request), rr(round robin), si(streamIO), so(Symmetrix optimization)
class=symm|clariion|ess|hitachi|hpxp|hphsx|invista|all ：将命令限制在指定存储系统，默认为 all 。
dev=device|all ：将命令限制在指定磁盘设备，默认为 all 。
参考
PowerPath 5.2 and 5.3 CLI Reference Guide
