「PowerStore:PowerStoreからさまざまなログを生成および収集する方法(英語)」
Summary: この記事では、さまざまなPowerStoreログを生成および収集する方法について説明します。
Instructions
| サポート資料
パフォーマンス メトリクス アーカイブ ダンプ ファイル |
PowerStore X(ハイパーバイザー ログ)
PowerStore Metro Witness PowerStore UI - RESTログ |
スイッチ ログ 外部ストレージのインポート ログ VPLEXおよびmetroノード |
サポート資料
サポート資料またはData Collects (DC)は、分析およびトラブルシューティングに使用する最も一般的なログです。サポート資料を実行および収集する方法は多数あります。システムの状態と使用可能なアクセス方法に応じて、より便利な方法を使用してください。
メモ:
- 調査中の問題がPowerStoreのレプリケーションまたはMetroのボリュームに関連している場合は、すべてのクラスターとアプライアンスからログを収集し、テクニカル サポートに提供する必要があります。
- PowerStoreがまだ初期化されていない(管理IPがまだない)場合は、「PowerStore:未設定のシステムからサポート資料に接続して収集する方法(英語)」を参照してください。
PowerStore Managerユーザー インターフェイスを使用する場合
- PowerStore Managerユーザー インターフェイス(UI)にユーザー名とパスワードを使用してログインします。
- [Settings]メニューまたは[system name]をクリックします。
- [Support]セクションの[Gather Support Materials]にアクセスします。
- [GATHER SUPPORT MATERIALS]ボタンを押します。右側に新しいサブメニューが表示されます。
- デフォルトのオプションは次のとおりです。
- 「Description: オプション
- [Collection Timeframe](v3+のみ):テクニカル サポートから他のオプションを選択するように指示されない限り、デフォルト([All])に設定します。
- [Object Type]:アプライアンス
- [Objects to collect data for]:すべてのアプライアンスを選択します。
- [Send materials to Support when finished]:オプション(SupportAssistが必要)。
- [Advanced support materials collection options]:サポートが要求しない限り、選択しないでください。メモ: この詳細オプションを選択すると、サポート資料のサイズが大幅に増加します。サポート担当者から指示された場合にのみ、このオプションを選択します。
- [START]をクリックします。このプロセスは、システムのサイズによって最大60分かかる場合があります。
- 進行状況は、PowerStore Managerの[Jobs]セクション、または[Support Materials]セクションで監視できます。
- 前掲のプロセスが終了したら、[Gather Support Materials]セクションの[Support Materials Library]から、ダウンロードするバンドルを選択します。
- [DOWNLOAD]または[SEND TO SUPPORT]を押します。
- サブメニューが右側に表示され、各アプライアンスのダウンロード リンクが表示されます。
- すべてのアプライアンスの[Support material collection]をクリックします。
ssh/cliを使用する場合
作業を開始する前に:
- 重要:予期しないシステム動作につながる可能性があるため、USBデバイスをPowerStoreノードのUSBポートに接続しないでください。詳細については、「PowerStore: ユニバーサル シリアル バス(USB)ポートの使用ガイドライン(英語)」を参照してください。
- PowerStore Managerユーザー インターフェイスにアクセスできない場合を除き、CLI/sshからログをダウンロードする必要はありません。
- 記事「PowerStore:rbashおよびその他のセキュリティ実装によるシェルの制限事項について」を参照してください。
- 各アプライアンスには自身のログのみが含まれています。マルチ アプライアンス クラスターの場合は、WinSCPを使用して各アプライアンスに個別に接続し、それぞれのログをダウンロードする必要があります。各アプライアンスのIPアドレスの詳細情報は、PowerStore Managerユーザー インターフェイスの[Settings]>[Network IPs]にあります。
操作方法:
- サービス ユーザーとパスワードで、ssh経由でシステムにログインします。
- サポート資料を生成するサービス コマンドはsvc_dcです。
マルチ アプライアンス システムの場合は、すべてのアプライアンスをコレクションに含めます。2台のアプライアンス クラスターの場合は、次のようになります。svc_dc run -a A1,A2
使用方法の詳細については、svc_dc -hまたはsvc_dc run -hを実行するか、Dellサポート ページからダウンロード可能な『PowerStore Service Scripts Guide』を参照してください。 - ログが完了したら、ダウンロードします。
このプロセスを容易にするため、ログの実行が終了すると、ログへのリンクがホーム ディレクトリー(/home/service/user)に自動的に作成されます。ls -lを使用してそれらを一覧表示します。何らかの理由でリンクが作成されない場合は、次の方法でファイルを手動で一覧表示します。
サービス コマンド「svc_dc list」を使用して、使用可能なサポート資料(DC)を一覧表示します。Example:
ここでは、日付、ID、ステータス、ダンプの存在、説明、使用されているプロファイル(svc_dc list_profiles)、ログが対応するアプライアンスを確認できます。[SVC:service@xxxxxxx-A user]$ svc_dc list
start_timestamp id status dump description profile appliances
2020-04-08 12:48:37 xxxx-xxxx-xxxx SUCCESS No essential FNM00xxxxx..
2020-04-08 14:36:42 xxxx-xxxx-xxxx SUCCESS No Post NDU detailed,.. FNM00xxxxx..
2020-04-09 13:33:57 xxxx-xxxx-xxxx SUCCESS No detailed FNM00xxxxx..
2020-04-15 15:05:34 xxxx-xxxx-xxxx SUCCESS Yes 2020-04-15 Dail.. essential.. FNM00xxxxx..
2020-04-16 15:23:07 xxxx-xxxx-xxxx SUCCESS No 2020-04-16 Dail.. essential FNM00xxxxx..
2020-04-16 19:07:41 xxxx-xxxx-xxxx SUCCESS No Daily data coll.. essential FNM00xxxxx..
IDを取得して、listコマンドを実行すると、ファイルの場所などの詳細が表示されます。
コマンドの例(出力は表示されていません):
バンドルIDに複数のアプライアンスのログが含まれている場合は、それぞれのアプライアンス上のファイルへのフル パスが出力に一覧表示されます。[SVC:service@xxxxxxx-A user]$ svc_dc list xxxx-xxxx-xxxx
- ログをダウンロードします。cli/sshを使用してアプライアンスからログ ファイル バンドルをダウンロードするには、さまざまな方法があります。次に例を示します。
WinSCPなどのツールを使用する場合PowerStoreでのrbashおよびその他のセキュリティ実装により、cdのようなコマンドやSFTPなどのプロトコルなど、特定のコマンドと操作は許可されません。そのため、接続プロトコルとしてSCPを選択する必要があります。ホーム ディレクトリー(/home/service/user)にのみアクセスできます。 ただし、前述のとおり、ログへのリンクがホーム ディレクトリーに作成されます。それぞれのリンクをドラッグ アンド ドロップすると、ファイルのダウンロードが開始されます。エラー メッセージが表示される場合がありますが、[OK]を押すとダウンロードには影響しません。svc_uploadまたはsvc_dc downloadを使用する場合これは、ログのダウンロードまたはアップロードを容易にするためのサービス コマンドです。使用方法は環境によって異なります。svc_dc download -hまたはsvc_dc upload -hの詳細については、サポート ページからダウンロード可能な『PowerStore Service Scripts Guide』を参照してください。Windowsユーティリティー「pscp」を使用する場合Windowsには、システムで直接ログをダウンロードやアップロードするための「pscp」と呼ばれるコマンド プロンプト ツールが用意されています。PowerStoreアプライアンスでファイルの正確な場所を確認する必要があります(サービス ユーザーのホーム ディレクトリーのリンクを使用できます)。
構文:
PowerStoreOS V4を使用している場合は、コマンドに次を追加します:pscp -scp -o MACs=hmac-sha2-512 service@xx.xx.xx.xx:...pscp -scp service@PowerStore-ip-address:/path/file C:\local_directory
Windowsコマンド プロンプトからの例:C:\>pscp -scp service@xx.xx.xx.xx:/home/service/user/powerstore_tag_clusterID_serial_2020-04-08_14-36-42_service-data.tgz C:\LOGS
service@xx.xx.xx.xx's password:
powerstore_tag_clusterID_.. | 320000 kB | 45714.3 kB/s | ETA: 00:00:05 | 54%
パフォーマンス メトリクス アーカイブ
PowerStore Managerの使用
パフォーマンス メトリックの生成は、PowerStoreOS v3.x以降を実行しているシステムでのみ可能です。
- ユーザー名とパスワードを使用して、PowerStore Managerユーザー インターフェイス(UI)にログインします(管理者ユーザー ロールを持つユーザーが必要です)。
- [Settings]メニューまたは[system name]をクリックします。
- [Support]セクションの[Metrics Archives]にアクセスします。
- [GENERATE METRICS ARCHIVE]>[GENERATE]をクリックします。
- PowerStore Managerの[Jobs]セクションで進行状況を監視します。
- 終了したら、[Metrics Archives]セクションでファイルを選択し、[DOWNLOAD]をクリックします。
ssh/cliを使用する場合
PowerStoreOSバージョン4.1以降の場合は、次を使用します。
svc_pstcli metrics_archive generate |
PowerStoreOSバージョン3.xおよび4.0.xの場合:
管理者アカウントまたは管理者ユーザー ロールを持つアカウントが必要です。
pstcli -d <self/peer/ClusterIP> -u admin -p <MyPassword> metrics_archive generate |
その他のオプションは、以下で見つけることができます。
pstcli metrics_archive -h |
ノード上またはノード外のどちらのPSTCLIバージョンも使用できます。PSTCLIの使用方法の詳細については、Dellサポート ページにある『PowerStore CLI Guide』を参照してください。
生成されたパフォーマンス アーカイブは、次のディレクトリー内にあります。ここで、xxxxは、日付フォルダーまたはお使いのシステムに固有のフォルダーを示しています。
ls -lha /cyc_cfs/service/support_metrics/archived/xxxx |
ファイル形式は、PowerStore_ClusterID_StartDate_EndDate_support-metrics.tar.gzです。
例:PowerStore_abcdefg_2020-04-21T12-56-32_2020-04-28T12-56-32_support-metrics.tar.gz
上記のように、オフノードPSTCLIまたはpscpを使用してファイルをローカル マシンに直接ダウンロードするか、WinSCPでダウンロードするためにファイルを /home/service/user にコピーします。
オフノードPSTCLIの使用:
上記のIDを持つWindowsマシンでオフノードPSTCLIを使用する例:
pstcli -d <ClusterIP> -u admin -p <MyPassword> metrics_archive -d "C:\Temp" -archive_id 6e869e4e-2612-45ed-b531-6884fa4c802a download |
ファイルは指定されたパス(-d)にダウンロードされます。パスが指定されていない場合、ファイルはCMDパスのデフォルトの場所にダウンロードされます(CMD内のコマンド プロンプト自体に表示されます。例:C:\>Users\userX)。
オンノードPSTCLIまたはダイレクト コピーを使用したWinSCPでのダウンロード:
プライマリー ノードからPSTCLIを直接実行している場合は、ファイルをホーム ディレクトリーにコピーしてから、WinSCPで転送します
これは、上記と同じコマンドで実行できます(2番目の-dスイッチなし、または-d /home/service/userを使用)
次に示すように、ファイルを手動で/home/service/userにコピーすることもできます。
次を実行して使用可能なファイルを一覧表示します。
ls -lha /cyc_cfs/service/support_metrics/archived/ |
一意のサブ ディレクトリー名を決定します。次に以下を実行します。
| [SVC:service@xxx-A user]$ ls -lha /cyc_cfs/service/support_metrics/archived/2021-03-09T12-09-50-512325/ total 183548 -rw-rw-r-- 1 root cycg 187945656 Mar 9 12:11 PowerStore_xxx_2021-03-02T12-09-50_2021-03-09T12-09-50_support-metrics.tar.gz |
ファイルを現在のディレクトリー(/home/service/user)にコピーします。コマンドの最後にあるドット(.)は、ターゲット ディレクトリーを示します。
| [SVC:service@xxx-A user]$ cp /cyc_cfs/service/support_metrics/archived/2021-03-09T12-09-50-512325/PowerStore_xxx_2021-03-02T12-09-50_2021-03-09T12-09-50_support-metrics.tar.gz . |
ファイルがコピーされたら、WinSCPを使用してダウンロードします。
ダンプ ファイル
PowerStore Managerの使用
ダンプ ファイルは、サポート資料と同様にPowerStore Managerから入手できます。関連するエントリーを選択し、[DOWNLOAD]を押します。唯一の違いは、これらがサポート資料のコレクションではなくサポート資料のダンプとして表示されることです。
ssh/cliを使用する場合
ssh/cliを介してダンプ ファイルを検索してダウンロードする最も簡単な方法は、関連するアプライアンスにサービス ユーザーとしてログインし、ホーム ディレクトリーでこれらのファイルを一覧表示する方法です。サポート資料と同様に、ここに便利なリンクが作成されます。
これらは、WinSCPを使用して直接一覧表示することができます。または、ls *dump*などのコマンドを実行して、ホーム ディレクトリー内にあるすべてのダンプ ファイルを一覧表示することもできます。
ダンプ ファイルがホーム ディレクトリーに一覧表示されない場合は、サービス コマンドsvc_dc listまたはsvc_dc list_dumpsを使用できます。ここでは、前掲でサポート資料に使用されているものと同じロジックと原則が当てはまります。
ダンプ ファイルのIDを取得したら、svc_dc list <id>を使用して正確な場所を取得できます。同じダウンロード メカニズムを使用できます。より便利な方法を選択してください。
PowerStore X(ハイパーバイザー ログ)
PowerStore Managerの使用
PowerStore Managerからハイパーバイザー ログを収集する唯一の方法は、[Advanced support materials collection options]でオプションを選択することです。これは、前述の「サポート資料のログ バンドルの生成」セクションの手順5で説明した方法と同じです。ただし、詳細オプションを選択するとログ バンドルのサイズが大幅に増加するため、この方法は推奨される方法ではありません。
ssh/CLIを使用する場合
svc_dc run -p essential,hypervisor |
メモ:この方法ではvCenterログは収集されません。次のセクション(vSphereを使用する場合)を参照してください。
サポート資料バンドルのダウンロード後、各ハイパーバイザー ログは次の場所にあります。
./node_a/command_output/vmware/esx-*-host-1-*.tgz |
vSphereから
vSphere側からハイパーバイザー ログ(vm-support)を収集するには、VMware KB 653を参照してください。
トラブルシューティングのためにvCenterログも必要な場合は、VMware KBの説明に従って関連するオプションを選択します。
PowerStore Metro Witness
ssh経由でMetro Witness仮想マシンにログインし、組み込みのdata_collect.shスクリプトを実行してログを収集します。
| sudo /opt/dell-witness-service/scripts/data_collect.sh |
Example:
| [witness@test-pwrstr-witness01 ~]$ sudo /opt/dell-witness-service/scripts/data_collect.sh The following script will gather and package journal logs and files related to the witness service.Proceed? (y/n): y Gathering relevant journal logs for the past 14 days... Gathering the witness database... Witness service data collect complete.Result written to: /tmp/dell-witness-service-DC_2024-02-02T13-48+00-00.tgz |
最後の行は、生成されたログの場所を示します。
WinSCPのようなツールを使用してダウンロードします。
使用例:
| [witness@test-pwrstr-witness01 ~]$ sudo /opt/dell-witness-service/scripts/data_collect.sh -h [sudo] password for witness: ======================================================= Dell Witness Service data collection script version 1.0 ======================================================= Usage: ./data_collect.sh [OPTION] ... Options: -h, --help: Display this message and quit -y, --yes: Skip the prompt and start the data collect immediately -d, --directory: Specify an output directory for the data collect tar.[Default]:/tmp -s, --since: Specify the number of days that should be considered for log collection.[Default]:14 |
PowerStore UI/RESTログ
PowerStore Managerの使用
- PowerStoreユーザー インターフェイス(UI)で問題を再現します。
- UIの右上隅にある[?]ヘルプ アイコンにカーソルを合わせ、Ctrl+Alt+Shift+左クリックを押します。これにより、ヘルプ メニューに非表示のメニュー オプションが表示されます。
- そのメニューから[Download Network Requests]オプションを選択し、テキスト ファイルをローカル システムのある場所に保存します。
インターネット ブラウザーを使用する場合
- ブラウザーを開いて、PowerStore Managerを起動する前にF12を押して、ブラウザーの開発者ウィンドウを表示します。
- [Network]タブに移動します。
- UIを開いて問題を再現します。
- 開発者ウィンドウで、中央のパネルにある任意のネットワーク リクエストを右クリックし、[save all as HAR with content]を選択します。
スイッチ ログ
このセクションでは、OS10 Dellスイッチ(ToR)のみに関する簡単な説明を示します。詳細については、「Dell EMCネットワーキングOS10スイッチでサポート バンドルを生成および収集する方法」を参照してください。その他のバージョンまたはスイッチ ベンダーについては、該当するドキュメントを参照してください。
ログ収集を開始するには、次の手順を実行します。
generate support-bundle enable-all-plugin-options
|
前掲のKB記事の説明どおり、完了するまで監視します。
完了後、スイッチからログをダウンロードする方法がない場合は、Dellテクニカル サポートがFTPの一時的なリンクを提供できます。
ログ バンドルを検索してダウンロードするには、次のコマンドを使用します。
dir supportbundle
|
copy supportbundle://your_bundle.tar.xz sftp://temp_username@xyz.dell.com/your_bundle.tar.xz
|
ここで「temp_username@xyz.dell.com」は、FTPまたはSFTPの各サーバーがない場合にDellテクニカル サポートによって提供される詳細です。FTPアドレスは、場所によって異なる場合があります。
外部ストレージ インポート ログ
Linuxホスト プラグイン
ログの場所:/var/log/import
Windowsホスト プラグイン
ログの場所:C:\ProgramData\DELLEMC\log\
EqualLogic
ログの場所:/var/log/equallogic