Partilhar via

Atualize seu Azure Local, versão 23H2 via PowerShell

  • Artigo

Aplica-se a: Azure Local, versão 23H2

Este artigo descreve como aplicar uma atualização de solução ao seu Azure Local via PowerShell.

O procedimento neste artigo aplica-se a sistemas de nó único e de vários nós que executam a versão mais recente do Azure Local com o orquestrador (Lifecycle Manager) instalado. Se o seu sistema foi criado por meio de uma nova implantação do Azure Local, versão 23H2, o orquestrador foi instalado automaticamente como parte da implantação.

Importante

O procedimento descrito aqui se aplica somente ao atualizar de uma versão do Azure Local, versão 23H2 para outra versão superior. Para obter informações sobre atualizações para versões mais antigas, consulte Atualizar clusters para o Azure Local, versão 22H2.

Sobre as atualizações da solução

As atualizações da solução Local do Azure podem consistir em atualizações de plataforma, serviço e extensão de solução. Para obter mais informações sobre cada um desses tipos de atualizações, consulte Sobre atualizações para o Azure Local, versão 23H2.

Quando você aplica uma atualização de solução, aqui estão as etapas de alto nível que você executa:

  1. Certifique-se de que todos os pré-requisitos estão concluídos.
  2. Conecte-se à sua instância local do Azure por meio do PowerShell remoto.
  3. Confirme as versões atuais do software instalado e verifique se o cluster está em boas condições.
  4. Descubra as atualizações que estão disponíveis e filtre as que você pode aplicar ao seu sistema.
  5. (Recomendado) Faça o download prévio das atualizações e avalie a prontidão de atualização do seu sistema.
  6. Instale as atualizações e acompanhe o progresso das atualizações. Monitore os progressos detalhados conforme necessário.
  7. Verifique a versão das atualizações instaladas.

O tempo necessário para instalar as atualizações varia com base nos seguintes fatores:

  • Conteúdo da atualização.
  • Carregue no seu sistema.
  • Número de máquinas no seu sistema.
  • Tipo de hardware utilizado.
  • Extensão da solução utilizada.

As estimativas de tempo aproximado para um sistema típico de um ou vários nós são resumidas na tabela a seguir:

Sistema/Hora Tempo para o exame de saúde
hh:mm:ss		 Tempo para instalar a atualização
hh:mm:ss
Nó único 0:01:44 1:25:42
4-nós 0:01:58 3:53:09

Pré-requisitos

Antes de começar, certifique-se de que:

  • Você tem acesso a um sistema Azure Local, versão 23H2 que esteja executando 2311 ou superior. O sistema deve ser registrado no Azure.
  • Você tem acesso a um cliente que pode se conectar ao seu Azure Local.
  • Você tem acesso à atualização da solução pela rede.

Conectar-se ao seu Azure Local

Siga estas etapas em seu cliente para se conectar a uma das máquinas em seu Azure Local.

  1. Execute o PowerShell como administrador no cliente que você está usando para se conectar ao seu sistema.

  2. Abra uma sessão remota do PowerShell em uma máquina em seu Azure Local. Execute o seguinte comando e forneça as credenciais da sua máquina quando solicitado:

    $cred = Get-Credential
Enter-PSSession -ComputerName "<Computer IP>" -Credential $cred

    Nota

    Entre usando suas credenciais de conta de usuário de implantação. Essa é a conta que você criou ao preparar do Ative Directory e usou para implantar o Azure Local.

    Expanda esta seção para ver um exemplo de saída.

    Aqui está um exemplo de saída:

    PS C:\Users\Administrator> $cred = Get-Credential
 
cmdlet Get-Credential at command pipeline position 1
Supply values for the following parameters:
Credential
PS C:\Users\Administrator> Enter-PSSession -ComputerName "100.100.100.10" -Credential $cred 
[100.100.100.10]: PS C:\Users\Administrator\Documents>

Etapa 1: Confirmar o software e verificar a integridade do sistema

Antes de descobrir as atualizações, verifique se o sistema está executando o Azure Local, versão 23H2, versão de software 2311 ou posterior.

  1. Verifique se você está conectado à máquina usando a conta de usuário de implantação. Execute o seguinte comando:

    whoami

  2. Para garantir que o sistema esteja executando o Azure Local, versão 23H2, execute o seguinte comando em uma das máquinas do seu sistema:

    Get-SolutionUpdateEnvironment
    Expanda esta seção para ver um exemplo de saída. 
    PS C:\Users\lcmuser> Get-SolutionUpdateEnvironment
ResourceId : redmond 
SbeFamily : GenA 
HardwareModel : Contoso680 
LastChecked : 10/2/2024 12:38:21 PM 
PackageVersions : {Solution: 10.2408.0.29, Services: 10.2408.0.29, Platform: 1.0.0.0, SBE: 4.1.2409.1} 
CurrentVersion : 10.2408.0.29 
CurrentSbeVersion : 4.1.2409.1 
LastUpdated : 
State : UpdateAvailable 
HealthState : Success 
HealthCheckResult : {Storage Subsystem Summary, Storage Pool Summary, Storage Services Physical Disks Summary, Storage 
Services Physical Disks Summary...} 
HealthCheckDate : 10/2/2024 10:46:44 AM 
AdditionalData :

  3. Observe o CurrentVersion no seu sistema. A versão atual reflete a versão da solução que o sistema está executando.

  4. Reveja o HealthState no seu sistema e verifique se este está em bom estado. Se o HealthState estiver Failure, Errorou Warning, consulte Solucionar problemas de verificações de preparação antes de prosseguir.

Passo 2: Descubra as atualizações

Siga estes passos para descobrir as atualizações disponíveis para o seu sistema:

  1. Conecte-se a uma máquina em seu Azure Local usando a conta de usuário de implantação.

  2. Revise os detalhes das atualizações que Ready instalar usando o Get-SolutionUpdate.

    Get-SolutionUpdate | Where-Object {$_.State -like "Ready*" -or $_.State -like "Additional*"} | FL DisplayName, Description, ResourceId, State, PackageType
    Expanda esta seção para ver um exemplo de saída.

    Aqui está um exemplo de saída:

    PS C:\Users\lcmuser> Get-SolutionUpdate | Where-Object {$_.State -like "Ready*" -or $_.State -like "Additional*"} | FL DisplayName, Description, ResourceId, State, PackageType

DisplayName           : 2024.10 Cumulative Update
ResourceId            : redmond/Solution10.2408.2.7
Version               : 10.2408.2.7
State                 : Ready
PackageType           : Solution

DisplayName           : SBE_Contoso_GenA_4.1.2410.5
ResourceId            : redmond/SBE4.1.2410.5
Version               : 4.1.2410.5
State                 : AdditionalContentRequired
PackageType           : SBE

    Isso pode listar uma ou mais opções, incluindo entradas para atualizações completas Solution (que também podem incluir uma extensão do Solution Builder) e atualizações SBE autônomas.

    Se não vir uma atualização esperada listada, remova o filtro do comando para ver se está listado em estado non-ready.

    Get-SolutionUpdate | FL DisplayName, Description, ResourceId, State, PackageType

    Para obter mais informações, consulte Sobre as fases de atualização para obter detalhes sobre os estados de atualização.

  3. Selecione a atualização que deseja instalar e anote sua ResourceId. Revise os detalhes da atualização para confirmar que você selecionou a atualização desejada para instalar.

    $Update = Get-SolutionUpdate –Id <ResourceId>
$Update
    Expanda esta seção para ver um exemplo de saída.

    Aqui está um exemplo de saída:

    PS C:\Users\lcmuser> $Update = Get-SolutionUpdate –Id redmond/Solution10.2408.2.7
PS C:\Users\lcmuser> $Update
ResourceId            : redmond/Solution10.2408.2.7
InstalledDate         : 
Description           :
State                 : Ready
KbLink                : https://learn.microsoft.com/en-us/azure-stack/hci/
MinVersionRequired    : 10.2408.0.0
MinSbeVersionRequired : 2.0.0.0
PackagePath           : C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\Updates\Packages\Solution10.2408
                        .2.2
PackageSizeInMb       : 1278
DisplayName           : 2024.10 Cumulative Update
Version               : 10.2408.2.7
SbeVersion            : 4.1.2410.5
Publisher             : Microsoft
ReleaseLink           : https://learn.microsoft.com/en-us/azure-stack/hci/
AvailabilityType      : Online
PackageType           : Solution
Prerequisites         : {}
UpdateStateProperties : The update requires additional content distributed by the OEM.
AdditionalProperties  : {SBEReleaseLink, SBENotifyMessage, SBEFamily, SBEPublisher...}
ComponentVersions     : {Services: 10.2408.2.7, Platform: 10.2408.2.7, SBE: 4.1.2410.5}
RebootRequired        : Unknown
HealthState           : Unknown
HealthCheckResult     : 
HealthCheckDate       : 1/1/0001 12:00:00 AM
BillOfMaterials       : {PlatformUpdate, ServicesUpdate}

    Nota

    É normal que HealthState esteja Unknown para uma atualização que ainda não foi agendada ou preparada.

  4. Opcionalmente, revise as versões dos componentes do pacote de atualização.

    $Update = Get-SolutionUpdate -Id <ResourceID>
$Update.ComponentVersions
    Expanda esta seção para ver um exemplo de saída.

    Aqui está um exemplo de saída:

    PS C:\Users\lcmuser> $Update = Get-SolutionUpdate -Id redmond/Solution10.2408.2.7

PS C:\Users\lcmuser> $Update.ComponentVersions

PackageType Version      LastUpdated
----------- -------      -----------
Services    10.2408.2.7
Platform    10.2408.2.7
SBE         4.1.2410.5

PS C:\Users\lcmuser>

Agora você pode prosseguir para Baixar e instalar as atualizações.

Etapa 3: Importar e redescobrir atualizações

A importação de atualizações pode ser necessária em um dos seguintes cenários:

  • A atualização que você deseja instalar relata um estado AdditionalContentRequired. Algum conteúdo extra pode ser necessário antes que você possa agendar a atualização no estado AdditionalContentRequired. Para obter detalhes sobre esse estado e sobre atualizações de extensão de solução, consulte atualizações de extensão de solução no Azure Local, versão 23H2.

  • A atualização que você deseja instalar não está listada porque o Suporte está fornecendo uma versão privada para resolver um problema que você está enfrentando.

  • A atualização está listada como Ready, mas como seu sistema tem conectividade de rede limitada, você deseja evitar a fase de download online da atualização da extensão da solução.

Siga estas etapas para importar e descobrir as atualizações da solução.

  1. Conecte-se a uma máquina em seu Azure Local usando a conta de usuário de implantação.

  2. Vá para o compartilhamento de rede e adquira o pacote de atualização que você usa. Verifique se o pacote de atualização importado contém os seguintes arquivos:

    • SolutionUpdate.xml
    • SolutionUpdate.zip
    • AS_Update_10.2408.2.7.zip

    Se uma extensão do construtor de soluções fizer parte do pacote de atualização, você também verá os seguintes arquivos:

    • SBE_Contoso_GenA_4.1.2410.5.xml
    • SBE_Contoso_GenA_4.1.2410.5.zip
    • SBE_Discovery_Contoso.xml

  3. Baixe os arquivos que você pretende importar para um local que sua instância Local do Azure possa acessar. Se estiver importando uma extensão de solução, você sempre baixará três arquivos que correspondem ao seguinte padrão de nomenclatura:

    Padrão de nome de arquivo Exemplo Descrição
    SBE_Discovery_<Fabricante>.xml SBE_Discovery_Contoso.xml Um manifesto de descoberta de extensão de solução que possibilita a descoberta de atualizações.
    SBE_<Fabricante>_<Família>_<Versão>.xml SBE_Contoso_GenA_4.1.2410.5.xml Um arquivo com inventário de extensão de solução e lista de materiais de software assinada
    SBE_<Fabricante>_<Família>_<Versão>.zip SBE_Contoso_GenA_4.1.2410.5.zip Um ficheiro com carga útil referente a uma extensão de solução

  4. Crie uma pasta para descoberta pelo serviço de atualização no seguinte local no volume de infraestrutura do seu sistema.

    New-Item C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\import -ItemType Directory

  5. Copie os arquivos de atualização para a pasta criada na etapa anterior.

  6. Descubra manualmente o pacote de atualização usando o serviço de atualização. Execute o seguinte comando:

    Add-SolutionUpdate -SourceFolder C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\import

  7. Verifique se o serviço de atualização descobre o pacote de atualização e se ele está disponível para iniciar a preparação e a instalação. Repita o comando Get-SolutionUpdate para redescobrir as atualizações.

Você pode baixar a atualização e executar um conjunto de verificações para verificar a prontidão da atualização do cluster sem iniciar a instalação.

  1. Para baixar as atualizações sem iniciar a instalação, execute o seguinte comando:

    Get-SolutionUpdate -Id <ResourceId> | Start-SolutionUpdate –PrepareOnly
    Expanda esta seção para ver um exemplo de saída.

    Aqui está um exemplo de saída:

    PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 | Start-SolutionUpdate –PrepareOnly
redmond/SBE4.1.2410.9/<GUID>

  2. Para acompanhar o progresso da atualização, monitore o estado da atualização. Execute o seguinte comando:

    Get-SolutionUpdate -Id <ResourceId> | ft Version,State,UpdateStateProperties,HealthState

    Quando a atualização é iniciada, as seguintes ações ocorrem:

    • O download das atualizações começa. Dependendo do tamanho do pacote de download e da largura de banda da rede, o download pode levar vários minutos.
    Expanda esta seção para ver um exemplo de saída.

    Aqui está um exemplo de saída quando as atualizações estão sendo baixadas:

    PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 | ft Version,State,HealthState

Version              State          HealthState
-------              -----          ---------------------
10.2408.2.7          Downloading    InProgress

  3. Depois que o pacote é baixado, verificações de prontidão são realizadas para avaliar a prontidão de atualização do seu sistema. Para obter mais informações sobre as verificações de preparação, consulte Fases de atualização. Durante esta fase, o Estado da atualização é apresentado como HealthChecking.

    Expanda esta seção para ver um exemplo de saída. 
    PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

Version         State             HealthState
-------         -----             --------------------- 
10.2408.2.7     HealthChecking    InProgress

  4. Quando as verificações de prontidão são feitas, o sistema está pronto para instalar atualizações. O State da atualização é exibido como ReadyToInstall. Se a State da atualização for exibida como HealthCheckFailed, consulte Solucionar problemas de verificações de prontidão antes de prosseguir.

Etapa 5: Iniciar a atualização

Durante a instalação, as máquinas do sistema podem reinicializar e talvez seja necessário estabelecer a sessão remota do PowerShell novamente para monitorar as atualizações. Se estiver atualizando uma única máquina, seu Azure Local enfrentará um tempo de inatividade.

Inicie uma atualização selecionando uma única atualização e passando-a para Start-SolutionUpdate.

$InstanceId = Get-SolutionUpdate -Id <ResourceId>  | Start-SolutionUpdate

Nota

Se a etapa 3 foi ignorada (e você não fez uma chamada semelhante para Start-SolutionUpdate -PrepareOnly), ao chamar Start-SolutionUpdate, este primeiro irá baixar as atualizações e executar um conjunto de verificações para verificar a preparação do cluster para a atualização, antes de iniciar a instalação da atualização.

Expanda esta seção para ver um exemplo de saída. 
PS C:\Users\lcmuser> $InstanceId = Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 | Start-SolutionUpdate

Isso inicia o processo para instalar a atualização.

Dica

Guarde o $InstanceId pois poderá usá-lo mais tarde para resolver problemas com atualizações de solução para o Azure Local.

Etapa 6: Acompanhar o progresso da atualização

A Microsoft recomenda acompanhar o progresso da atualização do cluster no portal do Azure após o início da atualização. O portal é uma ótima opção para acompanhar o progresso da atualização, mesmo quando a atualização é iniciada via PowerShell, pois não está sujeita a interrupções no relatório de status.

Dica

  • Se estiver monitorando via PowerShell, recomendamos que você conecte sua sessão do PowerShell ao último servidor do cluster para evitar que a sessão seja desconectada mais cedo. As sessões são interrompidas à medida que os sistemas são reinicializados, então alterar o foco de monitorização para um servidor já atualizado pode minimizar a frequência dessas interrupções.
  • Recomendamos que você acompanhe o progresso da atualização do cluster no portal do Azure para evitar ter que se reconectar às sessões do PowerShell após uma reinicialização da máquina.

Siga estas etapas para acompanhar o progresso da atualização usando o PowerShell.

  1. Para acompanhar o progresso da atualização, monitore o estado da atualização. Execute o seguinte comando:

    Get-SolutionUpdate -Id <ResourceId> | ft Version,State,UpdateStateProperties,HealthState

    A atualização progride por meio de vários estados, conforme descrito nas fases de revisão da atualização .

    Usando o comando acima, os exemplos a seguir mostram como monitorar a atualização à medida que ela progride nessas fases usando as propriedades State e UpdateStateProperties.

    • Download do estado

      Logo após Start-SolutionUpdate é chamado, o download das atualizações começa. Dependendo do tamanho do pacote de download e da largura de banda da rede, o download pode levar vários minutos.

      Expanda esta seção para ver um exemplo de saída.

      Aqui está um exemplo de saída quando as atualizações estão sendo baixadas:

      PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 |ft Version,State,UpdateStateProperties,HealthState

Version              State         HealthState
-------              -----         ------------
10.2408.2.7          Downloading   Unknown

    • Estado de Preparação

      Uma vez que as atualizações são baixadas, as atualizações precisam ser preparadas. No estado de preparação, os hashes dos ficheiros de atualização são confirmados e os ficheiros são extraídos para preparar e organizar os ficheiros de atualização.

      Expanda esta seção para ver um exemplo de saída.

      Aqui está um exemplo de saída quando as atualizações estão sendo baixadas:

      PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 |ft Version,State,HealthState

Version              State       HealthState
-------              -----       -----------
10.2408.2.7          Preparing   Unknown

    • Estado de Verificação de Saúde

      Depois que as atualizações são preparadas, as verificações de prontidão são realizadas para avaliar a prontidão para atualização do cluster. Para obter mais informações sobre as verificações de preparação, consulte Fases de atualização.

      Durante esta fase, o Estado da atualização é apresentado como HealthChecking. Se o State da atualização aparece como HealthCheckFailed, consulte Solucionar problemas de verificações de prontidão antes de prosseguir.

      Expanda esta seção para ver um exemplo de saída.

      Aqui está um exemplo de saída quando as atualizações estão em processo HealthChecking:

      PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 |ft Version,State,HealthState

Version              State           HealthState
-------              -----           -----------
10.2408.2.7          HealthChecking  Unknown

    • Estado de instalação Quando o sistema estiver pronto, a atualização transita para o estado de instalação. Durante esta fase, o Estado das atualizações é mostrado como Instalando e o UpdateStateProperties mostra a porcentagem da instalação que foi concluída.

      Expanda esta seção para ver um exemplo de saída.

      Aqui está um exemplo de saída quando as atualizações estão passando por Installing:

      PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 |ft Version,State,HealthState

Version              State       HealthState
-------              -----       -----------
10.2408.2.7          Installing   Unknown

Quando a instalação estiver concluída, o Estado mudará para Installed. Para obter mais informações sobre os vários estados das atualizações, consulte Progresso e monitoramento da instalação.

Etapa 7: Retomar a atualização (se necessário)

Para retomar uma atualização com falha anterior executada via PowerShell, use o seguinte comando:

Get-SolutionUpdate -Id <ResourceId>  | Start-SolutionUpdate

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

Get-SolutionUpdate -Id <ResourceId>  | Start-SolutionUpdate -IgnoreWarnings

Para solucionar outros problemas de execução de atualização, consulte Solucionar problemas de atualizações.

Etapa 8: Verificar a instalação

Depois que as atualizações forem instaladas, verifique a versão da solução do ambiente e a versão do sistema operacional.

  1. Depois que a atualização estiver no Installed estado, verifique a versão da solução de ambiente. Execute o seguinte comando:

    Get-SolutionUpdateEnvironment | ft State, CurrentVersion
    Expanda esta seção para ver um exemplo de saída. 
    PS C:\Users\lcmuser> Get-SolutionUpdateEnvironment | ft State, CurrentVersion

State               CurrentVersion
-----               --------------
AppliedSuccessfully 10.2408.2.7

  2. Verifique a versão do sistema operacional para confirmar que corresponde à receita que você instalou. Execute o seguinte comando:

    cmd /c ver
    Expanda esta seção para ver um exemplo de saída.

    Aqui está um exemplo de saída:

    PS C:\Users\lcmuser> cmd /c ver

Microsoft Windows [Version 10.0.25398.1189]
PS C:\Users\lcmuser>

Próximo passo