Executar comando Set-ToolsRepo

Neste artigo, saiba como usar o comando Set-ToolsRepo Executar de ponta a ponta, como baixar e hospedar a versão do GuestStore correta do arquivo zip das Ferramentas do VMware, como executamos o Comando de Execução da AVS e como você pode validar o êxito.

Quando Executar Comando Set-ToolsRepo

Esse Comando de Execução deve ser usado para disponibilizar uma versão específica das Ferramentas do VMware para instalação e atualizações de ferramentas convidadas de VM em uma nuvem privada Solução VMware no Azure. Quando você quiser publicar centralmente a versão GuestStore do arquivo ZIP das ferramentas VMware no local das Ferramentas centrais do vSAN para que todos os hosts relevantes possam referenciar o pacote.

Pré-requisitos

• Uma URL HTTP/HTTPS acessível publicamente que aponta para a versão GuestStore do arquivo zip das Ferramentas VMware (fornecida pelo cliente). A URL deve ser acessível a partir do ambiente de execução do Run Command da Solução VMware no Azure.
• Permissão para executar pacotes Run Command do Solução VMware no Azure no portal do Azure para a nuvem privada de destino.
• O conteúdo zip deve incluir um diretório de conteúdo das Ferramentas VMware no layout esperado.

Conteúdo ZIP esperado

O arquivo ZIP que você carrega deve conter a pasta com versão na seguinte seção: vmware/apps/vmtools/windows64/vmtools-version<>/. O nome da pasta deve seguir o formato vmtools-version<> (por exemplo, vmtools-12.4.0).

Validar opção

A opção Validar habilita um modo de auditoria somente leitura para o repositório Ferramentas. Quando especificado, Set-ToolsRepo inspeciona os arquivos de metadados atuais do armazenamento de dados sem fazer nenhuma alteração em seu ambiente.

Quando usar a opção Validar

• Antes de executar Set-ToolsRepo (verificação de linha de base)
• Depois de executar Set-ToolsRepo (confirme se tudo está em sincronia)
• Se você suspeitar de um problema de repositório/sincronização e quiser uma verificação rápida em modo somente leitura

O que a opção de validação verifica

• Identifica todos os armazenamentos de dados vSAN no SDDC
• Lê metadados do repositório (top-level-metadata.json e version-metadata.json)
• Verifica se os metadados e o estado do armazenamento de dados são consistentes e sincronizados

Validar resultados

• PASS: as versões correspondem e os armazenamentos de dados estão sincronizados
• FAIL: incompatibilidade/inconsistência detectada

Falhas comuns na opção Validar

• Incompatibilidade de metadados → executar novamente Set-ToolsRepo com uma URL ZIP de Ferramentas válida (sem -Validate opção) para reimplantar/reparar o repositório e, em seguida, executar Set-ToolsRepo -Validate para confirmar se os metadados estão em sincronia.
• Caminho GuestStore não encontrado → O repositório pode estar ausente ou inacessível; implante/reinicialize ao executar Set-ToolsRepo com uma URL ZIP válida (sem a opção -Validate); em seguida, execute Set-ToolsRepo -Validate para verificar se o repositório está presente e sincronizado.

URL zip das ferramentas

O comando Set-ToolsRepo Run aceita uma URL HTTP/HTTPS acessível publicamente para a versão GuestStore do arquivo zip das Ferramentas VMware a ser publicada no local central das Ferramentas do vSAN. Antes de fazer alterações, a validação de que a URL é utilizável e o arquivo ZIP pode ser baixado com êxito.

• A URL usa HTTP ou HTTPS e é um link de download direto.
• O arquivo é acessível sem autenticação interativa e pode ser baixado de ponta a ponta.

Fluxo de trabalho de ponta a ponta

1. O cliente baixa a versão necessária das Ferramentas VMware.
   • O cliente obtém a versão GuestStore do arquivo ZIP das Ferramentas VMware para a versão específica que deseja publicar no local das Ferramentas centrais do vSAN.
2. O cliente hospeda o arquivo ZIP em um local HTTP/HTTPS acessível publicamente.
   • O cliente deve hospedar o ZIP em uma URL HTTP/HTTPS acessível publicamente (por exemplo, qualquer servidor Web ou armazenamento de objetos que possa servir o arquivo sem autenticação interativa). Em seguida, eles fornecem essa URL de download direto para uso com o Comando Executar.

3. O cliente executa o comando de execução Set-ToolsRepo.
   • Execute o Comando de Execução da AVS e forneça a URL ZIP compartilhada na etapa 2. Quando for concluída, a saída do comando indicará êxito ou fornecerá uma mensagem de erro.
4. As Ferramentas do VMware empacotadas são publicadas.
   • Depois que o Comando Executar for concluído com êxito, a versão solicitada das Ferramentas VMware estará disponível no local das Ferramentas Centrais do vSAN para a nuvem privada.
5. Os hosts são configurados para usar o repositório vSAN
   • Como parte do Comando Executar, os hosts ESXi relevantes na nuvem privada são atualizados para usar a localização das ferramentas centrais vSAN como a fonte do VMware Tools.

Validação

Após a execução bem-sucedida do comando Set-ToolsRepo, siga as etapas abaixo para validação.

• Navegue até o cliente do vCenter e explore o datastore vSAN. confirme se a pasta de versão existe em GuestStore/vmware/apps/vmtools/windows64/
• Confirme se a versão correta das Ferramentas VMware está disponível para instalação ou atualização de dentro de uma VM de teste de convidado.
• Se ocorrerem problemas com as Ferramentas do VMware após uma operação de Comando de Execução bem-sucedida, capture a saída do Comando de Execução e abra uma solicitação de suporte.

Solução de problemas

Se o Comando Executar falhar, as causas mais comuns do lado do cliente são que a URL não pode ser acessada publicamente como um link de download direto ou o ZIP não contém a estrutura de pastas esperada.
Use a mensagem de erro junto com as etapas de solução de problemas listadas abaixo.

Problemas de URL ou Download

• A URL não pode ser acessada ou o download falha. Confirme se a URL abre-se a partir de uma rede externa, é um link de download direto e não requer autenticação, MFA ou tokens com validade limitada.
• Erro TLS/SSL. Verifique se o ponto de extremidade HTTPS dá suporte ao TLS moderno e apresenta um certificado válido.

Problemas de estrutura ZIP

• Pasta esperada não encontrada. Verifique se o ZIP contém vmware/apps/vmtools/windows64/vmtools-<version> (incluindo o diretório inicial vmware/).
• Várias versões em um ZIP. Hospede um ZIP que contenha apenas a versão única que você pretende publicar, com uma pasta vmtools-version<>.

Problemas de armazenamento de dados

• Erro de publicação/configuração do lado do serviço. Se a URL e a estrutura ZIP estiverem corretas, mas o comando ainda falhar, capture a saída completa do Comando executar e abra uma solicitação de suporte.
• Falhas intermitentes. Repita o Comando Executar depois de confirmar que a URL ZIP ainda é válida e acessível.

Próxima etapa

Para saber mais sobre Comandos de Execução, consulte Executar Comandos.