luxadm [options]... subcommand [options]... enclosure [,dev] | pathname...
luxadm プログラムは、SENA、Sun Fire 880 内蔵記憶装置サブシステム、および各 FC_AL (Fiber Channel Arbitrated Loop) デバイスの管理コマンドです。luxadm は、コマンド行に指定される引数やオプションに応じて、さまざまな制御処理や照会処理を実行します。
コマンド行にはサブコマンドの指定が必要です。コマンド行には、サブコマンドに応じてオプションやパラメータを指定することができます。オプションには、通常 1 つ以上の格納装置名またはパス名を指定します。指定する文字数は、サブコマンドを一意に識別するのに必要なだけでかまいません。
サブコマンドが作用するデバイスをパス名で指定します。Sun StorEdge A5000 サブシステムでは、パス名の代わりに、デバイスまたはデバイスに対するポートのワールドワイド名 (WWN) を入力することによってディスクデバイスまたは格納装置サービスコントローラを指定することができます。また、Sun StorEdge A5000 の格納装置名および格納装置内の特定のデバイスを示す識別子 (オプション) を入力することによってデバイスを指定することもできます。各 FC_AL デバイスを指定するには、デバイスの WWN またはポートを入力します。
デバイスまたはコントローラを、完全な物理パス名または完全な論理パス名で指定します。
Sun StorEdge A5000 に対するデバイスの一般的な物理パス名を以下に示します。
/devices/sbus@1f,0/SUNW,socal@1,0/sf@0,0/ssd@w2200002037000f96,
0:a,raw
システム上のすべての Sun StorEdge A5000 IB (Interface Board)に対しては、物理パスへの論理リンクが /dev/es ディレクトリに格納されます。論理リンクの例として、/dev/es/ses0 などがあります。
FC_AL デバイスや Sun StorEdge A5000 サブシステム IB を選択するために、パス名の代わりに WWN を使用することもできます。WWN は、デバイスを使用するためのポートまたはデバイスそのものを表す 16 桁の 16 進数の値です。一般的な WWN の値を次に示します。
2200002037000f96
WWN の形式については、「注意事項」を参照してください。
Sun Fire 880 内蔵記憶装置サブシステムのディスクの一般的な物理パス名を次に示します。
/devices/pci@8,600000/SUNW,qlc@2/fp@0,0/ssd@w2100002037a6303c,0:a
次に、一般的な論理パス名を示します。
/dev/rdsk/c2t8d0s2
各 FC_AL デバイスの一般的なパス名を示します。
/devices/sbus@3.0/SUNW,socal@d,10000/sf@0,0/ssd@w2200002037049fc3,0:a,raw
次に、一般的な論理パス名を示します。
/dev/rdsk/c1t0d0s2
Sun StorEdge A5000 では、デバイスは格納装置名とスロット名で特定することができます。
|
box_name は、Sun StorEdge A5000 の格納装置名で、enclosure_name サブコマンドで指定します。オプションの slot_number パラメータを指定しないと、box_name には、Sun StorEdge A5000 サブシステム IB が指定されます。
f または r は、Sun StorEdge A5000 の格納装置の前面のスロット(f) か、背面のスロット (r) かを指定します。
slot_number は、Sun StorEdge A5000 の格納装置のデバイスのスロット番号を指定します。指定することができる番号の範囲は 0- 6 または 0 - 10 です。
Sun Fire 880 内蔵記憶装置サブシステムも、デバイスは格納装置名とスロット名で特定することができます。ただし、1 セットのディスクしかありません。
box_name[,sslot_number]
box_name は、Sun Fire 880 内蔵記憶装置サブシステムの格納装置名で、enclosure_name サブコマンドで指定します。オプションの slot_number パラメータを指定しないで使用した場合、box_name には、Sun Fire 880 内蔵記憶装置サブシステム格納装置のサービスデバイスが指定されます。Sun Fire 880 内蔵記憶装置サブシステムのスロット番号、0 - 11 のいずれかを指定するには s を使用します。
ディスクおよびサブシステムの論理名については、disks(1M) および devlinks(1M) を参照してください。
次のオプションはすべてのサブコマンドに対して指定することができます。
エキスパート (Expert) モードです。このオプションは初心者の方にはお勧めしません。
冗長モード。
特定のサブコマンドだけに指定するオプションについては、「使用方法」の各サブコマンドの説明を参照してください。
次のオペランドがサポートされています。
Sun StorEdge A5000 の box_name を指定します。
ホストのコントローラポートへのパスを指定します。一般的なパスは、下記のとおりです。
/devices/pci@8,600000/pci@1/SUNW,qlc@4/fp@0,0:devctl
SENA IB、Sun Fire 880 内蔵記憶装置サブシステム、またはディスクデバイスの論理パスまたは物理パスを指定します。pathname は、SENA IB、SENA ディスク、または各 FC_AL デバイスの WWN でも指定することができます。
格納装置またはデバイス固有のデータを表示します。
サブシステムのデータは、格納装置の環境検知情報、およびディスクのステータスを含む、すべてのサブシステムのデバイスのステータスで構成されます。
ディスクデータは、照会、容量、および設定情報で構成されます。
pathname で指定されたデバイスまたはサブシステムの性能情報を表示します。このオプションは、性能情報を保存するサブシステムに対してのみ指定することができます。
pathname で指定された FC_AL デバイスのエラー情報を表示します。また、パス名が Sun StorEdge A5000 の場合は、そのループ上のすべてのデバイスのエラー情報を表示します。–r オプションは Sun StorEdge A5000 サブシステムまたは各 FC_AL デバイスに対してのみ指定することができます。
モード検知データを含む、詳細表示モードで表示します。
prom イメージを、filename_path で指定された SENA サブシステムのインタフェースボード装置か、enclosure または pathname で指定された SPARCstorageArray コントローラにダウンロードします。SPARCstorage Array は、ダウンロードコードを使用するためにリセットする必要があります。
SENA のダウンロードが終了すると、SENA はリセットされ、ダウンロードコードが実行されます。ファイル名が指定されていない場合は、デフォルトの prom イメージが使用されます。SPARCstorage Array コントローラ用のデフォルトの prom イメージは、/usr/lib/firmware/ssa/ssafirmware ディレクトリに格納されます。SENA 用のデフォルトの prom イメージは usr/lib/locale/C/LC_MESSAGES ディレクトリに ibfirmware というファイル名で格納されます。
Sun Fire 880 内蔵記憶装置サブシステムのダウンロードが終了すると、サブシステムはリセットされ、ダウンロードコードが実行されます。Sun Fire 880 内蔵記憶装置サブシステムのデフォルトのファームウェアイメージは、次のディレクトリに格納されます。 /usr/platform/SUNW,Sun-Fire-880/lib/images/int_fcbpl_fw。
保存オプションです。–s オプションはダウンロードしたファームウェアを FEPROM に保存します。–s を指定しない場合、 ダウンロードしたファームウェアは保存されず、電源の再投入後に消えてしまいます。
–s オプションは SPARCstorage Array コントローラには指定することができません。
–s オプションを使用すると、ダウンロードサブコマンドがサブシステム上の FEPROMを変更するため、-s オプションの使用には注意が必要です。
enclosure または pathname で指定された単数または複数の格納装置名を変更します。新しい名前は 16 文字以下で new_name に指定します。英数字のみが使用できます。このサブコマンドは Sun StorEdge A5000 に対してだけ指定することができます。
指定した論理ボリュームに、どの Sun StorEdge T3 array パートナーグループのコントローラがアクセスするかを選択します。primary を指定した場合、プライマリコントローラから論理ボリュームにアクセスします。secondary を指定した場合、pathname で指定したセカンダリコントローラから論理ボリュームにアクセスします。
fcode-file で指定されたファイルに含まれる fcode をすべての FC/S SBus カードにダウンロードします。このコマンドは対話型で、fcode をダウンロードする前にユーザーに対して確認を促します。
fcal_s_download は、シングルユーザーモードでだけ使用してください。入出力操作が行われているホストアダプタに対して、そのアダプタを更新する目的で fcal_s_download を指定すると、アダプタのリセットの原因となります。新しく更新した fcode は、システムをリブートしたときに実行され、表示できるようになります。
–f fcode-file オプションを省略すると、各 FC100/S SBus カードの中の現在のバージョンの fcode が表示されます。
インストール済みの FC/S、FC100/S、FC100/P、または FC100/2P ホストバスアダプタ カードを検出し、dir-name の fcode を適切なカードにダウンロードします。このコマンドは対話型で、各ファイルタイプに対して適切なカードを決定します。各デバイスに fcode をダウンロードする前にユーザーに対して確認を促します。
fcode_download は、シングルユーザーモードで fcode だけを読み込むときに使用します。入出力操作があるホストアダプタに対して、そのアダプタを更新する目的で fcode_download を指定すると、アダプタのリセットの原因となります。新しく更新した fcode は、システムをリブートしたときに実行され、表示できるようになります。
dir-name ディレクトリに格納されている fcode ファイルを適切なアダプタカードにダウンロードします。d オプションを省略すると、デフォルトの usr/lib/firmware/fc_s ディレクトリが使用されます。
各カードに読み込まれている現在のバージョンの fcode を表示します。ダウンロードは行われません。
enclosure または pathname で指定されたデバイスに対する照会情報を表示します。
このコマンドを使用して、電源を入れたまま 1 つまたは複数のデバイスを追加することができます。ホットプラグ操作中の制限に関しては「注意事項」を参照してください。このサブコマンドは Sun StorEdge A5000、RSM および各 FC_AL デバイスに対してのみ指定することができます。Sun StorEdge A5000に対して複数の格納装置が指定された場合は、複数のバスに対して同時に追加が行われます。このサブコマンドの引数を省略すると、すべての格納装置または各 FC_AL デバイスが追加されます。RSM に対して指定することができるコントローラは 1 つだけです。Sun StorEdge A5000 に対しては、このサブコマンドは、電源を入れたまま 1 つまたは複数のデバイスを追加するすべての過程をユーザーとの対話によって行います。複数のディスクが指定された場合は、それらのディスクが正しいかどうかの確認が行われ、ユーザーは継続するか中止するかを選択することができます。その後で、ディスクまたは格納装置の追加を実行するかどうかの確認が行われ、それらのデバイスの論理パス名が作成および表示されます。
enclosure または pathname で指定されたディスクに対応している LED の現在の状態を表示します。このサブコマンドはこの機能を持つサブシステムに対してのみ指定することができます。
enclosure または pathname で指定されたディスクに対応している LED の点滅を開始するようサブシステムに指示します。このサブコマンドはこの機能を持つサブシステムに対してのみ指定することができます。
enclosure または pathname で指定されたディスクに対応している LED を消灯させるようサブシステムに指示します。Sun StorEdge A5000 サブシステムでは、LED の消灯や点滅の停止ができる状態とできない状態があります。『Sun StorEdge A5000 設置・サービスマニュアル』(805-4111) を参照してください。このサブコマンドはこの機能を持つサブシステムに対してのみ指定することができます。
pathname で指定されたディスクに対応している LED を点灯させるようサブシステムに指示します。このサブコマンドはこの機能を持つサブシステムに対してのみ指定することができます。
Sun StorEdge A5000 に対してこのオプションでは、Sun StorEdge A5000 サブシステムが省電力モードに切り替わります。Sun StorEdge A5000 ドライブは、省電力モードでは使用することができません。SPARCstorage Array 中の格納装置サービスカードに対してこのオプションでは、RSMトレーの電源が切れます。Sun StorEdge A5000 中のドライブに対してこのオプションでは、そのドライブがドライブ off/unmated モードに設定されます。ドライブ off/unmated 状態では、ドライブが停止し、バイパスモードになります。このコマンドは、Sun Fire 880 内蔵記憶装置サブシステムには使用できません。
強制オプションは Sun StorEdge A5000 のみに適用されます。このオプションを指定すると、luxadm は、1 つまたは複数のデバイスを、それらがホストによって使用されていても電源切断しようとします。
警告 : 現在使用されているデータを含むデバイスの電源を切断すると、予想不可能な結果を引き起こします。デバイスの電源を切断する際は、まず、通常の方法を (–F を指定せずに) 試してください。このオプションは、通常の確認を無効にすることによる結果を理解した上で使用してください。
Sun StorEdge A5000 に対してこのオプションでは、Sun StorEdge A5000 サブシステムが省電力モードから抜けますSun StorEdge A5000 ドライブは、省電力モードでは使用することができません。SPARCstorage Array RSM トレーの電源をプログラムによって投入する方法はありません。Sun StorEdge A5000 の中のドライブに対してこのオプションでは、そのドライブが通常の起動状態に設定されます。このコマンドは、Sun Fire 880 内蔵記憶装置サブシステムには使用できません。
接続された Sun StorEdge A5000 サブシステムおよび各 FC_AL デバイスすべてに関する情報を検索して表示します。この情報には、論理パス名、WWN、および格納装置名が含まれます。このサブコマンドは、同じ格納装置名を持つ異なる Sun StorEdge A5000 を見つけると、ユーザーに対して警告を発します。
物理パス名を表示に含めます。
fcode-file ファイルに格納されている fcode をすべての FC100/P、FC100/2P PCIホストアダプタカードにダウンロードします。このコマンドは対話型で、fcode を各ドライブにダウンロードする前にユーザーに対して確認を促します。qlgc_s_download は、シングルユーザーモードでだけ使用してください。入出力操作があるホストアダプタに対して、そのアダプタを更新する目的で qlgc_s_download を指定すると、アダプタのリセットの原因となります。新しく更新した fcode は、システムをリブートしたときに実行され、表示できるようになります。
–f オプションを省略すると、各 FC100/P、FC100/2P PCI カードの、現在のバージョンの fcode が表示されます。
指定されたディスクの予約を解除します。パス名は、ディスクの物理または論理パス名でなければなりません。SPARCstorage Array コントローラのパス名を指定した場合、SPARCstorage Array 中のすべてのディスクの予約が解除されます。
このサブコマンドは、履歴および診断目的以外では使用しないでください。
このコマンドを使用して、電源を入れたまま 1 つまたは複数のデバイスを削除することができます。このサブコマンドはすべての格納装置を削除する場合にも指定することができます。このサブコマンドは Sun StorEdge A5000、RSM、および各 FC_AL デバイスに対して指定することができます。ホットプラグ操作中の制限に関しては「注意事項」を参照してください。Sun StorEdge A5000 および各 FC_AL デバイスに対しては、このサブコマンドは、電源を入れたまま 1 つまたは複数のデバイスを削除するすべての過程をユーザーとの対話によって行います。複数のディスクが指定された場合は、それらのディスクが正しいかどうかの確認が行われ、ユーザーは継続するか中止するかを選択することができます。その後で、ディスクまたは格納装置の削除を実行するかどうかの確認が行われ、それらのデバイスの論理パス名が作成および表示されます。
多重ホストディスクの場合、実行する手順は次のとおりです。
最初のホストに対して、luxadm remove_device コマンドを発行します。続行するかどうかを確認するプロンプトが表示されたら、待機します。
2 番目のホストに対して、luxadm remove_device コマンドを発行します。続行するかどうかを確認するプロンプトが表示されたら、待機します。
最初のホストに対して、remove_device コマンドを続行します。デバイスを削除するプロンプトが表示されたら、これを実行します。
ほかのホストに対して、luxadm remove_device コマンドを最後まで実行します。
1 つまたは複数のデバイスに対してホットプラグを適用するように luxadm に指示します。これらのデバイスがホストで使用されている場合 (busy または reserved の場合) にも適用されます。ホットプラグオペレーションが強制的に実行されます。
警告: 現在使用されているデータが格納されているデバイスを取り外すと、予期しない結果が発生します。通常は、–F を指定しないでホットプラグを適用します。-F は、通常のホットプラグ検査を無効にしたときの結果がわかっているときにだけ使用します。
指定されたディスクを、ホストによる排他的利用のために 予約します。パス名は、ディスクの物理または論理パス名でなければなりません。pathname が SPARCstorage Array コントローラのパス名の場合、SPARCstorage Array 中のすべてのディスクが予約されます。
このサブコマンドは、履歴および診断目的以外では使用しないでください。
システム PROM 中のブートデバイス変数を、pathname で指定された物理デバイス名に設定します。指定する物理デバイス名は、ブロック型特殊デバイス、またはブートファイルシステムのマウント先のディレクトリのパス名です。通常、このコマンドは、PROM の中のデフォルトブートデバイスを設定するためにユーザーに対して確認を促します。–y オプションは、ユーザーに対して確認を要求せず、非対話形式で実行するために使用できます。
指定されたSENA のディスクを起動します。
指定されたディスク SENA のを停止します。
以下のサブコマンドは、経験が豊富なユーザーのみが使用することができます。また、Sun StorEdge A5000 およびファイバチャネルループのみを対象にしています。これらのコマンドは、Sun StorEdge A5000 サブシステムとファイバチャネルループの知識が豊富なユーザーだけが使用することができます。
バスを操作するエキスパートサブコマンドにディスクを指定した場合は、そのサブコマンドは、指定したディスクに接続されたバスを操作します。
エンクロージャサービスコントローラに対して、指定したポートおよびデバイスの LRC (ループ冗長回路) をバイパス状態に設定するよう要求します。
このサブコマンドは、以下のオプションをサポートします。
指定したデバイスのポート a をバイパスします。
指定したデバイスのポート b をバイパスします。
指定したファイバチャネルポート上にあるターゲットデバイスまたはホストバスアダプタの WWN データを表示します。指定したポートにターゲットデバイスが存在しない場合、エラーが返されます。
エンクロージャサービスコントローラに対して、指定したポートおよびデバイスの LRC (ループ冗長回路) を有効な状態に設定するよう要求します。
このサブコマンドは、以下のオプションをサポートします。
指定したデバイスのポート a を有効にします。
指定したデバイスのポート b を有効にします。
ループ初期化基本式 (LIP) の処理を使ってリンクを強制的に再初期化します。enclosure または pathname には、ループ上のどのデバイスでも指定することができます。複数のループ構成に対して特定のパスを指定する場合は、パス名を使用します。
このコマンドは経験者向けのコマンドで、使用には注意が必要です。このコマンドは、ループ上のすべてのポートをリセットします。
enclosure または pathname で指定されたデバイスを含むループにある、すべての使用可能なデバイスのリンクエラーステータス情報を読み込み、表示します。
ホットプラグ操作中の制限に関しては「注意事項」を参照してください。以下のサブコマンドは、経験が豊富なユーザーのみが使用することができます。
これらのコマンドは、Sun Fire 880 内蔵記憶装置サブシステムに使用することはできません。
指定されたバスの状態を取得、表示します。
指定されたバスを休止します。
指定されたバスのみをリセットします。
指定されたバスおよびすべてのデバイスをリセットします。
指定されたバスを休止解除します。指定されたデバイス。
指定されたデバイスの状態を取得、表示します。
指定されたデバイスをリセットします。
指定されたデバイスをオフラインにします。
指定されたデバイスをオンラインにします。
システム上にあるすべての Sun StorEdge A5000 および FC_AL デバイスを検索、表示する例を次に示します。
example% luxadm probe使用例 2 SENA または Sun Fire 880 内蔵記憶装置サブシステムの表示
SENA または Sun Fire 880 内蔵記憶装置サブシステムを表示する例を次に示します。
example% luxadm display /dev/es/ses0使用例 3 2 つのサブシステムの表示
格納装置名を使って 2 つのサブシステムを表示する例を次に示します。
example% luxadm display BOB system1使用例 4 最初のディスクに関する情報の表示
BOB という名前の格納装置の前面にある最初のディスクについての情報を表示する例を次に示します。f を使用して前面ディスクを指定します。背面のディスクを指定する場合は r を指定します。
example% luxadm display BOB,f0使用例 5 Sun Fire 880 内蔵記憶装置サブシステムに関する情報の表示
Sun Fire 880 内蔵記憶装置サブシステムには、1 セットのディスクしかありません。この場合、そのスロットを指定する場合は s を指定します。
example% luxadm display BOB,s0使用例 6 SENA ディスク、格納装置、または各 FC_AL デバイスに関する情報の表示
ポートの WWN が 2200002037001246 の Sun StorEdge A5000 ディスク、格納装置、または各 FC_AL デバイスに関する情報を表示する例を次に示します。
example% luxadm display 2200002037001246使用例 7 サブコマンドとして一意に認識するための文字列
サブコマンドとして一意に認識できるだけの長さの文字列を使用する例を次に示します。
example% luxadm disp BOB使用例 8 エラー情報の表示
格納装置 BOB があるループに関するエラー情報を表示する例を次に示します。
example% luxadm display –r BOB使用例 9 インタフェースボードへの新しいファームウェアのダウンロード
格納装置 BOB のインタフェースボードに新しいファームウェアをダウンロードする例を次に示します (ダウンロードするファイルはデフォルトパスで指定されています)。
example% luxadm download –s BOB使用例 10 SCSI 照会コマンドからの情報の表示
システム上の個々のディスクから SCSI 照会コマンドからの情報を表示する例を次に示します。サブコマンドとして一意に認識できる長さの文字列だけが使用されます。
example% luxadm inq /dev/rdsk/c?t?d?s2使用例 11 ホットプラグによる取り付け
BOB,f1 という名前の格納装置の前面の最初のスロットに新しいドライブをホットプラグで取り付ける例を次に示します。
example% luxadm insert_device BOB,f0
SF880-1 という名前の Sun Fire 880 内蔵記憶装置サブシステムの最初のスロットに、新しいドライブをホットプラグで取り付ける例を次に示します。
example% luxadm insert_device SF880-1,s0使用例 12 エキスパートサブコマンドの実行
エキスパートサブコマンドを実行する例を次に示します。このサブコマンドは、格納装置 BOB のあるループを強制的に初期化します。
example% luxadm –e forcelip BOB使用例 13 エキスパートモードのホットプラグサブコマンドの使用
エキスパートモードのホットプラグサブコマンドを使用して SSA 上のディスクを削除する例を次に示します。ホットプラグ操作中の制限に関しては「注意事項」を参照してください。
最初の手順では、SCSI デバイスが 2 つ目の SCSI バスによってアクセスされないように、そのデバイスを予約します。
example# luxadm reserve /dev/rdsk/c1t8d0s2使用例 14 ディスクをオフラインにする
次の 2 つの手順では、ディスクをオフラインにし、バスを休止します。
example# luxadm –e offline /dev/rdsk/c1t8d0s2 example# luxadm -e bus_quiesce /dev/rdsk/c1t8d0s2使用例 15 バスの休止解除
ユーザーは、この時点でディスクを取り外し、バスを休止解除し、ディスクをオンラインに戻し、ディスクの予約を解除します。
example# luxadm –e bus_unquiesce /dev/rdsk/c1t8d0s2 example# luxadm –e online /dev/rdsk/c1t8d0s2 example# luxadm release /dev/rdsk/c1t8d0s2
luxadm の実行に影響のある環境変数 LANG に関しては environ(5) を参照してください。
次の終了ステータスが返されます。
正常終了。
エラーが発生した。
usr/lib/firmware/fc_s/fc_s_fcode
usr/lib/locale/C/LC_MESSAGES/ibfirmware
属性についての詳細は、マニュアルページの attributes(5) を参照してください。
|
devlinks(1M), disks(1M), attributes(5), environ(5), ses(7D)
Oracle Solaris 11.2 での SAN デバイスとマルチパス化の管理
『Oracle Solaris Cluster 3.3 with Fibre Channel JBOD Storage Device Manual』
IEEE 拡張 WWN に関する情報については『Tutorial for SCSI use of IEEE Company_ID』 (R. Snively 著) を参照してください。現在は、一部のデバイスドライバのみがホットプラグに対応しています。ホットプラグに対応していないディスクまたはバスにホットプラグが適用されると、メッセージが表示されます。
luxadm: can't acquire "PATHNAME": No such file or directory
上記の形式で表示されます。
ルートファイルシステムまたは /usr ファイルシステムを含むバスやスワップデータを含むバスを休止する際は注意してください。そのようなバスを休止すると、デッドロックを引き起こす可能性があり、そのような場合は、システムのリブートが必要となります。