Pré-configurando o Ambiente de Atualização do Private Cloud Appliance

Nós de Computação Não Provisionados

Se o Private Cloud Appliance contiver nós de computação não provisionados, eles poderão causar erros durante o upgrade ou a aplicação de patches e poderão ter problemas de provisionamento posteriormente. Portanto, quando existir um registro no banco de dados do nó, o nó de computação deverá ser provisionado e adicionado a um domínio de falha; caso contrário, o processo de upgrade ou aplicação de patches não poderá continuar.

Se você precisar fazer upgrade ou aplicar patches no software do appliance em um sistema com nós de computação que não podem ser provisionados, esses registros de banco de dados deverão ser removidos. Entre em contato com a Oracle para obter assistência.

Para obter mais informações sobre provisionamento, consulte Executando Operações Administrativas em Nós de Computação.

Versão do Pré-requisito

O código mais recente do Upgrader impõe automaticamente as versões de software de pré-requisito no seu Private Cloud Appliance. Nos estágios iniciais de atualização ou preparação de patch, o serviço Upgrader valida a versão do software do appliance atualmente instalada em relação à nova versão de destino. O processo de preparação (upgradePreConfig) documentado nesta seção só prosseguirá se a validação for bem-sucedida.

Se o appliance não estiver executando pelo menos a versão mínima necessária, o Upgrader sairá do processo e fará rollback do ambiente para seu estado anterior. Exiba os detalhes do job de upgrade com falha:

PCA-ADMIN> getupgradejob upgradeJobId=1700153626051-prepare-40046
Data:
  Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_prepare_environment_2023_11_16-16.53.46.log
  Arguments = [...]
  Status = Failed
[...]
  Tasks 23 - Name = Check Prerequisite Build Version
  Tasks 23 - Description = Check current build version not lower than prerequisite version
  Tasks 24 - Name = Check Prerequisite Build Version
  Tasks 24 - Message = (("Caught exception while checking prerequisite build number 
  Exception: Command: ['/usr/bin/python3', '/var/lib/pca-upgrader/prerequisite_build_validator.py', 
  'rack=PCA', 'upgrade=ISO'] failed (1): stderr: b'' stdout: b'PCA version is lower than prerequisite build, 
  must upgrade to prerequisite build 3.0.2-b892153 to proceed further upgrade\\n'",), {})
  Tasks 24 - Status = Failed

Primeiro instale a versão de pré-requisito, que é indicada pela mensagem de erro na saída do job de upgrade.

Executando as Tarefas de Pré-configuração

Execute a pré-configuração da interface do usuário ou da CLI.

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: Upgrade PreConfig.

5. Preencha os parâmetros da solicitação de atualização:

   • Opção: Digite ISO.

   • Local: Informe o caminho para o local onde a imagem ISO está armazenada. Se esta versão consistir em vários ISOs, aponte para o arquivo pca-3.0.2-<build_no>.iso principal.

   • Soma de Verificação ISO: Informe a soma de verificação necessária para verificar a integridade da imagem ISO. A soma de verificação é fornecida juntamente com a imagem ISO em um arquivo chamado <iso_image>.sha256sum.

   • Nível de Log: Opcionalmente, selecione um nível de log específico para o arquivo de log de upgrade. O nível de log padrão é "Informações". Para obter o máximo de detalhes, selecione "Depurar".

   • JSON de Opções Avançadas: Opcionalmente, adicione uma string JSON para fornecer parâmetros de comando adicionais.

   • Canal ULN Alternativo: Esse parâmetro se aplica à aplicação de patches e pode ser ignorado.

6. Clique em Criar Solicitação.

   A nova solicitação de upgrade aparece na tabela Jobs de Upgrade. As etapas de pré-configuração são executadas conforme descrito no início desta seção.

Usando a CLI do Serviço

1. Reúna as informações necessárias para executar o comando:

   • a localização da imagem ISO a ser atualizada de

     Insira o caminho para onde a imagem ISO está armazenada. Se esta versão consistir em vários ISOs, aponte para o arquivo pca-3.0.2-<build_no>.iso principal.

     Todo o conteúdo ISO será descompactado no armazenamento compartilhado acessível a partir dos nós de gerenciamento. Imagens ISO secundárias são detectadas e processadas automaticamente, mas devem ser armazenadas no mesmo diretório de origem.

   • a soma de verificação usada para verificar a imagem ISO

     A soma de verificação é fornecida juntamente com a imagem ISO. Seu nome de arquivo é o nome da imagem ISO com .sha256sum anexado. O sistema usa a soma de verificação para verificar se os dados nas imagens ISO estão intactos e válidos para esta atualização.

2. Informe o comando de pré-configuração de upgrade.

   Sintaxe (inserida em uma única linha):

   upgradePreConfig 
   option=ISO
   location=<path-to-iso>
   isoChecksum=<iso-file-checksum>

   Exemplo:

   PCA-ADMIN> upgradePreConfig  option=ISO \
   location=http://host.example.com/pca-<version>-<build>.iso \
   isoChecksum=4a7778d45b3996319ee67c772fbbc0320a9806a942490a1cfe6b37930372809e
   Status: Success
   JobId: 105524a2-24a2-4b52-91c4-5cd8832552d2
   Data: Service request has been submitted. Upgrade Job Id = 1737483518274-prepare-28393 Upgrade Request Id = UWS-e37208d4-d433-4e16-8140-de38c0757c9d

3. Use o ID da solicitação e o ID do job para verificar o status do processo de upgrade.

   PCA-ADMIN> getUpgradeJobs
   Data: 
     id                            Upgrade Request Id                                Command Name   Result   
     --                            ------------------                                ------------   ------   
     1737483518274-prepare-28393   UWS-e37208d4-d433-4e16-8140-de38c0757c9d          prepare        Passed
   
   PCA-ADMIN> getUpgradeJob upgradeJobId=1737483518274-prepare-28393
   Status: Success
   Data:
     Upgrade Request Id = UWS-e37208d4-d433-4e16-8140-de38c0757c9d
     Name = prepare
     Pid = 28393
     Host = pcamn02
     Log File = /nfs/shared_storage/pca_upgrader/log/pca-upgrader_prepare_environment_2025_01_21-18.18.38.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":"https://host.example.com/pca-<version>-<build>.iso","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":"4a7778d45b3996319ee67c772fbbc0320a9806a942490a1cfe6b37930372809e","composition_id":null,"request_id":"UWS-e37208d4-d433-4e16-8140-de38c0757c9d","uln":null,"patch":null}
     Status = Passed
     Execution Time(sec) = 776
     Tasks 1 - Name = Validate Image Location
     Tasks 1 - Description = Verify that the image exists at the specified location and is correctly named
   [...]

4. Prossiga para a próxima fase de preparação de atualização.