Set-ToolsRepo 実行コマンド

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

Set-ToolsRepo Run Command を使用するタイミング

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

前提条件

  • ゲスト ストア バージョンの VMware Tools zip ファイル (顧客が提供) を指すパブリックにアクセス可能な HTTP/HTTPS URL。 この URL は、Azure VMware Solution Run Command 実行環境から到達可能である必要があります。
  • ターゲット プライベート クラウドの Azure portal で Azure VMware Solution 実行コマンド パッケージを実行するアクセス許可。
  • ZIP コンテンツには、予想されるレイアウトに VMware Tools ペイロード ディレクトリが含まれている必要があります。

予想される ZIP コンテンツ

アップロードする ZIP ファイルには、 vmware/apps/vmtools/windows64/vmtools-<version>/ セクションの下にバージョン管理されたフォルダーが含まれている必要があります。 フォルダー名は 、vmtools-<version> ( 例: vmtools-12.4.0) の形式に従う必要があります。

検証オプション

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

[検証] オプションを使用する場合

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

検証オプションで確認される内容

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

結果の検証

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

[検証] オプションの一般的なエラー

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

ツールの ZIP URL

Set-ToolsRepo 実行コマンドは、vSAN 中央ツールの場所に発行される VMware Tools zip ファイルの GuestStore バージョンへのパブリックにアクセス可能な HTTP/HTTPS URL を受け入れます。 変更を加える前に、URL が使用可能であり、ZIP ファイルを正常にダウンロードできることを検証します。

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

端から端までのワークフロー

  1. お客様は、必要な VMware Tools バージョンをダウンロードします。
    • お客様は、vSAN 中央ツールの場所に発行する特定のバージョンの VMware Tools ZIP ファイルの GuestStore バージョンを取得します。
  2. お客様は、パブリックにアクセスできる HTTP/HTTPS の場所で ZIP ファイルをホストします。
    • お客様は、パブリックにアクセスできる HTTP/HTTPS URL (対話型認証なしでファイルを提供できる Web サーバーまたはオブジェクト ストレージなど) で ZIP をホストする必要があります。 次に、実行コマンドで使用する直接ダウンロード URL を指定します。

Important

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

  1. お客様は、Set-ToolsRepo 実行コマンドを実行します。
    • AVS 実行コマンドを実行し、手順 2 で共有する ZIP URL を指定します。 完了すると、コマンド出力は成功を示すか、エラー メッセージを提供します。
  2. パッケージ化された VMware Tools が発行されます。
    • コマンドの実行が正常に完了すると、要求された VMware Tools バージョンは、プライベート クラウドの vSAN 中央ツールの場所から入手できます。
  3. vSAN リポジトリを使用するようにホストが構成されている
    • 実行コマンドの一部として、プライベート クラウド内のリラバント ESXi ホストが更新され、vSAN の中央ツールの場所が VMware Tools ソースとして使用されます。

検証

Set-ToolsRepo 実行コマンドが正常に実行されたら、検証のために以下の手順に従ってください。

  • vCenter クライアントに移動し、vSAN データストアを参照します。 GuestStore/vmware/apps/vmtools/windows64/ の下にバージョン フォルダーが存在するかどうかを確認する
  • ゲスト テスト VM 内から正しい VMware Tools バージョンをインストールまたはアップグレードできるかどうかを確認します。
  • コマンドの実行操作が成功した後に VMware Tools で問題が発生した場合は、コマンドの実行出力をキャプチャし、サポート要求を開きます。

Troubleshooting

実行コマンドが失敗した場合、最も一般的な原因は、URL が直接ダウンロード リンクとしてパブリックに到達できないか、ZIP に想定されるフォルダー構造が含まれていないためです。
エラー メッセージと、以下に示すトラブルシューティング手順を使用します。

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

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

ZIP 構造の問題

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

データストアの問題

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

次のステップ

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

  • Last updated on