Usar o comando de execução Set-ToolsRepo

Este artigo mostra como usar o comando Set-ToolsRepo run do início ao fim, como baixar e hospedar a versão correta do GuestStore do arquivo ZIP do VMware Tools e como validar o sucesso.

Quando usar o comando run do Set-ToolsRepo

Use o comando de execução Set-ToolsRepo quando quiser:

• Disponibilize uma versão específica das Ferramentas VMware para instalação e atualização de ferramentas convidadas de VM em uma nuvem privada Solução VMware no Azure.
• Publique centralmente a versão GuestStore do arquivo ZIP das Ferramentas VMware no local central do vSAN para ferramentas VMware para que todos os hosts relevantes possam referenciar o pacote.

Pré-requisitos

• Uma URL HTTP ou HTTPS acessível publicamente que aponta para a versão GuestStore do arquivo ZIP das Ferramentas VMware. A URL deve ser acessível no ambiente de execução para comandos de execução Solução VMware no Azure.
• Permissão para executar pacotes de comando de execução do Solução VMware no Azure no portal do Azure para a nuvem privada de destino.

Conteúdo ZIP esperado

O arquivo ZIP que você carrega deve:

• Inclua um diretório de conteúdo das Ferramentas VMware no layout esperado.
• Contenha a pasta com versão na vmware/apps/vmtools/windows64/vmtools-<version>/ seção. O nome da pasta deve seguir o formato vmtools-<version> (por exemplo, vmtools-12.4.0).

-Validar opção

A opção -Validate habilita um modo de auditoria somente de leitura para o repositório do VMware Tools. Quando você especifica essa opção, 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 -Validate

• Antes de executar Set-ToolsRepo, como uma verificação inicial
• Depois de executar Set-ToolsRepo, para confirmar se tudo está em sincronia
• Se você suspeitar de um problema de repositório ou sincronização e quiser uma verificação rápida em modo somente leitura

O que a opção -Validate verifica

• Identifica todos os datastores vSAN no Data Center Definido por Software (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

Resultados da opção -Validate

• PASS: as versões correspondem e os armazenamentos de dados estão em sincronia.
• FAIL: uma incompatibilidade ou inconsistência é detectada.

Falhas comuns da opção -Validate

• Incompatibilidade de metadados: execute novamente Set-ToolsRepo com uma URL ZIP válida das Ferramentas VMware (sem a opção -Validate ) para reimplantar ou reparar o repositório. Em seguida, execute Set-ToolsRepo -Validate para confirmar se os metadados estão em sincronia.
• Caminho do GuestStore não encontrado: O repositório pode estar ausente ou inacessível. Implante ou reinicialize executando 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 do VMware

O comando de execução Set-ToolsRepo aceita uma URL HTTP ou HTTPS acessível publicamente do arquivo ZIP da versão GuestStore das Ferramentas do VMware, que será publicada no local central do vSAN das Ferramentas do VMware.

Antes que o comando faça alterações, a validação desses itens ocorre:

• 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. Baixe a versão necessária das Ferramentas VMware.

   Obtenha a versão GuestStore do arquivo ZIP das Ferramentas VMware para a versão específica que você deseja publicar no local central do vSAN para ferramentas VMware.

2. Hospede o ZIP em uma URL HTTP ou HTTPS acessível publicamente. Por exemplo, use qualquer servidor Web ou armazenamento de objetos que possa servir o arquivo sem autenticação interativa.

   Em seguida, forneça essa URL de download direto para uso com o comando executar.

   Importante

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

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

   Quando o comando é concluído, sua saída indica êxito ou fornece uma mensagem de erro.

4. O pacote ferramentas VMware é publicado.

   A versão solicitada está disponível no local central do vSAN para ferramentas VMware para a nuvem privada.

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

   Como parte do comando de execução, os hosts ESXi relevantes na nuvem privada são atualizados para usar o local central do vSAN como a origem das Ferramentas VMware.

Validação

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

1. Acesse seu cliente vCenter e navegue pelo armazenamento de dados vSAN. Confirme se a pasta de versão existe em GuestStore/vmware/apps/vmtools/windows64/.

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

3. Se ocorrerem problemas com as Ferramentas VMware após uma operação de comando de execução bem-sucedida, capture a saída do comando e abra uma solicitação de suporte.

Solução de problemas

Se o comando executar falhar, as causas mais comuns do lado do cliente serão:

• A URL não é acessível publicamente como um link de download direto.
• O arquivo ZIP não contém a estrutura de pasta esperada.

Use a mensagem de erro junto com as seguintes etapas de solução de problemas.

Problemas de URL ou download

• A URL não pode ser acessada ou falhou no download. Confirme se a URL é aberta de uma rede externa e se é um link de download direto. Confirme também que a URL não requer login, autenticação multifator ou tokens com tempo de validade limitado.
• 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 arquivo ZIP contém vmware/apps/vmtools/windows64/vmtools-<version> (incluindo o diretório principal vmware/ ).
• Várias versões em um arquivo ZIP. Hospede um arquivo ZIP que contenha apenas a única versão que você pretende publicar, com uma vmtools-<version> pasta.

Problemas de 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 executar ainda falhar, capture a saída completa do comando e abra uma solicitação de suporte.
• Falhas intermitentes. Repita o comando de execução depois de confirmar que a URL ZIP ainda é válida e acessível.

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

A opção Instalar ou Atualizar do VMware Tools pode estar disponível (aparecer esmaecida) para máquinas virtuais no vCenter. Essa situação pode ocorrer quando os metadados do repositório de Ferramentas VMware no armazenamento de dados vSAN são inconsistentes ou incorretos.

Para resolução, use os procedimentos a seguir.

Verificar metadados do repositório no GuestStore

1. Acesse vSAN Datastore>GuestStore>vmware>apps>vmtools>windows64.

   

2. Verifique os seguintes arquivos:

   • Metadados de nível superior: windows64/metadata.json.

     

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

     

Validar consistência de metadados

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

• Corresponda à mesma versão das Ferramentas do VMware.
• Seja consistente entre si (conforme mostrado nas capturas de tela de referência).

Se corresponderem, os metadados serão consistentes. Se eles não corresponderem, os metadados serão inconsistentes.

Corrigir incompatibilidade de metadados (se identificado)

Se o arquivo de nível superior estiver incorreto:

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

2. Carregue o arquivo windows64/metadata.json correto do pacote mais alto das Ferramentas do VMware que você carregou.

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

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

2. Carregue o arquivo windows64/vmtools-<version>/metadata.json correto do pacote mais alto das Ferramentas do VMware que você carregou.

Verifique também se os dois arquivos de metadados correspondem à versão das Ferramentas do VMware.

Aguardar a atualização do host

Dê tempo para a alteração se propagar entre hosts. Isso pode demorar até 24 horas.

Verificar a resolução

Verifique novamente a VM no vCenter. A opção Instalação ou Atualização das Ferramentas VMware agora deve 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 de execução, consulte Usar comandos de execução.