Remarque :

Ce tutoriel est disponible dans un environnement d'atelier gratuit fourni par Oracle.
Il utilise des exemples de valeur pour les informations d'identification Oracle Cloud Infrastructure, la location et les compartiments. A la fin de votre atelier, remplacez ces valeurs par celles propres à votre environnement cloud.

Mettre à niveau Oracle Linux avec Leapp

Introduction

L'utilitaire Leapp constitue un cadre pour la mise à jour et la mise à niveau des systèmes d'exploitation ainsi que des applications. Les packages de composants de l'utilitaire permettent de créer différents workflows dans des profils pour la mise à jour du logiciel.

Les opérations Leapp se composent de deux phases :

Preupgrade : processus qui examine de nombreux aspects du système et exécute des vérifications pour déterminer si le logiciel du système d'exploitation peut être mis à niveau.
Mise à niveau : met à jour le système en fonction des fichiers de configuration qui mappent les packages entre les versions précédentes et actuelles du logiciel.

Leapp peut être utilisé pour mettre à niveau les instances Oracle Linux 7 Oracle Cloud Infrastructure, ainsi que les systèmes Oracle Linux 7 on-premise.

Cet atelier vous guide tout au long de la mise à niveau d'une instance Oracle Linux 7 Oracle Cloud Infrastructure version actuelle vers Oracle Linux 8.

Leapp n'est pris en charge pour aucun autre système d'exploitation ou version.

Remarque : Avant d'utiliser Leapp dans un environnement de production, il est recommandé de vous familiariser avec le processus de mise à niveau Leapp dans un environnement de test. Cela vous permet de mieux comprendre le processus, ses rapports et de tester tout problème de sécurité ou de compatibilité rencontré.

Objectifs

Dans cet exercice, vous allez apprendre à :

Préparez un système Oracle Linux 7 et utilisez Leapp pour effectuer la mise à niveau vers Oracle Linux 8
Vérifier et modifier les paramètres prérequis sur le système pour prendre en charge la mise à niveau de Leapp
Effectuez une vérification préalable à la mise à niveau pour examiner et créer des rapports sur la configuration du système et les éléments à traiter avant la mise à niveau
Effectuer une mise à niveau du système vers Oracle Linux 8 à l'aide de l'utilitaire Leapp

Prérequis

Instance Oracle Cloud Infrastructure exécutant la version actuelle d'Oracle Linux 7

Remarque : vous pouvez consulter la liste complète des prérequis du système et du noyau, ainsi que les vérifications de pré-mise à niveau qui doivent être effectuées avant la mise à niveau avec Leapp sur ce lien de documentation : Performing System Upgrades with Leapp.

Environnement des exercices de configuration

Lorsque vous utilisez l'environnement d'atelier gratuit, utilisez ce lien vers Oracle Linux Lab Basics pour savoir comment établir une connexion SSH et d'autres instructions d'utilisation.

Ces sections indiquent comment établir la connexion SSH à l'instance à partir du terminal sur votre bureau.

Copier l'adresse IP publique
Connexion à l'instance Oracle Linux

Préparation de la mise à niveau

L'instance utilisée dans cet exercice a des paramètres préconfigurés propres à l'environnement, par exemple les paramètres proxy.

Certaines vérifications préalables à la mise à niveau normalement effectuées sont ignorées car elles ne sont pas requises dans cet environnement.

Remarque : Regardez une vidéo gratuite illustrant le processus de mise à niveau Leapp utilisé dans cet exercice. Le lien se trouve à la fin de cet exercice dans la section Plus d'informations.

Etablissez une connexion SSH à votre instance de système labo.

Rappelez-vous que le lien vers Oracle Linux Lab Basics indique comment établir une connexion SSH et d'autres instructions d'utilisation.
Vérifiez que l'environnement linguistique du système est défini sur en_US.UTF-8.
```
cat /etc/locale.conf
```
Si l'environnement local n'est pas défini correctement, utilisez la commande sudo localectl set-locale LANG=en_US.UTF-8 pour le configurer.

Mettre à jour vers les derniers packages

Mettez à jour tous les packages système vers les dernières versions avec Yum.

sudo yum update -y

Cela prend quelques minutes, une fois les mises à jour terminées, réinitialisez le système.

sudo reboot

Attendez quelques minutes que le redémarrage se termine, puis reconnectez votre connexion SSH à l'instance.

Si la connexion échoue, attendez un peu plus et réessayez.

Installation de l'utilitaire Leapp

Installez l'utilitaire Leapp et ses référentiels de support.

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

Exécuter la vérification avant la mise à niveau

Le processus de pré-mise à niveau évalue si le système est prêt pour une mise à niveau réussie. Il identifie les problèmes potentiels qui peuvent affecter ou empêcher le processus de mise à niveau.

La vérification préalable à la mise à niveau peut être utilisée à tout moment pour évaluer l'état d'un système et identifier l'origine des conflits. Il ne modifie pas le système, mais crée des fichiers de rapport et un journal de débogage contenant des informations sur le système, sa configuration et les problèmes potentiels de mise à niveau.

Exécutez la commande leapp preupgrade pour démarrer le processus de pré-mise à niveau.

Ce système d'exercice est une instance cloud. Utilisez donc le commutateur de commande --oci.

sudo leapp preupgrade --oci

Si le système est un système non cloud, le commutateur --oraclelinux est utilisé.

--oci et --oraclelinux sont des commutateurs pratiques utilisés pour prédéfinir les informations de référentiel et de configuration relatives à un système cloud ou non cloud.

Exemple de sortie :

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

Un fichier leapp-report.txt et un fichier answerfile sont créés et les informations de débogage sont enregistrées dans un fichier journal leapp-preupgrade.log.

Dans cet environnement d'exercices pratiques, le résultat à l'écran identifie un problème qui empêchera la mise à niveau. Il peut également y avoir d'autres problèmes non inhibiteurs dans les fichiers.

Examinez le fichier leapp-report.txt.
```
sudo cat /var/log/leapp/leapp-report.txt
```
Identifiez toutes les entrées à risque élevé marquées comme Risk Factor: high (inhibitor). Cela empêchera l'exécution d'une mise à niveau.

Le rapport fournit un récapitulatif des problèmes et offre des solutions pour les résoudre.

Ce rapport est un outil d'introspection utile qui fournit une bonne vue de ce qui est configuré dans le système, de ce qui peut exister des conflits potentiels, que vous mettiez à niveau ou non.

Examinez le fichier answerfile.

sudo cat /var/log/leapp/answerfile

Exemple de sortie :

[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 =  

La section Available Choices: True/False indique comment modifier le fichier answerfile pour résoudre le problème détecté.

Utilisez la commande sudo leapp answer pour fournir la réponse True à l'élément de module PAM [remove_pam_pkcs11_module_check].

sudo leapp answer --section remove_pam_pkcs11_module_check.confirm=True

Remarque : si vous préférez, vous pouvez également modifier le fichier answerfile à l'aide de la commande sudo vi /var/log/leapp/answerfile et insérer le paramètre True.

Vérifiez que le fichier answerfile a été modifié.
```
sudo cat /var/log/leapp/answerfile
```
- Exemple de sortie :
```
[remove_pam_pkcs11_module_check]  
confirm = True  
```
N'oubliez pas que tous les éléments du fichier answerfile et toutes les entrées Risk Factor: high (inhibitor) à risque élevé dans le fichier leapp-report.txt doivent être résolus.

Vous pouvez exécuter la commande de pré-mise à niveau à tout moment pour générer les fichiers de rapport et vous assurer que les éléments requis sont traités.

Mettre à jour le système

Par comparaison avec après la mise à niveau, vérifiez la version actuelle du système d'exploitation et du noyau du système.

Vérifiez la version d'Oracle Linux en cours d'exécution sur le système.
```
sudo cat /etc/oracle-release
```
Vérifiez la version du noyau utilisée.
```
uname -r
```

Exécutez le traitement de mise à niveau.

sudo leapp upgrade --oci

Remarque : le système d'exercices est une instance cloud. Le commutateur de commande --oci est donc à nouveau utilisé.

Le processus de mise à niveau dure environ 10 minutes et revient à l'invite de commande lorsque vous avez terminé.

Exemple de sortie :

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  

Le processus de mise à niveau met également à jour answerfile, leapp-report.txt et crée un fichier journal leapp-upgrade.log.

Remarque : si vous n'avez pas traité les éléments answerfile et les entrées Risk Factor: high (inhibitor) dans le fichier leapp-report.txt, le processus revient à la ligne de commande et informe les problèmes rencontrés.

Une fois la mise à niveau terminée, réinitialisez le système.
```
sudo reboot
```
La réinitialisation déconnectera la connexion SSH. Pendant le processus d'initialisation, le processus Leapp met automatiquement à niveau les packages.

L'opération de mise à niveau inclut également plusieurs réinitialisations automatiques. Vous ne pourrez pas reconnecter la session SSH tant que toutes les réinitialisations ne seront pas terminées.

Attendez environ 15 minutes, puis reconnectez la session SSH au système. Si la connexion échoue, attendez quelques minutes et réessayez.

Vérifiez la mise à niveau

Comparez la version du système d'exploitation et le noyau désormais utilisés pour le système avec la version de pré-mise à niveau.

Vérifiez la version d'Oracle Linux en cours d'exécution.
```
sudo cat /etc/oracle-release
```
Vérifiez la version du noyau utilisée.
```
uname -r
```
La mise à niveau est terminée car vous voyez à présent que le système exécute Oracle Linux 8.5 et que le noyau utilisé indique el8.

Pour plus d'informations

Voir d'autres ressources connexes :

Vidéo : Mises à niveau d'Oracle Linux avec Leapp
Document : Oracle Linux 8 - Effectuer des mises à niveau système avec Leapp
Luna Labs : Linux OS and Virualization Engineering Labs
Parcours de formation : Utilisation d'Oracle Linux 8
Document : Documentation Oracle Linux

Ressources de formation supplémentaires

Explorez d'autres ateliers sur docs.oracle.com/learn ou accédez à davantage de contenu de formation gratuit sur le canal Oracle Learning YouTube. En outre, accédez à education.oracle.com/learning-explorer pour devenir explorateur Oracle Learning.

Pour consulter la documentation du produit, consultez Oracle Help Center.

Informations relatives au titre et au copyright

Upgrade Oracle Linux with Leapp

F55519-03

October 2022