Compartilhar via

Atualizar o Azure Local, versão 23H2 por meio do PowerShell

  • Artigo

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

Este artigo descreve como aplicar uma atualização de solução ao Azure Local por meio do PowerShell.

O procedimento neste artigo se aplica 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 sistema tiver sido 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 Azure Local, versão 22H2.

Para obter informações sobre como aplicar atualizações de solução a sistemas criados com versões mais antigas do Azure Local que não tinham o orquestrador instalado, consulte Atualizar o Azure Local, versão 22H2.

Sobre atualizações de 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 foram concluídos.
  2. Identifique a versão do software em execução no sistema.
  3. Conecte-se à sua instância local do Azure por meio do PowerShell remoto.
  4. Descubra as atualizações disponíveis e filtre as que você pode aplicar ao seu sistema.
  5. Baixe as atualizações, avalie a prontidão de atualização do seu sistema e, quando estiver pronto, instale as atualizações em seu sistema. Acompanhe o progresso das atualizações. Se necessário, você também pode monitorar o progresso detalhado.
  6. Verifique a versão das atualizações instaladas.

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

  • Conteúdo da atualização.
  • Carregue em seu sistema.
  • Número de máquinas em seu sistema.
  • Tipo de hardware usado.
  • Extensão do Construtor de Soluções usada.

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

Sistema/Hora Hora da verificação de integridade
hh:mm:ss		 Hora de 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, verifique se:

  • Você tem acesso a um sistema Azure Local, versão 23H2 que está executando 2310 ou superior. O sistema deve ser registrado no Azure.
  • Você tem acesso a um cliente que pode se conectar ao seu Azure Local. Esse cliente deve estar executando o PowerShell 5.0 ou posterior.
  • Você tem acesso ao pacote de atualização da solução pela rede. Você carrega ou copia essas atualizações para as máquinas em seu sistema.

Conectar-se ao Azure Local

Siga estas etapas em seu cliente para se conectar a um dos computadores em seu Azure Local.

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

  2. Abra uma sessão remota do PowerShell em um computador em seu Azure Local. Execute o seguinte comando e forneça as credenciais do seu computador quando solicitado:

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

    Observação

    Você deve entrar usando suas credenciais de conta de usuário de implantação: que é a conta que você criou ao preparar o Active Directory e usou durante a implantação do Azure Local.

    Veja 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: Identificar a versão do carimbo em seu sistema

Antes de descobrir as atualizações, verifique se o sistema foi implantado usando o Azure Local, versão 23H2, software versão 2310.

  1. Verifique se você está conectado ao computador usando a conta de usuário de implantação. Execute o comando a seguir:

    whoami

  2. Para garantir que o sistema foi implantado executando o Azure Local, versão 23H2, execute o seguinte comando em um dos computadores do sistema:

    Get-StampInformation

    Aqui está um exemplo de saída:

    PS C:\Users\lcmuser> Get-StampInformation
Deployment ID             : b4457f25-6681-4e0e-b197-a7a433d621d6
OemVersion                : 2.1.0.0
PackageHash               :
StampVersion              : 10.2303.0.31
InitialDeployedVersion    : 10.2303.0.26
PS C:\Users\lcmuser>

  3. Anote o StampVersion em seu sistema. A versão do carimbo reflete a versão da solução que seu sistema está executando.

Etapa 2: descubra as atualizações

Você pode descobrir atualizações de uma das duas maneiras a seguir:

  • Descubra atualizações online - A opção recomendada quando seu sistema tem boa conectividade com a Internet. As atualizações da solução são descobertas por meio do catálogo de atualizações online.
  • Sideload e descoberta de atualizações – uma alternativa para descobrir atualizações online e deve ser usada para cenários com conectividade de Internet não confiável ou lenta ou ao usar atualizações de extensão de solução fornecidas pelo fornecedor de hardware. Nesses casos, você baixa as atualizações da solução para um local central. Em seguida, você carrega as atualizações em um Azure Local e descobre as atualizações localmente.

Descobrir atualizações de solução usando o catálogo online é o método recomendado . Siga estas etapas para descobrir atualizações de solução online:

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

  2. Verifique se o serviço de atualização descobre o pacote de atualização.

    Get-SolutionUpdate | ft DisplayName, State

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

    $Update = Get-SolutionUpdate | ? Version -eq "10.2302.0.31"
$Update.ComponentVersions

    Veja um exemplo de saída:

     PS C:\Users\lcmuser> $Update = Get-SolutionUpdate | ? Version -eq "10.2302.0.31"
 PS C:\Users\lcmuser> $Update.ComponentVersions

PackageType Version      LastUpdated
----------- -------      -----------
Services    10.2303.0.31
Platform    10.2303.0.31
SBE         4.1.2.3
 PS C:\Users\lcmuser>

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

Sideload e descubra atualizações de solução

Se você estiver usando atualizações de extensão de solução do seu hardware, precisará fazer o sideload dessas atualizações. Siga estas etapas para fazer sideload e descobrir as atualizações da solução.

  1. Conecte-se a um computador 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 que você carrega contém os seguintes arquivos:

    • SolutionUpdate.xml
    • SolutionUpdate.zip
    • AS_Update_10.2303.4.1.zip

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

    • SBE_Content_4.1.2.3.xml
    • SBE_Content_4.1.2.3.zip
    • SBE_Discovery_Contoso.xml

  3. Crie uma pasta para descoberta pelo serviço de atualização no seguinte local no volume de infra-estrutura do sistema.

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

  4. Copie o pacote de atualização para a pasta que você criou na etapa anterior.

  5. Descubra manualmente o pacote de atualização usando o serviço de atualização. Execute o comando a seguir:

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

  6. 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.

    Get-SolutionUpdate | ft DisplayName, Version, State

    Veja um exemplo de saída:

     PS C:\Users\lcmuser> Get-SolutionUpdate | ft DisplayName, Version, State

DisplayName                 Version      State
-----------                 -------      -----
2023.03 Feature Update 10.2303.0.31 Ready

 PS C:\Users\lcmuser>

  7. Opcionalmente, verifique a versão dos componentes do pacote de atualização. Execute o comando a seguir:

    $Update = Get-SolutionUpdate | ? Version -eq "10.2302.0.31"
$Update.ComponentVersions

    Veja um exemplo de saída:

     PS C:\Users\lcmuser> $Update = Get-SolutionUpdate | ? Version -eq "10.2302.0.31"
 PS C:\Users\lcmuser> $Update.ComponentVersions

PackageType Version      LastUpdated
----------- -------      -----------
Services    10.2303.0.31
Platform    10.2303.0.31
SBE         4.1.2.3
 PS C:\Users\lcmuser>

Etapa 3: Baixe, verifique a prontidão e instale as atualizações

Você pode baixar as atualizações, executar um conjunto de verificações para verificar a prontidão de atualização do seu sistema e começar a instalar as atualizações.

  1. Você só pode baixar a atualização sem iniciar a instalação ou baixar e instalar a atualização.

    • Para baixar e instalar a atualização, execute o seguinte comando:

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

    • Para baixar apenas as atualizações sem iniciar a instalação, use o -PrepareOnly sinalizador com Start-SolutionUpdate.

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

    Get-SolutionUpdate | ft Version,State,UpdateStateProperties,HealthState

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

    • 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.

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

        PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

Version              State UpdateStateProperties HealthState
-------              ----- --------------------- -----------
10.2303.4.1 Downloading                        InProgress

    • Depois que o pacote é baixado, as verificações de preparação são executadas 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 essa fase, o estado da atualização é exibido como HealthChecking.

      PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

Version              State UpdateStateProperties HealthState
-------              ----- --------------------- -----------
10.2303.4.1 HealthChecking                        InProgress

    • Quando o sistema estiver pronto, as atualizações serão instaladas. Durante essa fase, o Estado das atualizações é mostrado como Installing e UpdateStateProperties mostra a porcentagem da instalação que foi concluída.

      Importante

      Durante a instalação, os computadores podem ser reinicializados e talvez seja necessário estabelecer a sessão remota do PowerShell novamente para monitorar as atualizações. Se estiver atualizando um único computador, o Local do Azure terá um tempo de inatividade.

      Aqui está um exemplo de saída enquanto as atualizações estão sendo instaladas.

      PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

Version          State UpdateStateProperties HealthState
-------          ----- --------------------- -----------
10.2303.4.1 Installing 6% complete.              Success


PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

Version          State UpdateStateProperties HealthState
-------          ----- --------------------- -----------
10.2303.4.1 Installing 25% complete.             Success

PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

Version          State UpdateStateProperties HealthState
-------          ----- --------------------- -----------
10.2303.4.1 Installing 40% complete.             Success

PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

Version          State UpdateStateProperties HealthState
-------          ----- --------------------- -----------
10.2303.4.1 Installing 89% complete.             Success

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 4: 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 comando a seguir:

    Get-SolutionUpdateEnvironment | ft State, CurrentVersion

    Aqui está um exemplo de saída:

    PS C:\Users\lcmuser> Get-SolutionUpdateEnvironment | ft State, CurrentVersion

State               CurrentVersion
-----               --------------
AppliedSuccessfully 10.2303.0.31

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

    cmd /c ver

    Aqui está um exemplo de saída:

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

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

Solucionar problemas de atualizações

Para retomar uma execução de atualização com falha anterior por meio do PowerShell, 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

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

Próxima etapa

Saiba mais sobre como atualizar o Azure Local, versão 22H2 quando o orquestrador não está instalado.