Compartilhar via

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

  • Artigo

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

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

O procedimento neste artigo se aplica a um único servidor e a um cluster de vários servidores que está executando a versão mais recente com o orquestrador (Lifecycle Manager) instalado. Se o cluster foi criado por meio de uma nova implantação do Azure Stack HCI, 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 Stack HCI, 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 Stack HCI, versão 22H2.

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

Sobre atualizações de solução

As atualizações da solução Azure Stack HCI 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 Stack HCI, 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 cluster.
  3. Conecte-se ao cluster do Azure Stack HCI por meio do PowerShell remoto.
  4. Descubra as atualizações disponíveis e filtre as que você pode aplicar ao cluster.
  5. Baixe as atualizações, avalie a prontidão de atualização do cluster e, quando estiver pronto, instale as atualizações no cluster. 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 cluster.
  • Número de servidores no cluster.
  • Tipo de hardware usado.
  • Extensão do Construtor de Soluções usada.

As estimativas de tempo aproximadas para um único servidor típico e um cluster de 4 servidores estão resumidas na tabela a seguir:

Cluster/Tempo Hora da verificação de integridade
hh:mm:ss		 Hora de instalar a atualização
hh:mm:ss
Servidor único 0:01:44 1:25:42
Cluster de 4 servidores 0:01:58 3:53:09

Pré-requisitos

Antes de começar, verifique se:

  • Você tem acesso a um cluster do Azure Stack HCI, versão 23H2 que está executando o 2310 ou superior. O cluster deve ser registrado no Azure.
  • Você tem acesso a um cliente que pode se conectar ao cluster do Azure Stack HCI. 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ê faz sideload ou copia essas atualizações para os servidores do cluster.

Conectar-se ao cluster do Azure Stack HCI

Siga estas etapas em seu cliente para se conectar a um dos servidores do cluster do Azure Stack HCI.

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

  2. Abra uma sessão remota do PowerShell em um servidor no cluster do Azure Stack HCI. Execute o seguinte comando e forneça as credenciais do seu servidor 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 sistema Azure Stack HCI.

    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 no cluster

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

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

    whoami

  2. Para garantir que o cluster foi implantado executando o Azure Stack HCI, versão 23H2, execute o seguinte comando em um dos servidores do cluster:

    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 cluster. A versão do carimbo reflete a versão da solução que o cluster está executando.

Etapa 2: descubra as atualizações

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

  • Descobrir atualizações online – a opção recomendada quando o cluster 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 cluster do Azure Stack HCI 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 servidor no cluster do Azure Stack HCI 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 servidor no cluster do Azure Stack HCI 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 infraestrutura do cluster.

    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 preparação para atualizações do cluster 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 preparação para atualização do cluster. 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 servidores de cluster 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 servidor, o Azure Stack HCI 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 clusters do Azure Stack HCI, versão 22H2 quando o orquestrador não está instalado.