6.5.2 パラメタ
(1) パスを稼働状態にする場合
- -path
HDLMが管理しているパスを操作することを指定します。
onlineオペレーションの対象物はパスだけなので,この指定は省略できます。
-hba,-hbaid,-cha,-chaid,-pathid,または-deviceパラメタで,稼働状態にするパスを指定できます。これらのパラメタを省略した場合は,すべての閉塞状態のパスを稼働状態にします。稼働状態にできないパスがあった場合,処理を継続するかどうかを確認するメッセージが表示されます。稼働状態にできなかったパスを閉塞状態のままにして処理を継続する場合は「y」を,処理を中断する場合は「n」を入力してください。
- -hba HBAアダプタ番号.バス番号またはアダプタ種別.アダプタ番号
HBAポート単位でパスを稼働状態にする場合に指定します。指定した番号のHBAポートを通るすべてのパスを稼働状態にします。
viewオペレーションで表示されるパス名のうち,HBAアダプタ番号およびバス番号,またはアダプタ種別およびアダプタ番号をピリオドで区切って指定します。viewオペレーションについては,「6.7 view 情報を表示する」を参照してください。英字の大文字,小文字は区別されます。
- 使用例
コマンド実行の確認をして,特定のHBAポート(HBAアダプタ番号「01」,バス番号「01」)を通るすべてのパスを稼働状態にする場合
# /usr/DynamicLinkManager/bin/dlnkmgr online -hba 01.01 KAPL01057-I 指定されたHBAを通る全てのパスをOnlineにします。よろしいですか? [y/n] :y KAPL01061-I 3本のパスをOnlineにしました。失敗したパス = 0本。オペレーション名 = online #
- -hbaid HBAポートID
HBAポート単位でパスを稼働状態にする場合に指定します。指定したHBAポートIDのHBAポートを通るすべてのパスを稼働状態にします。HBAポートIDは,次に示すviewオペレーションを実行すると表示されます。
# /usr/DynamicLinkManager/bin/dlnkmgr view -hba
viewオペレーションを実行してHBAポートIDを表示する方法については「6.7.2 パラメタ」の「(4) HBAポート情報を表示する場合」を参照してください。
- 使用例
コマンド実行の確認をして,HBAポートID「00001」を通るすべてのパスを稼働状態にする場合
# /usr/DynamicLinkManager/bin/dlnkmgr online -hbaid 00001 KAPL01104-I 指定されたHBAポートを通る全てのパスをOnlineにします。よろしいですか? [y/n]:y KAPL01061-I 15本のパスをOnlineにしました。失敗したパス = 0本。オペレーション名 = online
- -cha -pathid パス管理PATH_ID
CHAポート単位でパスを稼働状態にする場合に指定します。-pathidパラメタで指定したパスが経由しているCHAポートを通る,すべてのパスを稼働状態にします。物理ストレージシステムの物理CHAポート単位でパスが稼働状態になります。
viewオペレーションで表示される,現在のパス管理PATH_IDを指定します。viewオペレーションについては,「6.7 view 情報を表示する」を参照してください。パス管理PATH_IDの,左側の桁から0詰めされている0は省略できます(000001と1は同値です)。ただし,パス管理PATH_ID「000000」を指定する場合は,「000000」または「0」を指定してください。
パス管理PATH_IDは,ホストの再起動時に新しく割り当てられます。また,ホストを再起動しないで新規LUを追加する場合には,HDLMコンフィグマネージャ(dlmcfgmgr)の実行時にそのLUの各パスにパス管理PATH_IDが新しく割り当てられます。必ずviewオペレーションを実行して,稼働状態にするパスの現在のパス管理PATH_IDを確認してから,onlineオペレーションを実行してください。
- 使用例
コマンド実行の確認をして,CHAポート「0A」を通るすべてのパスを稼働状態にする場合(パス管理PATH_ID「000002」がCHAポート「0A」を通っているとき)
# /usr/DynamicLinkManager/bin/dlnkmgr online -cha -pathid 000002 KAPL01057-I 指定されたCHA portを通る全てのパスをOnlineにします。よろしいですか? [y/n] :y KAPL01061-I 2本のパスをOnlineにしました。失敗したパス = 0本。オペレーション名 = online #
- -chaid CHAポートID
CHAポート単位でパスを稼働状態にする場合に指定します。指定したCHAポートIDのCHAポートを通るすべてのパスを稼働状態にします。OSに認識されているストレージシステムのCHAポート単位でパスが稼働状態になります。CHAポートIDに対応する物理CHAポートが複数ある場合は,-cha -pathid パス管理PATH_IDでオンライン操作を実行してください。CHAポートIDは,次に示すviewオペレーションを実行すると表示されます。
# /usr/DynamicLinkManager/bin/dlnkmgr view -cha
viewオペレーションを実行してHBAポートIDを表示する方法については「6.7.2 パラメタ」の「(5) CHAポート情報を表示する場合」を参照してください。
- 使用例
コマンド実行の確認をして,CHAポートID「00001」を通るすべてのパスを稼働状態にする場合
# /usr/DynamicLinkManager/bin/dlnkmgr online -chaid 00001 KAPL01104-I 指定されたCHAポートを通る全てのパスをOnlineにします。よろしいですか? [y/n]:y KAPL01061-I 15本のパスをOnlineにしました。失敗したパス = 0本。オペレーション名 = online
- -pathid パス管理PATH_ID
単一のパスを稼働状態にする場合に指定します。
viewオペレーションで表示される,現在のパス管理PATH_IDを指定します。viewオペレーションについては,「6.7 view 情報を表示する」を参照してください。パス管理PATH_IDの,左側の桁から0詰めされている0は省略できます(000001と1は同値です)。ただし,パス管理PATH_ID「000000」を指定する場合は,「000000」または「0」を指定してください。
パス管理PATH_IDは,ホストの再起動時に新しく割り当てられます。また,ホストを再起動しないで新規LUを追加する場合には,HDLMコンフィグマネージャ(dlmcfgmgr)の実行時にそのLUの各パスにパス管理PATH_IDが新しく割り当てられます。必ずviewオペレーションを実行して,稼働状態にするパスの現在のパス管理PATH_IDを確認してから,onlineオペレーションを実行してください。
- -device SCSIデバイス名
SCSIデバイスに接続されているパスを稼働状態にする場合に指定します。
SCSIデバイス名には,次に示すviewオペレーションで表示されるDeviceを指定します。
# /usr/DynamicLinkManager/bin/dlnkmgr view -lu
viewオペレーションを実行してSCSIデバイス名を表示する方法については「6.7.2 パラメタ」の「(3) LU情報を表示する場合」を参照してください。指定できるパラメタ値は1つだけです。英字の大文字,小文字は区別されます。
- 使用例
コマンド実行の確認をして,SCSIデバイス名「hdisk1」を通るパスを稼働状態にする場合
# /usr/DynamicLinkManager/bin/dlnkmgr online -path -device hdisk1 KAPL01050-I 指定されたパスをOnlineにします。よろしいですか? [y/n]:y KAPL01061-I 1本のパスをOnlineにしました。失敗したパス = 0本。オペレーション名 = online
- -s
コマンド実行の確認メッセージを表示しないで実行します。シェルスクリプトやバッチファイルでコマンドを実行する場合など,確認メッセージへの入力を省略したいときに指定します。
- 使用例
コマンド実行の確認をしないで,パス管理PATH_ID「000002」のパスを稼働状態にする場合
# /usr/DynamicLinkManager/bin/dlnkmgr online -pathid 2 -s KAPL01061-I 1本のパスをOnlineにしました。失敗したパス = 0本。オペレーション名 = online #
(2) onlineオペレーションの形式を表示する場合
- -help
onlineオペレーションの形式が表示されます。
- 使用例
-
# /usr/DynamicLinkManager/bin/dlnkmgr online -help online: Format dlnkmgr online [-path] [-s] dlnkmgr online [-path] { -hba HBAPortNumber.BusNumber | -hbaid HBA_ID } [-s] dlnkmgr online [-path] { -cha -pathid AutoPATH_ID | -chaid CHA_ID } [-s] dlnkmgr online [-path] [-pathid AutoPATH_ID] [-s] dlnkmgr online [-path] [-device SCSI_Device_Name] [-s] Valid value AutoPATH_ID { 000000 - 999999 }(Decimal) HBA_ID { 00000 - 99999 }(Decimal) CHA_ID { 00000 - 99999 }(Decimal) KAPL01001-I HDLMコマンドが正常終了しました。オペレーション名 = online, 終了時刻 = yyyy/mm/dd hh:mm:ss #
参考
HDLMコマンドのviewオペレーションとUNIXの標準コマンドを組み合わせて実行すると,特定のHBAポート,またはCHAポートで,パスの情報を絞り込んで表示できます。viewオペレーションについては,「6.7 view 情報を表示する」を参照してください。
HBAポート単位,またはCHAポート単位でパスを稼働状態にする前に,次のコマンドを実行して,稼働状態にするパスの情報を確認することをお勧めします。
- 例1
特定のHBAポート(HBAアダプタ番号「04」,バス番号「01」)を通るすべてのパスを確認する場合
# /usr/DynamicLinkManager/bin/dlnkmgr view -path | grep 04.01
指定したHBAポートを通るパスの情報だけが表示されます。
- 例2
VSP G1000シリーズのCHAポート「1B」を通るすべてのパスを確認する場合
# /usr/DynamicLinkManager/bin/dlnkmgr view -path -stname | grep VSP_G1000 | grep 1B
指定したCHAポートを通るパスの情報だけが表示されます。