このセクションには、SoS ユーティリティで使用できる特定のオプションが記載されています。
SoS ユーティリティを使用したログ ファイルの収集の詳細については、VMware Cloud Foundation システムのログの収集を参照してください。
SoS ユーティリティのヘルプ オプション
sudo /opt/vmware/sddc-support/sos --option-nameプロンプトが表示されたら、 vcf パスワードを入力します。
| オプション | 説明 |
|---|---|
|
|
使用可能な SoS ユーティリティ オプションのサマリを提供します。 |
|
|
SoS ユーティリティのバージョン番号を提供します。 |
SoS ユーティリティの一般オプション
sudo /opt/vmware/sddc-support/sos --option-nameプロンプトが表示されたら、 vcf パスワードを入力します。
| オプション | 説明 |
|---|---|
--history |
直近に実行された 20 件の SoS 操作を表示します。 |
--force |
ワークフローの実行中に SoS 操作を実行できるようにします。
注： このオプションは使用しないことをお勧めします。
|
--configure-sftp |
ログの SFTP を構成します。 |
--setup-json SETUPJSON |
ログ収集用のカスタム setup-json ファイル。 SoS は、実行されている環境に基づいて自動的にインベントリを作成します。事前定義されたコンポーネント セットのログを収集する場合は、setup.json ファイルを作成し、そのファイルを入力として SoS に渡すことができます。サンプルの JSON ファイルを SDDC Manager アプライアンス の /opt/vmware/sddc-support/setup.sample.json で入手できます。 |
--log-folder LOGFOLDER |
ログ ディレクトリの名前を指定します。 |
--log-dir LOGDIR |
ログを保存するディレクトリを指定します。 |
--enable-stats |
SoS 実行統計の収集を有効にします。 |
--debug-mode |
SoS ユーティリティをデバッグ モードで実行します。 |
--zip |
出力用の圧縮された tar ファイルを作成します。 |
--domain-name DOMAINNAME |
SoS 操作を実行するワークロード ドメインの名前を指定します。 すべてのワークロード ドメインで操作を実行するには、
注：
--domain-name フラグとワークロード ドメイン名を省略すると、管理ドメインのみで SoS 操作が実行されます。 |
--clusternames CLUSTERNAMES |
ESXi およびワークロード管理 (WCP) ログを収集するワークロード ドメインに関連付けられている vSphere クラスタ名を指定します。 vSphere クラスタのカンマ区切りのリストを入力します。たとえば、
注：
--domain-name ALL を指定すると、 |
--skip-known-host-check |
ホストの SSL サムプリントについて指定されているチェックを既知のホストでスキップします。 |
--include-free-hosts |
使用中の ESXi ホストに加えて、使用されていない ESXi ホストのログを収集します。 |
SoS ユーティリティの VMware Cloud Foundation サマリ オプション
sudo /opt/vmware/sddc-support/sos --option-nameプロンプトが表示されたら、 vcf パスワードを入力します。
| オプション | 説明 |
|---|---|
--get-vcf-summary |
CEIP、ワークロード ドメイン、vSphere クラスタ、ESXi ホスト、ライセンス、ネットワーク プール、SDDC Manager、および VCF サービスなど、VMware Cloud Foundation システムに関する情報を返します。 |
--get-vcf-tasks-summary |
タスクの作成時刻やタスクのステータスなど、VMware Cloud Foundation のタスクに関する情報を返します。 |
--get-vcf-services-summary |
SDDC Manager のアップタイムと VMware Cloud Foundation サービス（LCM など）の開始および停止に関する情報を返します。 |
SoS ユーティリティの修正オプション
./sos --option-name
修正オプションでは、ワークロード ドメインを指定しない場合、コマンドは管理ドメインのみに影響します。
| オプション | 説明 |
|---|---|
|
|
指定されたワークロード ドメインの ESXi ノードで SSH を有効にします。
|
|
|
指定されたワークロード ドメインの ESXi ノードで SSH を無効にします。
|
|
|
指定されたワークロード ドメインの vCenter Server で SSH を有効にします。
|
|
|
指定されたワークロード ドメインの vCenter Server で SSH を無効にします。
|
|
|
指定されたワークロード ドメインの ESXi ノードでロックダウン モードを有効にします。
|
|
|
指定されたワークロード ドメインの ESXi ノードでロックダウン モードを無効にします。
|
--ondemand-service |
このフラグを含めると、ワークロード ドメイン内のすべての ESXi ホストでコマンドを実行できます。
注意: このオプションを使用する前に、VMware サポートにご連絡ください。
|
--ondemand-service JSON file path |
このフラグを含めると、ワークロード ドメイン内のすべての ESXi ホストでコマンドを JSON 形式で実行できます。たとえば、/opt/vmware/sddc-support/<JSON ファイル名> とします。 |
--refresh-ssh-keys |
SSH キーを更新します。 |
SoS ユーティリティの健全性チェック オプション
sudo /opt/vmware/sddc-support/sos --option-nameプロンプトが表示されたら、 vcf パスワードを入力します。
緑色のステータスは健全性が正常、黄色は注意が必要という警告、赤色（重大）はコンポーネントに緊急対応が必要ということを示します。
| オプション | 説明 |
|---|---|
--health-check |
使用可能なすべての健全性チェックを実行します。 |
--connectivity-health |
接続の健全性チェックを実行して、ESXi ホスト、vCenter Server、NSX Manager、SDDC Manager など、システムのさまざまなコンポーネントを ping できるかどうかを調べます。 |
--services-health |
サービスの健全性チェックを実行して、SDDC Manager や vCenter Server 内でサービス（ライフサイクル管理サーバなど）が実行されているかどうかを確認します。 |
--compute-health |
ESXi ホストのライセンス、ディスク ストレージ、ディスク パーティション、健全性ステータスなどのコンピューティングの健全性チェックを実行します。 |
--storage-health |
ESXi ホストおよび vSphere クラスタの vSAN ディスクの健全性チェックを実行します。また、プロアクティブな vSAN テストを実行して、vSAN ディスク内に仮想マシンを作成できるかどうかも検証します。 |
--run-vsan-checks |
プロアクティブな vSAN テストを実行して、vSAN ディスク内に仮想マシンを作成できるかどうかを検証します。 |
--ntp-health |
コンポーネントの時刻が SDDC Manager アプライアンスの NTP サーバと同期されているかを確認します。また、ESXi ホストのハードウェアとソフトウェアのタイムスタンプが SDDC Manager アプライアンスの時刻と 5 分以内の誤差であることも確認されます。 |
--dns-health |
正引きおよび逆引きの DNS の健全性チェックを実行します。 |
--general-health |
ESXi のエラー ダンプを確認し、NSX Manager とクラスタのステータスを取得します。 |
--certificate-health |
コンポーネント証明書が有効（有効期限内）であることを確認します。 |
--composability-infra-health |
コンポーザブル インフラストラクチャの API 接続の健全性チェックを実行します。コンポーザブル インフラストラクチャが存在しない場合、このフラグは無視されます。検出された場合、Redfish などのコンポーザブル インフラストラクチャ API 経由で接続ステータスが確認されます。 |
--get-host-ips |
ESXi ホストのホスト名と IP アドレスを返します。 |
--get-inventory-info |
vCenter Server、NSX-T Data Center、SDDC Manager、ESXi ホストなどの VMware Cloud Foundation コンポーネントのインベントリの詳細を返します。必要に応じて、すべてのワークロード ドメインの詳細を返すフラグ |
--password-health |
前回の変更日や有効期限など、現在のすべてのパスワードのステータスを返します。 |
--hardware-compatibility-report |
ESXi ホストおよび vSAN デバイスを検証し、互換性レポートをエクスポートします。 |
--json-output-dir JSONDIR |
健全性チェックの結果を JSON ファイルとして、指定されたディレクトリ JSONDIR に出力します。 |
健全性チェック コマンドの例：
- 管理ドメインでのみパスワードの健全性を確認します。
./sos --password-health
- すべてのワークロード ドメインの接続の健全性を確認します。
./sos --connectivity-health --domain-name ALL
- sfo-w01 という名前のワークロード ドメインの DNS 健全性を確認します。
./sos --dns-health --domain-name sfo-w01
