powermt 命令簡介（轉載）

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主機系列