Solucionar problemas de atualizações de solução para o Azure Local

Aplica-se a: implantações hiperconvergadas do Azure Local

Este artigo descreve como solucionar problemas de atualizações de solução que você aplica à sua instância de Azure Local para mantê-la up-to-date.

Sobre a solução de problemas de atualizações

Se você implantar seu sistema usando uma nova instalação Azure Local, instale o orquestrador como parte dessa implantação. O orquestrador gerencia atualizações de plataforma, incluindo o sistema operacional, drivers e firmware, além de agentes e serviços.

A nova solução de atualização inclui lógica de repetição e correção. Essa lógica tenta corrigir problemas de atualização de forma não disruptiva, como repetir uma execução da CAU (Atualização com Reconhecimento de Cluster). Se uma execução de atualização não puder ser corrigida automaticamente, ela falhará. Quando uma atualização falhar, inspecione os detalhes da mensagem de falha para determinar a próxima ação apropriada. Você pode tentar retomar a atualização, se apropriado, para determinar se uma nova tentativa resolve o problema.

Solucionar problemas de verificações de preparação

As verificações de preparação são essenciais para garantir que você aplique atualizações sem problemas, mantenha seus sistemas atualizados e mantenha a funcionalidade correta do sistema. As verificações de preparação são executadas e relatadas separadamente em dois cenários:

  • Verificações de integridade do sistema que são executadas uma vez a cada 24 horas.

  • Atualize as verificações de preparação que são executadas depois de baixar o conteúdo da atualização e antes de iniciar a instalação.

É comum que os resultados das verificações de integridade do sistema e das verificações de preparação de atualização diferem. Isso acontece porque as verificações de preparação de atualização usam a lógica de validação mais recente da atualização da solução a ser instalada, enquanto as verificações de integridade do sistema sempre usam a lógica de validação da versão instalada.

As verificações de preparação do sistema e da pré-atualização executam validações semelhantes e categorizam três tipos de verificações de preparação: Crítico, Aviso e Informativo.

  • Crítico: verificações de preparação que impedem a aplicação da atualização. Esse status indica problemas que você deve resolver antes de prosseguir com a atualização.
  • Aviso: verificações de preparação que também impedem a aplicação da atualização, mas você pode ignorá-las. Esse status indica possíveis problemas que podem não ser graves o suficiente para interromper a atualização, mas devem ser resolvidos para garantir um processo de atualização suave.
  • Informativo: verificações de preparação que não bloqueiam a atualização. Esse status fornece informações sobre o estado do sistema e quaisquer possíveis problemas que não devem afetar diretamente o processo de atualização. Essas verificações são para sua conscientização e podem não exigir ação imediata.

As etapas de solução de problemas variam dependendo do cenário de verificação de preparação.

Usando o portal do Azure

Usando o portal do Azure, cenário 1: verificações de integridade do sistema

Esse cenário ocorre ao se preparar para instalar atualizações do sistema no Gerenciador de Atualizações do Azure:

  1. Na lista do sistema, selecione o status de preparação de atualização . Sistemas que exigem atenção mostram um estado crítico ou de aviso .

    captura de tela da página Gerenciador de Atualizações.

  2. Examine a lista de verificações de preparação e seus resultados.

    1. Selecione os links em Detalhes para exibir mais informações.

    2. Quando a caixa de detalhes for aberta, você poderá exibir mais detalhes, resultados individuais do sistema e a Correção para as verificações de integridade que falharam.

      Captura de tela das verificações de preparação com vários erros críticos, realçando uma falha de verificação de integridade do armazenamento e sua mensagem de erro detalhada com diretrizes de correção.

    3. Siga as etapas de correção fornecidas para resolver quaisquer falhas.

    4. Depois de resolver os problemas, selecione Verificar novamente para executar novamente as verificações de preparação.

      Captura de tela das verificações de preparação mostrando o botão Verificar novamente.

Usando o portal Azure, cenário 2: atualizar verificações de preparação

Esse cenário ocorre quando você instala e acompanha as atualizações do sistema no Gerenciador de Atualizações do Azure:

  1. No Histórico, selecione a execução de atualização com falha na lista.

  2. Na guia Validar se o sistema está pronto , examine a lista de verificações de preparação e seus resultados.

    1. Selecione os links exibir detalhes em Detalhes.

    2. Quando a caixa de detalhes for aberta, você poderá exibir mais detalhes, resultados individuais do sistema e a Correção para as verificações de integridade que falharam.

    Captura de tela da página de progresso da atualização.

    Para resolver as falhas, siga as instruções de correção e selecione o botão Tentar novamente para tentar novamente as verificações de preparação de pré-atualização e retomar a atualização.

    Para solucionar mais problemas, consulte a seção do PowerShell.

Usando o PowerShell

Usando o PowerShell, cenário 1: verificações de integridade do sistema

Para solucionar problemas de verificações de integridade do sistema usando o PowerShell:

  1. Para validar se as verificações de integridade do sistema falharam, execute o seguinte comando em um dos computadores em seu sistema:

    Get-SolutionUpdateEnvironment

    Aqui está um exemplo de saída:

    PS C:\Users\lcmuser> Get-SolutionUpdateEnvironment 
ResourceId        : redmond  
SbeFamily         : VirtualForTesting  
HardwareModel     : Virtual Machine  
LastChecked       : 9/12/2023 10:34:42 PM  
PackageVersions   : {Solution: 10.2309.0.20, Services: 10.2309.0.20, Platform: 1.0.0.0, SBE: 4.0.0.0}  
CurrentVersion    : 10.2309.0.20  
CurrentSbeVersion : 4.0.0.0  
LastUpdated       :  
State             : AppliedSuccessfully  
HealthState       : Failure 
HealthCheckResult : {Storage Pool Summary, Storage Services Physical Disks Summary, Storage Services Physical Disks  

                Summary, Storage Services Physical Disks Summary...}  

HealthCheckDate   : 9/12/2023 7:03:32 AM  

AdditionalData    : {[SBEAdditionalData, Solution Builder extension is partially installed. Please install the latest  

                Solution Builder Extension provided by your hardware vendor.  

                For more information, see https://aka.ms/SBE.]}  

HealthState       : Success  
HealthCheckResult : {}  
HealthCheckDate   : 8/4/2022 9:10:36 PM 

PS C:\Users\lcmuser>

  2. Revise o HealthState em seu sistema e veja o valor Failure ou Warning.

  3. Para filtrar a propriedade HealthCheckResult para identificar testes com falha, execute o seguinte comando:

    $result = Get-SolutionUpdateEnvironment

$result.HealthCheckResult | Where-Object {$_.Status -ne "SUCCESS"} | Format-List Title, Status, Severity, Description, Remediation

    Aqui está um exemplo de saída:

    Title       : The machine proxy on each failover cluster node should be set to a local proxy server 
Status      : FAILURE 
Severity    : INFORMATIONAL 
Description : Validating cluster setup for update. 
Remediation : `https://learn.microsoft.com/en-us/windows-server/failover-clustering/cluster-aware-updating-requirements# 
          tests-for-cluster-updating-readiness`

Title       : The CAU clustered role should be installed on the failover cluster to enable self-updating mode 
Status      : FAILURE 
Severity    : INFORMATIONAL 
Description : Validating cluster setup for update. 
Remediation : `https://learn.microsoft.com/en-us/windows-server/failover-clustering/cluster-aware-updating-requirements# 
          tests-for-cluster-updating-readiness`

  4. Revise a propriedade Remediation para os testes que falharam e tome as medidas necessárias para resolver as falhas.

  5. Se você precisar de mais informações de diagnóstico para determinar por que os testes falharam, examine a AdditionalData propriedade usando o -FullHealthCheckDetails parâmetro:

    $FullResults = Get-SolutionUpdateEnvironment -FullHealthCheckDetails

$Failures = $FullResults.HealthCheckResult | Where-Object { $_.Status -ne "SUCCESS" -and $_.Severity -ne "INFORMATIONAL" }

$Failures | Format-List *

  6. Se disponível, use as informações de diagnóstico mostradas na AdditionalData propriedade, como FailedMachines, Sourcee ExceptionMessage para determinar quais computadores físicos estão causando a falha de teste. Em seguida, use o link da propriedade Remediation para resolver as falhas.

  7. Depois de resolver a falha, invoque as verificações de integridade do sistema novamente executando o seguinte comando:

    Invoke-SolutionUpdatePrecheck -SystemHealth

  8. Use Get-SolutionUpdateEnvironment para confirmar se as falhas nas verificações de integridade foram resolvidas. Pode levar alguns minutos para que as verificações de integridade do sistema sejam executadas.

    Aqui está um exemplo de saída:

    PS C:\Users\lcmuser>  Get-SolutionUpdateEnvironment | Format-List HealthState, HealthCheckResult, HealthCheckDate 

HealthState       : InProgress 
HealthCheckResult : 
HealthCheckDate   : 1/1/0001 12:00:00 AM 

PS C:\Users\lcmuser>  Get-SolutionUpdateEnvironment | Format-List HealthState, HealthCheckResult, HealthCheckDate

HealthState       : Success 

HealthCheckResult : {Storage Pool Summary, Storage Subsystem Summary, Storage Services Summary, Storage Services 

                Summary...} 

HealthCheckDate   : 10/18/2024 11:56:49 PM

Usando o PowerShell, cenário 2: atualizar verificações de preparação

Quando as verificações de preparação de atualização falham, a atualização do sistema também falha. Para solucionar problemas de verificações de preparação de atualização usando o PowerShell:

  1. Para verificar se as verificações de preparação de atualização falharam, execute o seguinte comando em um computador em seu sistema para localizar a ResourceId atualização:

    Get-SolutionUpdate | Format-Table ResourceId, State, Version

    Aqui está um exemplo de saída:

    PS C:\Users\lcmuser> Get-SolutionUpdate | Format-Table ResourceId, State, Version

ResourceId                     State                  Version 
----------                     -----                  -------
redmond/Solution10.2405.2.7    HealthCheckFailed      10.2405.2.7

  2. Usando a atualização ResourceId da saída do comando anterior, execute o seguinte comando e substitua o Id parâmetro por esse valor:

    Get-SolutionUpdate -Id <Resource ID> | Format-Table Version, State, HealthCheckResult

    Aqui está um exemplo de saída:

    PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2405.2.7 | Format-Table Version, State, HealthCheckResult 

Version     State              HealthCheckResult 
-------     -----              ----------------- 
10.2405.2.7 HealthCheckFailed {Storage Subsystem Summary, Storage Pool Summary, Storage Services Physical Disks Summary, Stora...                       

PS C:\Users\lcmuser>

  3. Revise o State para a atualização e veja o valor HealthCheckResult.

  4. Para filtrar a HealthCheckResult propriedade e identificar testes com falha, execute o comando a seguir. Substitua o Id valor pela atualização ResourceId do comando anterior.

    $result = Get-SolutionUpdate -Id <Resource ID>
$result.HealthCheckResult | Where-Object {$_.Status -ne "SUCCESS"} | Format-List Title, Status, Severity, Description, Remediation

    Aqui está um exemplo de saída:

    Title       : The machine proxy on each failover cluster node should be set to a local proxy server 
Status      : FAILURE 
Severity    : INFORMATIONAL 
Description : Validating cluster setup for update. 
Remediation : https://learn.microsoft.com/en-us/windows-server/failover-clustering/cluster-aware-updating-requirements# 
          tests-for-cluster-updating-readiness 

Title       : The CAU clustered role should be installed on the failover cluster to enable self-updating mode 
Status      : FAILURE 
Severity    : INFORMATIONAL 
Description : Validating cluster setup for update. 
Remediation : https://learn.microsoft.com/en-us/windows-server/failover-clustering/cluster-aware-updating-requirements# 
          tests-for-cluster-updating-readiness

  5. Use o link na propriedade Remediation para o teste que falhou. Abra o artigo em um dispositivo com um navegador da Web e siga as etapas recomendadas para resolver as falhas.

  6. Se você precisar de mais informações de diagnóstico para determinar por que os testes falharam, examine a AdditionalData propriedade usando o -FullHealthCheckDetails parâmetro:

    $FullResults = Get-SolutionUpdate -Id <Resource ID> -FullHealthCheckDetails

$Failures = $FullResults.HealthCheckResult | Where-Object { $_.Status -ne "SUCCESS" -and $_.Severity -ne "INFORMATIONAL" }

$Failures | Format-List *

  7. Se disponível, use os detalhes de diagnóstico na propriedade AdditionalData, como FailedMachines, Source e ExceptionMessage, para identificar quais máquinas físicas causaram a falha no teste. Em seguida, use o link na propriedade Remediation para resolver as falhas.

  8. Depois de resolver a falha, invoque as verificações de preparação de atualização novamente executando o seguinte comando:

    Get-SolutionUpdate -Id <Resource ID> | Start-SolutionUpdate -PrepareOnly

Solucionar problemas de falhas de atualização

Quando uma atualização falhar, examine o progresso detalhado da etapa para identificar o ponto de falha. Esta revisão ajuda a determinar se você pode resolver o problema reparando e retomando a atualização ou se precisa entrar em contato com o suporte.

  • Nome e descrição da etapa com falha.

  • O computador ou servidor em que a etapa falhou (se houver um problema específico do computador).

  • Cadeia de caracteres de mensagem de falha (pode identificar o problema para um problema conhecido específico com correção documentada).

Use o portal Azure para identificar detalhes da etapa com falha, conforme descrito em Resume uma atualização. Como alternativa, consulte a próxima seção para obter detalhes semelhantes no PowerShell usando Start-MonitoringActionplanInstanceToComplete.

A tabela a seguir lista cenários de falha de atualização e diretrizes de correção.

Nomes de etapas Tipo de problema Remediação
Qualquer Perda de energia ou outra interrupção semelhante ao sistema durante a atualização. 1. Restaurar energia.
2. Executar uma verificação de integridade do sistema.
3. Retome a atualização.
Atualizações da CAU A execução da atualização CAU (Atualização com Reconhecimento de Cluster) falha com um erro de max retries exceeded. Se várias tentativas de CAU falharem, investigue a primeira falha.

Use a hora de início e término da primeira falha para corresponder à saída Get-CauReport correta para investigar ainda mais a falha.
Qualquer Memória, fonte de alimentação, driver de inicialização ou falha crítica semelhante em um ou mais nós. Consulte Reparar um nó no Azure Local para saber como reparar o nó com falha.
Depois que o nó for reparado, retome a atualização.

Coletar logs de atualização

Você também pode coletar logs de diagnóstico para ajudar a Microsoft a identificar e corrigir os problemas.

Para coletar logs para atualizações usando o portal Azure, consulte Resume uma atualização.

Para coletar logs de falhas de atualização, consulte Coletar logs de diagnóstico para o Azure Local.

Exibir o relatório de resumo da atualização

Para exibir um relatório detalhado de resumo de atualizações usando o PowerShell, siga estas etapas no cliente que você está usando para acessar seu sistema:

  1. Estabeleça uma sessão remota do PowerShell com o computador. Execute o PowerShell como administrador e execute o seguinte comando:

    Enter-PSSession -ComputerName <machine_IP_address> -Credential <username\password for the machine>

  2. Obtenha todas as atualizações de soluções e, em seguida, filtre as atualizações de solução que correspondem a uma versão específica. A versão usada corresponde à versão da atualização da solução que não foi instalada.

    $Update = Get-SolutionUpdate | ? Version -eq "<Version string>" -verbose

  3. Identifique o plano de ação para a execução de atualização da solução com falha.

    $Failure = $update | Get-SolutionUpdateRun

  4. Identifique o ResourceID para a atualização.

    $Failure

    Aqui está um exemplo de saída:

    PS C:\Users\lcmuser> $Update = Get-SolutionUpdate | ? Version -eq "10.2303.1.7" -verbose
PS C:\Users\lcmuser> $Failure = $Update | Get-SolutionUpdateRun
PS C:\Users\lcmuser> $Failure

ResourceId      : redmond/Solution10.2303.1.7/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1
Progress        : Microsoft.AzureStack.Services.Update.ResourceProvider.UpdateService.Models.Step
TimeStarted     : 4/21/2023 10:02:54 PM
LastUpdatedTime : 4/21/2023 3:19:05 PM
Duration        : 00:16:37.9688878
State           : Failed

    Observe o ResourceID GUID. Esse GUID corresponde ao ActionPlanInstanceID.

  5. Exiba o resumo do ActionPlanInstanceID que você anotou anteriormente.

    Start-MonitoringActionplanInstanceToComplete -actionPlanInstanceID <Action Plan Instance ID>

    Aqui está a saída de exemplo:

    PS C:\Users\lcmuser> Start-MonitoringActionplanInstanceToComplete -actionPlanInstanceID a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1

    Captura de tela da saída de logs coletados pelo PowerShell.

Retomar uma atualização

Para retomar uma execução de atualização com falha anterior, repita a execução da atualização por meio do portal Azure ou do PowerShell.

O Portal do Azure

Use o portal Azure para navegar até a atualização com falha e selecione o botão Try novamente. Você pode encontrar essa funcionalidade nas atualizações de download, validar se o sistema está pronto e instalar estágios de atualizações de uma execução de atualização.

Captura de tela do botão de tentativa de nova atualização após falha.

Se você não conseguir executar novamente com êxito uma atualização com falha ou precisar solucionar um erro mais adiante, siga estas etapas:

  1. Selecione Exibir detalhes de um erro.

  2. Quando a caixa de detalhes for aberta, examine os detalhes do erro. Para obter mais informações sobre como coletar logs de diagnóstico, selecione o link Como coletar logs ao lado do botão Abrir um chamado de suporte.

    Captura de tela para baixar logs de erros.

    Para obter mais informações sobre como recuperar logs, consulte Coleta de logs de diagnóstico para Azure Local.

  3. Selecione o botão Abrir um chamado de suporte. Preencha as informações apropriadas e anexe seus logs para que eles estejam disponíveis para Suporte da Microsoft.

    Captura de tela para abrir um ticket de suporte.

Para obter mais informações sobre como criar um tíquete de suporte, consulte Criar uma solicitação de suporte.

PowerShell

Se você estiver usando o PowerShell e precisar retomar uma execução de atualização com falha anterior, use o seguinte comando:

Get-SolutionUpdate | ? Version -eq "10.2302.0.31" | Start-SolutionUpdate

Para retomar uma atualização com falha anterior devido a verificações de integridade de atualização em um estado de Aviso , use o seguinte comando:

Get-SolutionUpdate | ? Version -eq "10.2302.0.31" | Start-SolutionUpdate -IgnoreWarnings

Próximas etapas

Saiba mais sobre como executar atualizações por meio do PowerShell.

Saiba mais sobre como executar atualizações por meio do portal do Azure.

  • Last updated on