Chapter 3. Reviewing the pre-upgrade report
To assess upgradability of your system, start the pre-upgrade process by the leapp preupgrade
command. During this phase, the Leapp
utility collects data about the system, assesses upgradability, and generates a pre-upgrade report.
The pre-upgrade report is available both in the /var/log/leapp/leapp-report.txt
file and in the web console. The report summarizes potential problems and proposes recommended solutions. The report also helps you decide whether it is possible or advisable to proceed with the upgrade.
In certain configurations, Leapp
generates true/false questions to determine how to proceed. All questions are stored in /var/log/leapp/answerfile
and in the pre-upgrade report in the Missing required answers in the answer file
message. Leapp
inhibits the upgrade if you do not provide answers to all the questions.
You have two options when assessing upgradability in the pre-upgrade phase:
-
Review the pre-upgrade report in the generated
leapp-report.txt
file and manually resolve reported problems using the command-line interface. - Use the web console to review the report, apply automated remediations where available, and fix remaining problems using the suggested remediation hints.
During the pre-upgrade phase, Leapp
neither simulates the whole in-place upgrade process nor downloads all RPM packages.
Reviewing a pre-upgrade report is useful also if you decide or need to redeploy a RHEL 8 system without the in-place upgrade process.
You can process the pre-upgrade report using your own custom scripts, for example, to compare results from multiple reports across different environments. For more information, see Automating your Red Hat Enterprise Linux pre-upgrade report workflow.
3.1. Assessing upgradability from the command line
Identify potential upgrade problems during the pre-upgrade phase using the command-line interface.
Prerequisites
- The steps listed in Preparing a RHEL 7 system for the upgrade have been completed.
Procedure
On your RHEL 7 system, perform the pre-upgrade phase:
# leapp preupgrade
NoteIf you are going to use custom repositories from the
/etc/yum.repos.d/
directory for the upgrade, enable the selected repositories as follows:# leapp preupgrade --enablerepo repository_id1 --enablerepo repository_id2 ...
If you are going to upgrade without RHSM or using RHUI, add the
--no-rhsm
option.Provide answers to each question required by
Leapp
by either of the following methods:Execute the
leapp answer
command, specifying the question you are responding to and your confirmed answer.# leapp answer --section question_section.confirm=answer
For example, to confirm a
True
response to the question Disable pam_pkcs11 module in PAM configuration?, execute the following command:# leapp answer --section remove_pam_krb5_module_check.confirm=True
-
Manually edit the
/var/log/leapp/answerfile
file, uncomment theconfirm
line of the file by deleting the#
symbol, and confirm your answer asTrue
orFalse
; see Leapp answerfile.
-
Examine the report in the
/var/log/leapp/leapp-report.txt
file, and manually resolve all the reported problems before proceeding with the in-place upgrade.
3.2. Assessing upgradability and applying automated remediations through the web console
Identify potential problems in the pre-upgrade phase and how to apply automated remediations using the web console.
Prerequisites
- The steps listed in Preparing a RHEL 7 system for the upgrade have been completed.
Procedure
Install the
cockpit-leapp
plug-in:# yum install cockpit-leapp
-
Navigate to the web console in your browser and log in as
root
or as a user configured in the/etc/sudoers
file. See Managing systems using the RHEL 7 web console for more information about the web console. On your RHEL 7 system, perform the pre-upgrade phase either from the command-line interface or from the web console terminal:
# leapp preupgrade
NoteIf you are going to use custom repositories from the
/etc/yum.repos.d/
directory for the upgrade, enable the selected repositories as follows:# leapp preupgrade --enablerepo repository_id1 --enablerepo repository_id2 ...
If you are going to upgrade without RHSM or using RHUI, add the
--no-rhsm
option.In the web console, select
from the left menu.Figure 3.1. In-place upgrade report in the web console
The report table provides an overview of the problems found, their risk assessment, and remediations (if available).
Risk factor:
- High - very likely to result in a deteriorated system state
- Medium - can impact both the system and applications
- Low - should not impact the system but can have an impact on applications
- Info - informational with no expected impact to the system or applications
- Inhibitor - will inhibit (hard stop) the upgrade process, otherwise the system could become unbootable, inaccessible, or dysfunctional
Remediation - an actionable solution to a reported problem:
- Remediation command - can be executed directly through the web console
- Remediation hint - instructions on how to resolve the problem manually
Examine the content of the report. You can sort the table by clicking a header. To open a detail pane, click a selected row.
Figure 3.2. Detail pane
The detail pane displays the following additional information:
- Summary of the problem and links to Knowledgebase articles describing the problem in more detail
- Remediations - you can run or schedule an automated remediation (if available), and see its results when applied
- Affected system resources: packages, repositories, files (configuration, data), disks, volumes
Optionally filter the results. Click the
button in the top left corner above the report and apply a filter based on your preferences. Filter categories are applied in conjunction with one another.Figure 3.3. Filters
Select issues for which you want to apply an automated remediation. You have two options:
- Choose individual items by clicking the button in the detail pane. Alternatively, you can execute individual remediations directly by clicking in the detail pane.
- Select all items for which a remediation is available by clicking the button in the top right corner above the report.
Review and answer questions required by
Leapp
in the web console. Each unanswered question appears as aMissing required answers in the answer file
title in the Upgrade Report. Select a title to answer the question:-
To confirm the default
True
answer, select to execute the remediation later or to execute the remediation immediately. To select the non-default answer instead, perform either of the following:
Execute the
leapp answer
command, specifying the question you are responding to and your confirmed answer.# leapp answer --section question_section.confirm=answer
For example, to confirm a
False
response to the question Disable pam_pkcs11 module in PAM configuration?, execute the following command:# leapp answer --section remove_pam_krb5_module_check.confirm=False
Manually edit the
/var/log/leapp/answerfile
file, uncomment theconfirm
line of the file by deleting the#
symbol, and confirm your answer asTrue
orFalse
; see Leapp answerfile example.Figure 3.4. Missing unanswered Leapp question
-
To confirm the default
Open the remediation plan by clicking the
link in the top right corner above the report. The remediation plan provides a list of all executed or scheduled remediations.Figure 3.5. Remediation plan
Process all scheduled remediations by clicking
. The following information is displayed for each remediation entry:- A unique ID of the remediation
- Exit status of the command
- Elapsed time of the executed remediation
- Standard output
- Standard error
-
After executing selected remediations, generate the pre-upgrade report again by using the
leapp preupgrade
command, examine the new report, and take additional remediation steps if needed.