次の方法で共有


Set-ToolsRepo 実行コマンド

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

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

この実行コマンドを使用して、Azure VMware Solution プライベート クラウドでの VM ゲスト ツールのインストールとアップグレードで特定の VMware Tolls バージョンを使用できるようにする必要があります。 関連するすべてのホストがパッケージを参照できるように、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) の形式に従う必要があります。

ツールの 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 がまだ有効で到達可能であることを確認した後、実行コマンドを再試行してください。

次のステップ

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