PowerPath将多路径I/O功能、自动负载平衡和路径故障切换功能集成于一身,使存储管理更加轻松。本文总结了PowerPath常用命令的使用方法操作注意事项,为主机系统管理员对HBA/路径/端口/磁盘设备/存储系统执行配置、查看、删除、保存、恢复等操作提供参考。
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:每一行显示一条路径信息
ports:每一行显示一条端口信息
dev=device|all:显示指定磁盘设备信息,all显示所有磁盘设备。
class=symm|clariion|ess|hitachi|hpxp|hphsx|invista|all:列出指定存储系统信息,all显示所有存储系统。默认为all。
powermt display hba_mode
功能:监控HBA模式
平台:UNIX和Linux平台
存储系统:所有存储系统
格式:powermt display hba_mode
注释:显示主机上配置所有HBA信息。列出HBA的激活或禁用状态。
powermt display port_mode
功能:显示存储系统端口模式
平台:UNIX和Linux平台
存储系统:所有存储系统
格式:powermt display port_mode dev=device
注释:显示主机上配置所有端口模式信息。列出HBA的激活或禁用状态。
参数:
dev=device:指定需要查看的磁盘设备端口。磁盘设备名需为native设备名。
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
Windows, UNIX/Linux主机系列
联系客服