Usa o comando Set-ToolsRepo run

Este artigo mostra-lhe como usar o Set-ToolsRepo comando run de ponta a ponta, como descarregar e alojar a versão correta do ficheiro ZIP do VMware Tools no GuestStore e como validar o sucesso.

Quando usar o comando Set-ToolsRepo run

Use o Set-ToolsRepo comando run quando quiser:

• Disponibilize uma versão específica do VMware Tools para instalação e atualização das ferramentas convidadas de VM numa cloud privada do Solução VMware no Azure.
• Publique centralmente a versão GuestStore do ficheiro ZIP do VMware Tools na localização central do vSAN para o VMware Tools, para que todos os hosts relevantes possam referenciar o pacote.

Pré-requisitos

• Um URL HTTP ou HTTPS acessível publicamente que aponta para a versão GuestStore do seu ficheiro ZIP do VMware Tools. A URL deve ser acessível a partir do ambiente de execução para os comandos de execução do Solução VMware no Azure.
• Permissão para executar pacotes de comandos de execução do Solução VMware no Azure no portal do Azure para a cloud privada de destino.

Conteúdo ZIP esperado

O ficheiro ZIP que carrega deve:

• Inclua um diretório de payload do VMware Tools no layout esperado.
• Contém a pasta versionada abaixo da vmware/apps/vmtools/windows64/vmtools-<version>/ secção. O nome da pasta deve seguir o formato vmtools-<version> (por exemplo, vmtools-12.4.0).

-Validar opção

A -Validate opção permite um modo de auditoria apenas de leitura para o repositório VMware Tools. Ao especificar esta opção, Set-ToolsRepo inspeciona os ficheiros de metadados atuais do datastore sem fazer quaisquer alterações ao seu ambiente.

Quando usar a opção -Validate

• Antes de executar Set-ToolsRepo, como verificação de referência
• Depois de executares Set-ToolsRepo, para confirmar que está tudo sincronizado
• Se suspeitar de um problema de repositório ou sincronização e quiser uma verificação rápida só de leitura

O que a opção -Validate verifica

• Identifica todos os datastores vSAN no Centro de Dados Definido por Software (SDDC)
• Lê os 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

Resultados da opção -Validate

• PASS: As versões coincidem e os armazenamentos de dados estão sincronizados.
• FAIL: É detetada uma incompatibilidade ou inconsistência.

Falhas comuns da opção -Validate

• Incompatibilidade de metadados: Reexecute Set-ToolsRepo com um URL ZIP válido do VMware Tools (sem a -Validate opção) para redistribuir ou reparar o repositório. Depois executa Set-ToolsRepo -Validate para confirmar que os metadados estão sincronizados.
• Caminho da GuestStore não encontrado: O repositório pode estar em falta ou inacessível. Implemente ou reinicie correndo Set-ToolsRepo com um URL ZIP válido (sem essa -Validate opção). Depois, execute Set-ToolsRepo -Validate para verificar se o repositório está presente e sincronizado.

URL do ficheiro ZIP do VMware Tools

O comando Set-ToolsRepo run aceita um URL HTTP ou HTTPS publicamente acessível da versão GuestStore do ficheiro ZIP do VMware Tools, que será publicado na localização central do vSAN do VMware Tools.

Antes de o comando fazer quaisquer alterações, ocorre a validação destes itens:

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

Fluxo de trabalho ponto a ponto

1. Descarregue a versão necessária para VMware Tools.

   Obtenha a versão GuestStore do ficheiro ZIP do VMware Tools para a versão específica que pretende publicar no local central do vSAN para o VMware Tools.

2. Aloje o ficheiro ZIP num URL HTTP ou HTTPS acessível publicamente. Por exemplo, utilize qualquer servidor web ou armazenamento de objetos que possa servir o ficheiro sem autenticação interativa.

   Depois, fornece esse URL de download direto para usar com o comando run.

   Importante

   A URL deve ser um link de download direto e ser acessível sem autenticação interativa, para que o comando run possa recuperar o ficheiro ZIP.

3. Execute o comando run da Solução VMware no Azure Set-ToolsRepo. Forneça o URL ZIP do passo 2.

   Quando o comando termina, a sua saída indica sucesso ou fornece uma mensagem de erro.

4. O pacote VMware Tools é publicado.

   A versão solicitada está disponível a partir da localização central do vSAN para o VMware Tools da nuvem privada.

5. Os hosts estão configurados para usar o repositório vSAN.

   Como parte do comando de execução, os hosts ESXi relevantes na cloud privada são configurados para utilizar o local central do vSAN como origem das VMware Tools.

Validação

Após a execução bem-sucedida do Set-ToolsRepo comando run, siga estes passos de validação:

1. Vai ao teu cliente vCenter e navega pela loja de dados vSAN. Confirme que a pasta de versões existe em GuestStore/vmware/apps/vmtools/windows64/.

2. Confirme se a versão correta do VMware Tools está disponível para instalação ou atualização dentro de uma máquina virtual de teste convidado (VM).

3. Se surgirem problemas com o VMware Tools após uma operação de execução bem-sucedida, capture a saída do comando e abra um pedido de suporte.

Troubleshooting

Se o comando run falhar, as causas mais comuns do lado do cliente são:

• O URL não é acessível publicamente como link direto para download.
• O ficheiro ZIP não contém a estrutura de pastas esperada.

Use a mensagem de erro juntamente com os seguintes passos de resolução de problemas.

URL ou problemas de download

• URL inacessível ou falha no download. Confirme que a URL abre a partir de uma rede externa e é um link de download direto. Confirme também que o URL não requer login, autenticação multifator ou tokens com limite de tempo.
• Erro TLS/SSL. Certifique-se de que o endpoint HTTPS suporta TLS moderno e apresenta um certificado válido.

Problemas de estrutura ZIP

• Pasta esperada não encontrada. Certifique-se de que o ficheiro ZIP contém vmware/apps/vmtools/windows64/vmtools-<version> (incluindo o diretório inicial vmware/ ).
• Múltiplas versões num único ficheiro ZIP. Aloje um ficheiro ZIP que contenha apenas a única versão que pretende publicar, com uma pasta vmtools-<version> .

Problemas com o armazenamento de dados

• Erro de publicação ou configuração do lado do serviço. Se a URL e a estrutura ZIP estiverem corretas mas o comando run continuar a falhar, capture a saída completa do comando e abra um pedido de suporte.
• Falhas intermitentes. Tenta novamente o comando run depois de confirmares que o URL do ZIP ainda é válido e acessível.

A opção de atualização do VMware Tools não está disponível e não está na versão atual

A opção de Instalação ou Atualização das Ferramentas VMware pode estar disponível (parece diminuída) para máquinas virtuais no vCenter. Esta situação pode ocorrer quando os metadados do repositório VMware Tools na loja vSAN são inconsistentes ou incorretos.

Para a resolução, utilize os seguintes procedimentos.

Verificar metadados do repositório na GuestStore

1. Aceda a vSAN Datastore>GuestStore>vmware>apps>vmtools>windows64.

   

2. Verifique os seguintes ficheiros:

   • Metadados de topo: windows64/metadata.json.

     

   • Metadados específicos de versão: windows64/vmtools-<version>/metadata.json.

     

Validar a consistência dos metadados

O ficheiro de nível superior metadata.json e o ficheiro metadata.json específico da versão devem:

• Corresponde à mesma versão do VMware Tools.
• Sejam consistentes uns com os outros (como mostrado nas capturas de ecrã de referência).

Se coincidirem, os metadados são consistentes. Se não coincidirem, os metadados são inconsistentes.

Corrigir a incompatibilidade de metadados (se identificada)

Se o ficheiro de topo estiver incorreto:

1. Eliminar windows64/metadata.json (por exemplo, vSAN Datastore/GuestStore/vmware/apps/vmtools/windows64/metadata.json).

2. Carrega o ficheiro correto windows64/metadata.json do pacote VMware Tools mais alto que carregaste.

Se o ficheiro específico da versão estiver incorreto:

1. Eliminar windows64/vmtools-<version>/metadata.json (por exemplo, vSAN Datastore/GuestStore/vmware/apps/vmtools/windows64/vmtools-<version>/metadata.json).

2. Carrega o ficheiro correto windows64/vmtools-<version>/metadata.json do pacote VMware Tools mais alto que carregaste.

Certifique-se também de que ambos os ficheiros de metadados correspondem à versão do VMware Tools.

Aguarde pela atualização do host

Dê tempo para que a mudança se propague entre hospedeiros. Pode demorar até 24 horas.

Verificar a resolução

Verifica novamente a VM no vCenter. A opção de Instalação ou Atualização do VMware Tools deverá agora estar disponível.

Confirmar consistência (opcional)

Execute Set-ToolsRepo -Validate para confirmar a consistência dos metadados.

Conteúdo relacionado

• Para saber mais sobre comandos run, veja Usar comandos run.