内容纲要

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