Configurando Novas Origens de Software para Upgrade do Private Cloud Appliance

Essa tarefa de preparação instala a versão mais recente do Upgrader, descompacta a nova versão do software Private Cloud Appliance e gera o plano de upgrade.

O código do Upgrader é alterado regularmente, como é o caso de qualquer outro serviço do sistema. A fase de configuração da preparação de upgrade garante que o Upgrader esteja atualizado primeiro, para que todos os comandos de upgrade sejam executados com a versão mais recente. As operações de upgrade não poderão ser executadas se o sistema detectar que o Upgrader não é a versão mais recente disponível.

Quando a versão mais recente do Upgrader estiver ativa e em execução, as origens do novo software do appliance serão configuradas para uso nos procedimentos de upgrade do sistema. O backup da imagem de software atual é feito e OS novos ISOs de software são descompactados no armazenamento compartilhado do cluster de gerenciamento na estrutura de diretórios apropriada: imagem base do sistema operacional, pacotes RPM de software do appliance, novas imagens de instância de computação, novo firmware e assim por diante.

No final da fase de configuração, um plano de atualização é gerado. O plano de atualização é baseado em uma comparação entre a instalação atual e a nova versão que foi descompactada. Ele determina quais procedimentos de atualização precisam ser executados na próxima fase. Para obter mais informações, consulte Verificando o Status e o Andamento do Plano de Upgrade do Private Cloud Appliance.

Todo esse processo de configuração é iniciado por um administrador de appliance com um único comando.

Cuidado

Verifique se o processo de pré-configuração foi concluído primeiro. Consulte Pré-configurando o Ambiente de Upgrade do Private Cloud Appliance.

Para evitar inconsistências ao executar o plano de upgrade posteriormente, é essencial que ambos os comandos no processo de preparação, upgradePreConfig (pré-configuração) e preUpgrade (configuração), sejam concluídos juntos na ordem especificada. Se, a qualquer momento, você precisar executar novamente o comando preUpgrade, deverá executar novamente o comando anterior primeiro.

Usando a UI da Web de Serviço
  1. No menu de navegação, vá para a seção Manutenção e clique em Fazer Upgrade do Plano. Fornece uma visão geral das versões atuais e de componentes de destino.

  2. Clique em Fazer Upgrade e Aplicar Patch para exibir a página Jobs de Upgrade.

  3. No canto superior direito da página Jobs de Upgrade, clique em Criar Upgrade ou Patch.

    A janela Criar Solicitação é exibida. Escolha Fazer Upgrade como o Tipo de Solicitação.

  4. Selecione o tipo de solicitação de upgrade apropriado: preUpgrade.

  5. Para o tipo de solicitação de upgrade, informe ISO. Os arquivos necessários são recuperados das imagens ISO descompactadas.

  6. Clique em Criar Solicitação.

    A nova solicitação de upgrade aparece na tabela Jobs de Upgrade. Quando o job for concluído com sucesso, o Upgrader estará atualizado e as novas origens de versão do software estarão prontas para uso.

Usando a CLI do Serviço
  1. Inicie a instalação da versão mais recente do Upgrader e a configuração das novas origens de software do appliance.

    PCA-ADMIN> preUpgrade type=ISO
    Status: Running
    JobId: aa33246e-fd79-460f-a191-cc97f8be04be
    Data: in progress

    Operações de upgrade executadas com este comando:

    1. Instale a nova versão do Upgrader nos nós de gerenciamento e reinicie o serviço systemd do Upgrader para que as alterações entrem em vigor.

    2. Atualize a CLI do Serviço e a UI da Web do Serviço para disponibilizar os comandos e funções mais recentes.

    Operações de configuração executadas com este comando:

    1. Faça backup da imagem de software atual.

    2. Descompacte as imagens ISO, armazene novos RPMs de software e arquivos de instalação (imagens, firmware) nos diretórios corretos.

    3. Remova backups e imagens obsoletos do armazenamento compartilhado interno do appliance.

    4. Gerar o plano de atualização.

  2. Verifique o status do processo preUpgrade a qualquer momento usando este comando:

    PCA-ADMIN> getPreUpgradeStatus
    Data: 
      status = IN-PROGRESS
      message =  PREUPGRADE-c0f0b38d-64d2-42bb-8d96-de39d1218b24: A pre-upgrade task is running!
    
    PCA-ADMIN> getPreUpgradeStatus
    Data:
      status = SUCCESS
      message =  The previous pre-upgrade task succeeded!
  3. Confirme se a versão mais recente do Upgrader foi instalada com sucesso.

    PCA-ADMIN> getUpgradeJobs
    Data: 
      id                            Upgrade Request Id                                Command Name   Result   
      --                            ------------------                                ------------   ------   
      1737484792498-setup-42073     PREUPGRADE-44ec9a80-b3b5-4029-bd77-8178d62173a8   setup          Passed   
      1737483518274-prepare-28393   UWS-e37208d4-d433-4e16-8140-de38c0757c9d          prepare        Passed  

    Caso o processo preUpgrade falhe, verifique o job de upgrade para obter informações de diagnóstico e solução de problemas.

    PCA-ADMIN> getUpgradeJob upgradeJobId=1737484792498-setup-42073
    Data:
      Upgrade Request Id = PREUPGRADE-44ec9a80-b3b5-4029-bd77-8178d62173a8
      Name = setup
      Pid = 25325
      Host = pcamn02
      Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_setup_upgrade_environment_2025_01_21-18.39.52.log
      Arguments = {"component_names":null,"diagnostics":false,"display_task_plan":false,"dry_run_tasks":false,"expected_iso_checksum":null,"fail_halt":false,"fail_upgrade":null,"image_location":null,"online_upgrade":null,"precheck_status":false,"repo_config_override":null,"result_override":null,"task_time":0,"test_run":false,"upgrade":false,"upgrade_to":null,"user_uln_base_url":null,"verify_only":false,"host_ip":null,"log_level":null,"switch_type":null,"epld_image_location":null,"checksum":null,"composition_id":null,"request_id":"PREUPGRADE-44ec9a80-b3b5-4029-bd77-8178d62173a8","uln":null,"patch":null}
      Status = Failed
      Execution Time(sec) = 1069
      Tasks 1 - Name = Validate Setup Image Location
      Tasks 2 - Name = Validate Upgrader Version
      Tasks 3 - Name = Validate Upgrade Order
    [...]
      Tasks 22 - Name = Delete Old backups
      Tasks 22 - Message = [Errno 2] No such file or directory: '/nfs/shared_storage/yum/pca_upgrader'
      Tasks 22 - Status = Failed
  4. Certifique-se de que o sistema esteja em estado de preparada. Em seguida, prossiga com o workflow de upgrade do rack.

  5. Verifique quais componentes precisam ser submetidos a upgrade exibindo o plano de upgrade. Verifique se o número do build de destino corresponde à versão do software do appliance para a qual você está planejando fazer upgrade.

    PCA-ADMIN> getUpgradePlan
    Data: 
      id                          component    currentBuild     targetBuild      currentVersion                   targetVersion                              requireReboot   timeEstimation (min)   requireUpgrade   impactedInfra   
      --                          ---------    ------------     -----------      --------------                   -------------                              -------------   --------------------   --------------   -------------   
      generic                     zfssa        3.0.2-b1300385   3.0.2-b1300385   2013.06.05.8.73.1-2.73.5701.1    2013.06.05.8.73.1-2.73.5701.1              false           45                     false            host,compute    
      100.96.2.64                 compute      3.0.2-b1300130   3.0.2-b1300385   oraclelinux-release-7.9-1.0.9    3.0.202.3.11.0.0.0.5.7ea3f4ccbf3e17fc...   true            50                     true             compute         
      100.96.2.65                 compute      3.0.2-b1300130   3.0.2-b1300385   oraclelinux-release-7.9-1.0.9    3.0.202.3.11.0.0.0.5.7ea3f4ccbf3e17fc...   true            50                     true             compute         
      100.96.2.66                 compute      3.0.2-b1300130   3.0.2-b1300385   oraclelinux-release-7.9-1.0.9    3.0.202.3.11.0.0.0.5.7ea3f4ccbf3e17fc...   true            50                     true             compute         
      100.96.2.33                 host         3.0.2-b1300130   3.0.2-b1300385   oraclelinux-release-7.9-1.0.13   3.0.202.3.11.0.0.0.5.7ea3f4ccbf3e17fc...   true            40                     true             host            
      100.96.2.34                 host         3.0.2-b1300130   3.0.2-b1300385   oraclelinux-release-7.9-1.0.13   3.0.202.3.11.0.0.0.5.7ea3f4ccbf3e17fc...   true            40                     true             host            
      100.96.2.35                 host         3.0.2-b1300130   3.0.2-b1300385   oraclelinux-release-7.9-1.0.13   3.0.202.3.11.0.0.0.5.7ea3f4ccbf3e17fc...   true            40                     true             host            
      generic                     mysql        3.0.2-b1300385   3.0.2-b1300385   8.0.36-1.1                       8.0.36-1.1                                 false           15                     false            host            
      generic                     etcd         3.0.2-b1300385   3.0.2-b1300385   3.5.6                            3.5.6                                      false           5                      false            host            
      generic                     vault        3.0.2-b1300385   3.0.2-b1300385   v1.7.1-3.10.0.0.0.4.g5f2d5af     v1.7.1-3.10.0.0.0.4.g5f2d5af               false           5                      false            host            
      generic                     kubernetes   3.0.2-b1300385   3.0.2-b1300385   1.25.16-2                        1.25.16-2                                  false           60                     false            host,compute    
      generic                     platform     3.0.2-b1300130   3.0.2-b1300385   None                             None                                       false           40                     true             host,compute    
      Oracle-Linux-7.9            ociImages    3.0.2-b1300130   3.0.2-b1300385   None                             2024.07.31_0                               false           5                      true             host            
      Oracle-Linux8-OKE-1.28.8    ociImages    3.0.2-b1300130   3.0.2-b1300385   None                             20241201                                   false           5                      true             host            
      Oracle-Solaris-11           ociImages    3.0.2-b1300130   3.0.2-b1300385   None                             2024.08.26_0                               false           5                      true             host            
      Oracle-Linux8-OKE-1.27.12   ociImages    3.0.2-b1300130   3.0.2-b1300385   None                             20241201                                   false           5                      true             host            
      Oracle-Linux8-OKE-1.26.15   ociImages    3.0.2-b1300130   3.0.2-b1300385   None                             20241201                                   false           5                      true             host            
      Oracle-Linux-9              ociImages    3.0.2-b1300130   3.0.2-b1300385   None                             2024.07.31_0                               false           5                      true             host            
      Oracle-Linux-8              ociImages    3.0.2-b1300130   3.0.2-b1300385   None                             2024.07.31_0                               false           5                      true             host            
      100.96.0.33                 ilom         3.0.2-b1300130   3.0.2-b1300385   5.1.4.20                         5.1.4.25                                   true            10                     true             host,compute    
      100.96.0.34                 ilom         3.0.2-b1300130   3.0.2-b1300385   5.1.4.20                         5.1.4.25                                   true            10                     true             host,compute    
      100.96.0.35                 ilom         3.0.2-b1300130   3.0.2-b1300385   5.1.4.20                         5.1.4.25                                   true            10                     true             host,compute    
      100.96.0.64                 ilom         3.0.2-b1300130   3.0.2-b1300385   5.1.4.20                         5.1.4.25                                   true            10                     true             host,compute    
      100.96.0.65                 ilom         3.0.2-b1300130   3.0.2-b1300385   5.1.4.20                         5.1.4.25                                   true            10                     true             host,compute    
      100.96.0.66                 ilom         3.0.2-b1300130   3.0.2-b1300385   5.1.4.20                         5.1.4.25                                   true            10                     true             host,compute    
      leaf                        switch       3.0.2-b1300385   3.0.2-b1300385   10.3.4a                          10.3.4a                                    false           60                     false            host,compute    
      spine                       switch       3.0.2-b1300385   3.0.2-b1300385   10.3.4a                          10.3.4a                                    false           60                     false            host,compute    
      mgmt                        switch       3.0.2-b1300385   3.0.2-b1300385   10.3.4a                          10.3.4a                                    false           60                     false            host,compute