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

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

Importante

O procedimento descrito aqui aplica-se 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 o Azure Stack HCI, versão 22H2.

Este artigo descreve como usar Gerenciador de Atualizações do Azure para localizar e instalar atualizações de cluster disponíveis em clusters do Azure Stack HCI selecionados. Além disso, fornecemos diretrizes sobre como examinar atualizações de cluster, acompanhar o progresso e procurar o histórico de atualizações de cluster.

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

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 do 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 as atualizações do Azure Stack HCI, versão 23H2.

Ao aplicar uma atualização de solução, aqui estão as etapas de alto nível que você executar:

  1. Verifique se 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. Use o Verificador de Ambiente para verificar se o cluster está em boa integridade.
  5. Descubra as atualizações disponíveis e filtre as que você pode aplicar ao cluster.
  6. Baixe as atualizações, avalie a preparação de atualização do cluster e, depois de pronto, instale as atualizações no cluster. Acompanhe o progresso das atualizações. Se necessário, você também pode monitorar o progresso detalhado.
  7. Verifique a versão das atualizações instaladas.

O tempo necessário para instalar as atualizações pode variar de acordo com os seguintes fatores:

  • Conteúdo da atualização.
  • Carregue em seu cluster.
  • Número de servidores no cluster.
  • Tipo do hardware usado.
  • Extensão do Construtor de Soluções usada.

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

Cluster/Hora Tempo para marcar 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 para um servidor no cluster do Azure Stack HCI. Execute o seguinte comando e forneça as credenciais do 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 usada 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 selo 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 no cluster. A versão do selo reflete a versão da solução em que o cluster está em execução.

Etapa 2: opcionalmente validar a integridade do sistema

Antes de descobrir as atualizações, você pode validar manualmente a integridade do sistema. Essa etapa é opcional, pois o orquestrador sempre avalia a preparação da atualização antes da aplicação de atualizações.

Observação

Quaisquer falhas que tenham uma gravidade crítica impedirão que as atualizações sejam aplicadas.

  1. Conecte-se a um servidor no cluster do Azure Stack HCI usando a conta de usuário de implantação.

  2. Execute o comando a seguir para validar a integridade do sistema por meio do Verificador de Ambiente.

    $result = Test-EnvironmentReadiness
    $result | ft Name,Status,Severity  
    

    Aqui está um exemplo de saída:

    PS C:\Users\lcmuser> whoami
    rq2205\lcmuser                                                                                               
    PS C:\Users\lcmuser> $result=Test-EnvironmentReadiness                                                         
    VERBOSE: Looking up shared vhd product drive letter.                                                                    
    WARNING: Unable to find volume with label Deployment                                                                    
    VERBOSE: Get-Package returned with Success:True                                                                        
    VERBOSE: Found package Microsoft.AzureStack.Solution.Deploy.EnterpriseCloudEngine.Client.Deployment with version  10.2303.0.31 at                                                                                                         C:\NugetStore\Microsoft.AzureStack.Solution.Deploy.EnterpriseCloudEngine.Client.Deployment.10.2303.0.31\Microsoft.Azure Stack.Solution.Deploy.EnterpriseCloudEngine.Client.Deployment.nuspec.                                                   
    03/29/2023 15:45:58 : Launching StoragePools                                                                            
    03/29/2023 15:45:58 : Launching StoragePhysicalDisks                                                                    
    03/29/2023 15:45:58 : Launching StorageMapping                                                                          
    03/29/2023 15:45:58 : Launching StorageSubSystems                                                                       
    03/29/2023 15:45:58 : Launching TestCauSetup                                                                            
    03/29/2023 15:45:58 : Launching StorageVolumes                                                                          
    03/29/2023 15:45:58 : Launching StorageVirtualDisks                                                                     
    03/29/2023 15:46:05 : Launching OneNodeEnvironment                                                                      
    03/29/2023 15:46:05 : Launching NonMigratableWorkload                                                                   
    03/29/2023 15:46:05 : Launching FaultSummary                                                                            
    03/29/2023 15:46:06 : Launching SBEHealthStatusOnNode                                                                   
    03/29/2023 15:46:06 : Launching StorageJobStatus                                                                        
    03/29/2023 15:46:07 : Launching StorageCsv
    WARNING: There aren't any faults right now.
    03/29/2023 15:46:09 : Launching SBEPrecheckStatus
    WARNING: rq2205-cl: There aren't any faults right now.
    VERBOSE: Looking up shared vhd product drive letter.
    WARNING: Unable to find volume with label Deployment
    VERBOSE: Get-Package returned with Success:True
    VERBOSE: Found package Microsoft.AzureStack.Role.SBE with version 4.0.2303.66 at
    C:\NugetStore\Microsoft.AzureStack.Role.SBE.4.0.2303.66\Microsoft.AzureStack.Role.SBE.nuspec.
    VERBOSE: SolutionExtension module supports Tag 'HealthServiceIntegration'.
    VERBOSE: SolutionExtension module SolutionExtension at
    C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\CloudMedia\SBE\Installed\Content\Configuration\SolutionExtension is valid.
    VERBOSE: Looking up shared vhd product drive letter.
    WARNING: Unable to find volume with label Deployment
    VERBOSE: Get-Package returned with Success:True
    VERBOSE: Found package Microsoft.AzureStack.Role.SBE with version 4.0.2303.66 at
    C:\NugetStore\Microsoft.AzureStack.Role.SBE.4.0.2303.66\Microsoft.AzureStack.Role.SBE.nuspec.
    VERBOSE: SolutionExtension module supports Tag 'HealthServiceIntegration'.
    VERBOSE: SolutionExtension module SolutionExtension at
    C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\CloudMedia\SBE\Installed\Content\Configuration\SolutionExtension is valid.
    PS C:\Users\lcmuser> $result|ft Name,Status,Severity
    
    Name                                    Status  Severity
    ----                                    ------  --------
    Storage Pool Summary                    SUCCESS CRITICAL
    Storage Services Physical Disks Summary SUCCESS CRITICAL
    Storage Services Physical Disks Summary SUCCESS CRITICAL
    Storage Services Physical Disks Summary SUCCESS CRITICAL
    Storage Services Physical Disks Summary SUCCESS CRITICAL
    Storage Services Physical Disks Summary SUCCESS CRITICAL
    Storage Services Physical Disks Summary SUCCESS CRITICAL
    Storage Services Physical Disks Summary SUCCESS CRITICAL
    Storage Services Physical Disks Summary SUCCESS CRITICAL
    Storage Services Physical Disks Summary SUCCESS CRITICAL
    Storage Services Physical Disks Summary SUCCESS CRITICAL
    Storage Services Physical Disks Summary SUCCESS CRITICAL
    Storage Services Physical Disks Summary SUCCESS CRITICAL
    Storage Services Physical Disks Summary SUCCESS CRITICAL
    Storage Services Physical Disks Summary SUCCESS CRITICAL
    Storage Services Physical Disks Summary SUCCESS CRITICAL
    Storage Services Physical Disks Summary SUCCESS CRITICAL
    Storage Services Physical Disks Summary SUCCESS CRITICAL
    Storage Services Physical Disks Summary SUCCESS CRITICAL
    Storage Services Physical Disks Summary SUCCESS CRITICAL
    Storage Services Physical Disks Summary SUCCESS CRITICAL
    Storage Services Summary                SUCCESS CRITICAL
    Storage Services Summary                SUCCESS CRITICAL
    Storage Services Summary                SUCCESS CRITICAL
    Storage Subsystem Summary               SUCCESS CRITICAL
    Test-CauSetup                           SUCCESS INFORMATIONAL
    Test-CauSetup                           SUCCESS INFORMATIONAL
    Test-CauSetup                           SUCCESS INFORMATIONAL
    Test-CauSetup                           SUCCESS INFORMATIONAL
    Test-CauSetup                           SUCCESS CRITICAL
    Test-CauSetup                           SUCCESS INFORMATIONAL
    Test-CauSetup                           SUCCESS INFORMATIONAL
    Test-CauSetup                           SUCCESS INFORMATIONAL
    Test-CauSetup                           FAILURE INFORMATIONAL
    Test-CauSetup                           FAILURE INFORMATIONAL
    Test-CauSetup                           FAILURE INFORMATIONAL
    Storage Volume Summary                  SUCCESS CRITICAL
    Storage Volume Summary                  SUCCESS CRITICAL
    Storage Volume Summary                  SUCCESS CRITICAL
    Storage Volume Summary                  SUCCESS CRITICAL
    Storage Virtual Disk Summary            SUCCESS CRITICAL
    Storage Virtual Disk Summary            SUCCESS CRITICAL
    Storage Virtual Disk Summary            SUCCESS CRITICAL
    Storage Virtual Disk Summary            SUCCESS CRITICAL
    Get-OneNodeRebootRequired               SUCCESS WARNING
    Test-NonMigratableVMs                   SUCCESS WARNING
    Faults                                  SUCCESS INFORMATIONAL
    Test-SBEHealthStatusOnNode              Success Informational
    Test-SBEHealthStatusOnNode              Success Informational
    Storage Job Summary                     SUCCESS CRITICAL
    Storage Cluster Shared Volume Summary   SUCCESS CRITICAL
    Storage Cluster Shared Volume Summary   SUCCESS CRITICAL
    Storage Cluster Shared Volume Summary   SUCCESS CRITICAL
    Test-SBEPrecheckStatus                  Success Informational  
    
    PS C:\Users\lcmuser>
    

    Observação

    Nesta versão, as falhas informativas para Test-CauSetup são esperadas e não afetarão as atualizações.

  3. Examine as falhas e resolve-as antes de prosseguir para a etapa de descoberta.

Etapa 3: Descobrir 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 tiver 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. Nessas instâncias, 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, examine as versões dos componentes do pacote de atualização.

    $Update = Get-SolutionUpdate 
    $Update.ComponentVersions
    

    Veja um exemplo de saída:

     PS C:\Users\lcmuser> $Update = Get-SolutionUpdate 
     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.

Fazer sideload e descobrir atualizações de solução

Se você estiver usando atualizações de extensão de solução do hardware, precisará fazer 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 local a seguir 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
    -----------                 -------      -----
    Azure Stack HCI 2303 bundle 10.2303.0.31 Ready
    
     PS C:\Users\lcmuser>
    
  7. Opcionalmente, marcar a versão dos componentes do pacote de atualização. Execute o comando a seguir:

    $Update = Get-SolutionUpdate 
    $Update.ComponentVersions 
    

    Veja um exemplo de saída:

     PS C:\Users\lcmuser> $Update = Get-SolutionUpdate 
     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 4: Baixar, marcar preparação e instalar atualizações

Você pode baixar as atualizações, executar um conjunto de verificações para verificar a preparação de atualização 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 | 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 de atualização. Execute o comando a seguir:

    Get-SolutionUpdate | 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.

      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 da 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 é mostrado 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 é exibido como Installing e UpdateStateProperties mostra o percentual 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
      

Depois que a instalação for concluída, o Estado será alterado para Installed. Para obter mais informações sobre os vários estados das atualizações, consulte Progresso e monitoramento da instalação.

Etapa 5: 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, marcar a versão da solução de ambiente. Execute o seguinte comando:

    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 seguinte comando:

    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 | 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 | start-solutionUpdate -IgnoreWarnings

Para solucionar outros problemas de execução de atualização, confira 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 estiver instalado.