Observação:

Atualize o Oracle Linux com o Leapp

Introdução

O utilitário Leapp é uma estrutura para atualizar e atualizar sistemas operacionais, bem como aplicativos. Os pacotes de componentes do utilitário permitem a criação de fluxos de trabalho diferentes em perfis para atualização de software.

As operações Leapp consistem em duas fases:

O Leapp pode ser usado para fazer upgrade das instâncias do Oracle Linux 7 Oracle Cloud Infrastructure, bem como para sistemas locais do Oracle Linux 7.

Este laboratório orienta você para o upgrade de uma instância do Oracle Linux 7 Oracle Cloud Infrastructure release atual para o Oracle Linux 8.

O Leapp não é suportado por outros sistemas operacionais ou versões.

Observação: Antes de usar o Leapp em um ambiente de produção, é recomendável familiarizar-se com o processo de atualização do Leapp em um ambiente de teste. Isso permite que você entenda melhor o processo, seus relatórios e teste quaisquer problemas de segurança ou compatibilidade que possam ser encontrados.

Objetivos

Neste laboratório, você aprenderá a:

Pré-requisitos

Observação: Você pode exibir a lista completa de pré-requisitos do sistema e do kernel e as verificações de pré-upgrade que devem ser feitas antes da atualização com o Leapp neste link de documentação: Executando Atualizações do Sistema com o Leapp.

Configurar Ambiente de Laboratório

Ao usar o ambiente de laboratório gratuito, use este link para Conceitos Básicos do Oracle Linux Lab para ver como estabelecer uma conexão SSH e outras instruções de uso.

Estas seções mostram como fazer a conexão SSH com a instância no Terminal da sua área de trabalho.

Preparando para o Upgrade

A instância usada neste laboratório tem definições pré-configuradas específicas do ambiente, por exemplo; definições de proxy.

Algumas verificações de pré-upgrade normalmente executadas são ignoradas, pois não são necessárias neste ambiente.

Observação: você pode assistir a um vídeo gratuito demonstrando o processo de upgrade do Leapp usado neste laboratório. Você encontrará o link na seção Mais Informações ao final deste laboratório.

  1. Estabeleça uma conexão SSH com a instância do sistema de laboratório.

    Lembre-se de que o link para o Oracle Linux Lab Basics mostra como estabelecer uma conexão SSH e outras instruções de uso.

  2. Verifique se a configuração regional do sistema está definida como en_US.UTF-8.

    cat /etc/locale.conf

    Se a configuração regional não estiver definida corretamente, use o comando sudo localectl set-locale LANG=en_US.UTF-8 para configurar isso.

Atualizar para os pacotes mais recentes

Atualize todos os pacotes do sistema para as versões mais recentes com o Yum.

sudo yum update -y

Isso leva alguns minutos, quando as atualizações são concluídas, reinicialize o sistema.

sudo reboot

Aguarde alguns minutos para que a reinicialização seja concluída e reconecte sua conexão SSH à instância.

Se a conexão falhar, aguarde um pouco mais e tente novamente.

Instalar o Utilitário Leapp

Instale o utilitário Leapp e seus repositórios de suporte.

sudo yum install -y leapp --enablerepo=ol7_leapp,ol7_latest

Executar a verificação de pré-atualização

O processo de pré-upgrade avalia se o sistema está preparado para uma atualização bem-sucedida. Ele identifica possíveis problemas que podem afetar ou impedir o processo de atualização.

A verificação de pré-upgrade pode ser usada a qualquer momento para avaliar o status de um sistema e identificar onde podem ocorrer conflitos. Ele não altera o sistema, mas cria arquivos de relatório e um log de depuração, contendo informações sobre o sistema, sua configuração e possíveis problemas de upgrade.

  1. Execute o comando leapp preupgrade para iniciar o processo de pré-upgrade.

    Este sistema de laboratório é uma instância de nuvem, portanto, use o switch de comando --oci.

    sudo leapp preupgrade --oci

    Se o sistema não for um sistema em nuvem, o switch --oraclelinux será usado.

    Os --oci e --oraclelinux são switches de conveniência usados para predefinir informações de repositório e configuração relevantes para um sistema na nuvem ou não na nuvem.

    • Exemplo de saída:
    ============================================================  
                      UPGRADE INHIBITED                     
============================================================  
                                                                
Upgrade has been inhibited due to the following problems:  
    1. Inhibitor: Missing required answers in the answer file  
Consult the pre-upgrade report for details and possible remediation.  
                                                                
============================================================  
                   UPGRADE INHIBITED                        
============================================================  
                                                                
                                                                
Debug output written to /var/log/leapp/leapp-preupgrade.log  
                                                            
============================================================  
                         REPORT                             
============================================================  
                                                               
A report has been generated at /var/log/leapp/leapp-report.json
A report has been generated at /var/log/leapp/leapp-report.txt
                                                              
============================================================
                     END OF REPORT                          
============================================================  
                                                              
Answerfile has been generated at /var/log/leapp/answerfile

    Um arquivo leapp-report.txt e um answerfile são criados e as informações de depuração são salvas em um arquivo de log leapp-preupgrade.log.

    Neste ambiente de laboratório, o resultado na tela identifica um problema que inibirá a atualização. Também pode haver outros problemas que não inibem os arquivos.

  2. Examine o arquivo leapp-report.txt.

    sudo cat /var/log/leapp/leapp-report.txt

    Identifique as entradas de alto risco marcadas como Risk Factor: high (inhibitor). Isso evitará a conclusão de uma atualização.

    O relatório fornece um resumo dos problemas e oferece soluções para resolvê-los.

    Este relatório é uma ferramenta útil de introspecção, fornecendo uma boa visão do que está configurado no sistema, quais conflitos potenciais podem existir, independentemente de você atualizar ou não.

  3. Examine o answerfile.

    sudo cat /var/log/leapp/answerfile
    • Exemplo de saída:
    [remove_pam_pkcs11_module_check]  
# Title:              None  
# Reason:             Confirmation  
# =================== remove_pam_pkcs11_module_check.confirm ==================  
# Label:              Disable pam_pkcs11 module in PAM configuration? If no, the upgrade process will be interrupted.  
# Description:        PAM module pam_pkcs11 is no longer available in OL-8 since it was replaced by SSSD.  
# Type:               bool  
# Default:            None  
# Available choices: True/False  
# Unanswered question. Uncomment the following line with your answer  
# confirm =

    A seção Available Choices: True/False informa como modificar o arquivo de resposta para tratar do problema encontrado.

    Use o comando sudo leapp answer para fornecer a resposta True ao item do módulo PAM [remove_pam_pkcs11_module_check].

    sudo leapp answer --section remove_pam_pkcs11_module_check.confirm=True

    Observação: Se preferir, edite também o answerfile com o comando sudo vi /var/log/leapp/answerfile e insira a definição True.

  4. Verifique se o answerfile foi modificado.

    sudo cat /var/log/leapp/answerfile
    • Exemplo de saída:
    [remove_pam_pkcs11_module_check]  
confirm = True

    Lembre-se de que todos os itens do answerfile e quaisquer entradas Risk Factor: high (inhibitor) de alto risco no arquivo leapp-report.txt devem ser resolvidas.

    Você pode executar o comando de pré-upgrade a qualquer momento para gerar os arquivos de relatório e garantir que os itens necessários sejam tratados.

Atualizar o sistema

Para comparação após o upgrade, verifique a versão atual do sistema operacional e do kernel.

  1. Verifique a versão do Oracle Linux em execução no sistema.

    sudo cat /etc/oracle-release

  2. Verifique a versão do kernel usada.

    uname -r

  3. Executar o processo de atualização.

    sudo leapp upgrade --oci

    Observação: O sistema de laboratório é uma instância na nuvem, portanto, o switch de comando --oci é usado novamente.

    O processo de upgrade levará aproximadamente 10 minutos e retornará ao prompt de comando quando terminar.

    • Exemplo de saída:
    The downloaded packages were saved in cache until the next successful  
transaction.  
You can remove cached packages by executing 'dnf clean packages'.  
==> Processing phase 'InterimPreparation'  
====> * efi_interim_fix  
       Adjust EFI boot entry for first reboot  
====> * initram_disk_generator  
       Creates the upgrade initram disk  
====> * add_upgrade_boot_entry  
       Add new boot entry for Leapp provided initramfs.  
A reboot is required to continue. Please reboot your system.  
  
Debug output written to /var/log/leapp/leapp-upgrade.log  
  
============================================================  
                          REPORT
============================================================  
  
A report has been generated at /var/log/leapp/leapp-report.json  
A report has been generated at /var/log/leapp/leapp-report.txt  
  
============================================================  
                      END OF REPORT  
============================================================  
  
Answerfile has been generated at /var/log/leapp/answerfile

    O processo de atualização também atualiza o answerfile, leapp-report.txt, e cria um arquivo de log leapp-upgrade.log.

    Observação: Se você não tiver abordado os itens answerfile e as entradas Risk Factor: high (inhibitor) no arquivo leapp-report.txt, o processo voltará à linha de comando e informará sobre os problemas encontrados.

  4. Quando a atualização for concluída, reinicialize o sistema.

    sudo reboot

    A reinicialização desconectará a conexão SSH. Durante o processo de inicialização, o processo Leapp atualiza automaticamente os pacotes.

    A operação de upgrade também inclui várias reinicializações automáticas. Você não poderá reconectar a sessão SSH até que todas as reinicializações sejam concluídas.

    Aguarde aproximadamente 15 minutos e reconecte a sessão SSH ao sistema. Se a conexão falhar, aguarde alguns minutos e tente novamente.

Confirme o upgrade

Compare a versão do SO e o kernel agora usados para o sistema com a versão de pré-upgrade.

  1. Verifique a versão do Oracle Linux em execução.

    sudo cat /etc/oracle-release

  2. Verifique a versão do kernel usada.

    uname -r

    O upgrade está concluído porque agora você vê que o sistema está executando o Oracle Linux 8.5 e o kernel usado mostra el8.

Para Obter Mais Informações

Consulte outros recursos relacionados:

Mais Recursos de Aprendizagem

Explore outros laboratórios em docs.oracle.com/learn ou acesse mais conteúdo de aprendizado gratuito no canal YouTube do Oracle Learning. Além disso, visite education.oracle.com/learning-explorer para se tornar um Oracle Learning Explorer.

Para obter a documentação do produto, visite o Oracle Help Center.