Команда запуска Set-ToolsRepo

Из этой статьи вы узнаете, как использовать команду Set-ToolsRepo в полном объёме, как скачать и разместить правильную версию ZIP-файла VMware Tools, как мы выполняем команду AVS Run Command и как вы можете проверить успешность выполнения.

Когда следует использовать команду запуска Set-ToolsRepo

Эта команда выполнения должна использоваться для того, чтобы сделать доступной конкретную версию VMware Tools для установки и обновления гостевых инструментов виртуальной машины в частном облаке Azure VMware Solution. Если вы хотите централизованно опубликовать версию средств GuestStore VMware в формате ZIP-файла в центральное расположение инструментов vSAN, чтобы все соответствующие узлы могли ссылаться на пакет.

Предварительные требования

• Общедоступный URL-адрес HTTP/HTTPS, указывающий на версию GuestStore ZIP-файла инструментов VMware (предоставленного клиентом). URL-адрес должен быть доступен из среды выполнения команды запуска решения Azure VMware.
• Разрешение на выполнение пакетов команд запуска решения Azure VMware на портале Azure для целевого частного облака.
• Содержимое ZIP-файла должно включать директорию с полезной нагрузкой VMware Tools в ожидаемом макете.

Ожидаемое ZIP-содержимое

Загруженный ZIP-файл должен содержать папку с версиями в следующем разделе: vmware/apps/vmtools/windows64/vmtools-version<>/. Имя папки должно соответствовать формату vmtools-version<> (например, vmtools-12.4.0).

URL ZIP для инструментов

Команда выполнения Set-ToolsRepo принимает общедоступный URL-адрес HTTP/HTTPS на ZIP-файл версии GuestStore VMware Tools, который будет опубликован в центральном расположении средств vSAN. Перед внесением изменений убедитесь, что URL-адрес доступен для использования, а ZIP-файл можно скачать успешно.

• URL-адрес использует HTTP или HTTPS и является прямой ссылкой для скачивания.
• Файл доступен без интерактивной аутентификации и может быть загружен от начала до конца.

Сквозной рабочий процесс

1. Клиент скачивает необходимую версию средств VMware.
   • Клиент получает версию GuestStore ZIP-файла средств VMware для конкретной версии, которую они хотят опубликовать в центральном расположении средств vSAN.
2. Клиент размещает ZIP-файл в общедоступном расположении HTTP/HTTPS.
   • Клиент должен разместить ZIP-файл в общедоступном URL-адресе HTTP/HTTPS (например, любой веб-сервер или хранилище объектов, которые могут обслуживать файл без интерактивной проверки подлинности). Затем они предоставляют URL-адрес прямого скачивания для использования с командой 'Выполнить'.

3. Клиент запускает команду запуска Set-ToolsRepo.
   • Выполните команду AVS Run и укажите URL-адрес ZIP, предоставленный на шаге 2. По завершении выходные данные команды указывают на успешность или сообщение об ошибке.
4. Пакеты средств VMware публикуются.
   • После успешного завершения команды выполнения запрошенная версия средств VMware доступна в центральном расположении средств vSAN для частного облака.
5. Узлы настроены для использования репозитория vSAN
   • В рамках выполнения команды соответствующие узлы ESXi в частном облаке обновляются, чтобы использовать центральное расположение инструментов vSAN в качестве источника средств VMware.

Validation

После успешного выполнения команды запуска Set-ToolsRepo обязательно выполните указанные ниже действия для проверки.

• Перейдите к клиенту vCenter и перейдите к хранилищу данных vSAN. Убедитесь, что папка версии существует в guestStore/vmware/apps/vmtools/windows64/
• Убедитесь, что правильная версия средств VMware доступна для установки или обновления из гостевой тестовой виртуальной машины.
• Если возникли проблемы с средствами VMware после успешной операции выполнения команды, захватите выходные данные команды run и откройте запрос на поддержку.

Troubleshooting

Если выполнение команды завершается ошибкой, наиболее распространенные клиентские причины заключаются в том, что URL-адрес недоступен как прямая ссылка для загрузки или ZIP-файл не содержит ожидаемой структуры папок.
Используйте сообщение об ошибке вместе с инструкциями по устранению неполадок, перечисленными ниже.

Проблемы с URL-адресом или загрузкой

• URL-адрес недоступен или сбой скачивания. Убедитесь, что URL-адрес открывается из внешней сети, является ссылкой прямого скачивания и не требует авторизации, многофакторной аутентификации или маркеров с ограниченным сроком действия.
• Ошибка TLS/SSL. Убедитесь, что конечная точка HTTPS поддерживает современный TLS и представляет действительный сертификат.

Проблемы со структурой ZIP

• Ожидаемая папка не найдена. Убедитесь, что ZIP-файл содержит vmware/apps/vmtools/windows64/vmtools-<version> (включая начальный каталог vmware/).
• Несколько версий в одном ZIP-файле. Разместите ZIP-файл, содержащий только одну версию, которую вы планируете опубликовать, с одной папкой vmtools-<version>.

Проблемы с хранилищем данных

• Ошибка публикации и настройки на стороне службы. Если URL-адрес и структура ZIP верны, но команда по-прежнему завершается ошибкой, захватить полные выходные данные команды выполнения и открыть запрос на поддержку.
• Периодические сбои. Повторите команду выполнения после подтверждения, что URL-адрес ZIP по-прежнему действителен и доступен.

Следующий шаг

Дополнительные сведения о командах выполнения см. в разделе Запуск команд.