この記事では、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 を使用し、直接ダウンロード リンクです。
- ファイルは対話型認証なしで到達可能であり、エンド ツー エンドでダウンロードできます。
端から端までのワークフロー
- お客様は、必要な VMware Tools バージョンをダウンロードします。
- お客様は、vSAN 中央ツールの場所に発行する特定のバージョンの VMware Tools ZIP ファイルの GuestStore バージョンを取得します。
- お客様は、パブリックにアクセスできる HTTP/HTTPS の場所で ZIP ファイルをホストします。
- お客様は、パブリックにアクセスできる HTTP/HTTPS URL (対話型認証なしでファイルを提供できる Web サーバーまたはオブジェクト ストレージなど) で ZIP をホストする必要があります。 次に、実行コマンドで使用する直接ダウンロード URL を指定します。
Important
RUN Command が ZIP ファイルを取得できるように、URL は直接ダウンロード リンクであり、対話型認証なしで到達可能である必要があります。
- お客様は、Set-ToolsRepo 実行コマンドを実行します。
- AVS 実行コマンドを実行し、手順 2 で共有する ZIP URL を指定します。 完了すると、コマンド出力は成功を示すか、エラー メッセージを提供します。
- パッケージ化された VMware Tools が発行されます。
- コマンドの実行が正常に完了すると、要求された VMware Tools バージョンは、プライベート クラウドの vSAN 中央ツールの場所から入手できます。
- 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 がまだ有効で到達可能であることを確認した後、実行コマンドを再試行してください。
次のステップ
コマンドの実行の詳細については、「コマンドの 実行」を参照してください。