Set-ToolsRepo 実行コマンドを使用する

この記事では、 Set-ToolsRepo 実行コマンドをエンド ツー エンドで使用する方法、VMware Tools ZIP ファイルの正しい GuestStore バージョンをダウンロードしてホストする方法、成功を検証する方法について説明します。

Set-ToolsRepo 実行コマンドを使用するタイミング

Set-ToolsRepo実行コマンドは、次の場合に使用します。

  • 特定の VMware Tools バージョンを、Azure VMware Solutionプライベート クラウドでの VM ゲスト ツールのインストールとアップグレードに使用できるようにします。
  • 関連するすべてのホストがパッケージを参照できるように、VMware Tools ZIP ファイルの GuestStore バージョンを VMware Tools の vSAN の中央の場所に一元的に発行します。

前提条件

  • VMware Tools ZIP ファイルの GuestStore バージョンを指すパブリックにアクセス可能な HTTP または HTTPS URL。 URL は、Azure VMware Solution の実行コマンドの実行環境からアクセス可能である必要があります。
  • 対象のプライベート クラウドに対して、Azure ポータルで Azure VMware Solution のコマンド パッケージを実行するためのアクセス許可。

予想される ZIP コンテンツ

アップロードする ZIP ファイルは次の必要があります。

  • VMware Tools ペイロード ディレクトリを予想されるレイアウトに含めます。
  • vmware/apps/vmtools/windows64/vmtools-<version>/ セクションの下にバージョン管理されたフォルダーを含めます。 フォルダー名は、 vmtools-<version> 形式 (たとえば、 vmtools-12.4.0) に従う必要があります。

-検証オプション

-Validate オプションを使用すると、VMware Tools リポジトリの読み取り専用監査モードが有効になります。 このオプションを指定すると、 Set-ToolsRepo は環境に変更を加えずに、現在のデータストア メタデータ ファイルを検査します。

-Validate オプションを使用するタイミング

  • Set-ToolsRepoを実行する前に、ベースライン チェックとして
  • Set-ToolsRepoを実行した後、すべてが同期されていることを確認します
  • リポジトリまたは同期の問題が疑われ、読み取り専用のクイック チェックが必要な場合

-Validate オプションで確認される内容

  • Software-Defined データ センター (SDDC) 内のすべての vSAN データストアを識別します
  • リポジトリメタデータを読み取ります (top-level-metadata.json と version-metadata.json)
  • メタデータとデータストアの状態が一貫性があり、同期されていることを確認します

-Validate オプションの結果

  • PASS: バージョンが一致し、データストアが同期されています。
  • FAIL: 不一致または不整合が検出されました。

コモン - 検証オプションのエラー

  • メタデータの不一致: 有効な VMware Tools ZIP URL (Set-ToolsRepo オプションなし) を使用して-Validateを再実行して、リポジトリを再デプロイまたは修復します。 次に、 Set-ToolsRepo -Validate を実行して、メタデータが同期されていることを確認します。
  • GuestStore パスが見つかりません: リポジトリが見つからないか、アクセスできない可能性があります。 -Validate オプションを使用せず、有効な ZIP URL を指定して Set-ToolsRepo を実行し、デプロイまたは再初期化します。 次に、 Set-ToolsRepo -Validate を実行して、リポジトリが存在し、同期されていることを確認します。

VMware Tools の ZIP URL

Set-ToolsRepo実行コマンドは、VMware Tools の vSAN の中央の場所に発行される VMware Tools ZIP ファイルの GuestStore バージョンへのパブリックにアクセス可能な HTTP または HTTPS URL を受け入れます。

コマンドが変更を行う前に、次の項目の検証が行われます。

  • URL は HTTP または HTTPS を使用し、直接ダウンロード リンクです。
  • ファイルは対話型認証なしで到達可能であり、エンド ツー エンドでダウンロードできます。

エンド ツー エンド ワークフロー

  1. 必要な VMware Tools バージョンをダウンロードします。

    VMware Tools 用の vSAN の一元的な格納場所に公開したい特定のバージョンに対応する、VMware Tools ZIP ファイルの GuestStore 版を取得します。

  2. パブリックにアクセスできる HTTP または HTTPS URL で ZIP をホストします。 たとえば、対話型認証なしでファイルを提供できる任意の Web サーバーまたはオブジェクト ストレージを使用します。

    次に、run コマンドで使用する直接ダウンロード URL を指定します。

    Important

    実行コマンドが ZIP ファイルを取得できるように、URL は直接ダウンロード リンクであり、対話型認証なしで到達可能である必要があります。

  3. Azure VMware Solution Set-ToolsRepo実行コマンドを実行します。 手順 2 の ZIP URL を指定します。

    コマンドが完了すると、その出力は成功を示すか、エラー メッセージを提供します。

  4. VMware Tools パッケージが発行されます。

    要求されたバージョンは、プライベート クラウド用の VMware Tools の vSAN の中央の場所から入手できます。

  5. ホストは、vSAN リポジトリを使用するように構成されます。

    実行コマンドの一部として、プライベート クラウド内の関連する ESXi ホストが更新され、vSAN の中央の場所が VMware Tools ソースとして使用されます。

検証

Set-ToolsRepo実行コマンドが正常に実行されたら、次の検証手順に従います。

  1. vCenter クライアントに移動し、vSAN データストアを参照します。 GuestStore/vmware/apps/vmtools/windows64/の下にバージョン フォルダーが存在することを確認します。

  2. ゲスト テスト仮想マシン (VM) 内から正しい VMware Tools バージョンをインストールまたはアップグレードできるかどうかを確認します。

  3. コマンドの実行操作が成功した後に VMware Tools で問題が発生した場合は、コマンドの出力をキャプチャし、サポート要求を開きます。

Troubleshooting

実行コマンドが失敗した場合、最も一般的な顧客側の原因は次のとおりです。

  • URL は、直接ダウンロード リンクとしてパブリックに到達できません。
  • ZIP ファイルには、予期されるフォルダー構造が含まれません。

次のトラブルシューティング手順と共に、エラー メッセージを使用します。

URL またはダウンロードの問題

  • URL に到達できないか、ダウンロードに失敗しました。 URL が外部ネットワークから開き、直接ダウンロード リンクであることを確認します。 また、URL にサインイン、多要素認証、または時間制限付きトークンが必要ないことを確認します。
  • TLS/SSL エラー。 HTTPS エンドポイントが最新の TLS をサポートし、有効な証明書を提示していることを確認します。

ZIP 構造の問題

  • 予期されるフォルダーが見つかりません。 ZIP ファイルに vmware/apps/vmtools/windows64/vmtools-<version> (先頭の vmware/ ディレクトリを含む) が含まれていることを確認します。
  • 1 つの ZIP ファイル内の複数のバージョン。 発行する 1 つのバージョンのみを含む ZIP ファイルを、1 つの vmtools-<version> フォルダーでホストします。

データストアの問題

  • サービス側の発行または構成エラー。 URL と ZIP の構造が正しく、実行コマンドが失敗する場合は、コマンドの完全な出力をキャプチャし、サポート要求を開きます。
  • 断続的なエラー。 ZIP URL がまだ有効で到達可能であることを確認した後、実行コマンドを再試行してください。

VMware Tools のアップグレード オプションは使用できず、現在のバージョンでは使用できません

VMware Tools の [インストール または アップグレード ] オプションは、vCenter の仮想マシンで使用できる (淡色表示) 場合があります。 この状況は、vSAN データストア内の VMware Tools リポジトリのメタデータに一貫性がない、または正しくない場合に発生する可能性があります。

解決には、次の手順を使用します。

GuestStore でリポジトリ メタデータを確認する

  1. vSAN データストア>GuestStore>vmware>apps>vmtools>windows64 に移動します。

    vSAN データストアの GuestStore パスのスクリーンショット。

  2. 次のファイルを確認します。

    • 最上位のメタデータ: windows64/metadata.json。

      windows64 ディレクトリの最上位 metadata.json ファイルのスクリーンショット。

    • バージョン固有のメタデータ: windows64/vmtools-<version>/metadata.json。

      vmtools バージョン フォルダー内のバージョン固有の metadata.json ファイルのスクリーンショット。

メタデータの整合性を検証する

最上位の metadata.json ファイルとバージョン固有の metadata.json ファイルは、次の手順を実行する必要があります。

  • 同じ VMware Tools バージョンに一致させます。
  • (参照スクリーンショットに示すように) 互いに一貫性を保つ。

一致する場合、メタデータは一貫性があります。 一致しない場合、メタデータに一貫性がありません。

メタデータの不一致を修正する (特定された場合)

最上位ファイルが正しくない場合:

  1. windows64/metadata.json (たとえば、vSAN Datastore/GuestStore/vmware/apps/vmtools/windows64/metadata.json) を削除します。

  2. アップロードした最も高い VMware Tools パッケージから正しい windows64/metadata.json ファイルをアップロードします。

バージョン固有のファイルが正しくない場合:

  1. windows64/vmtools-<version>/metadata.json (たとえば、vSAN Datastore/GuestStore/vmware/apps/vmtools/windows64/vmtools-<version>/metadata.json) を削除します。

  2. アップロードした最も高い VMware Tools パッケージから正しい windows64/vmtools-<version>/metadata.json ファイルをアップロードします。

また、両方のメタデータ ファイルが VMware Tools のバージョンと一致していることを確認します。

ホストの更新を待機する

変更がホスト間で反映されるまでの時間を許可します。 最大で 24 時間かかる。

解決策を確認する

vCenter で VM を再確認します。 VMware Tools の [インストール または アップグレード ] オプションを使用できるようになりました。

整合性の確認 (省略可能)

Set-ToolsRepo -Validateを実行して、メタデータの整合性を確認します。

関連するコンテンツ

  • 実行コマンドの詳細については、「実行 コマンドの使用」を参照してください。
  • Last updated on