Skip to content

Commit

Permalink
Add additional KB resources
Browse files Browse the repository at this point in the history
add aditional KB resources in a form of ExternalLink or
error details as requested by support
  • Loading branch information
Rezney authored and pirat89 committed May 3, 2024
1 parent 64e2c58 commit 3cb522d
Show file tree
Hide file tree
Showing 21 changed files with 103 additions and 2 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,10 @@ def inhibit_upgrade(avail_bytes):
'/boot needs additional {0} MiB to be able to accommodate the upgrade initramfs and new kernel.'.format(
additional_mib_needed)
),
reporting.ExternalLink(
url='https://access.redhat.com/solutions/298263',
title='Why does kernel cannot be upgraded due to insufficient space in /boot ?'
),
reporting.Severity(reporting.Severity.HIGH),
reporting.Groups([reporting.Groups.FILESYSTEM]),
reporting.Groups([reporting.Groups.INHIBITOR]),
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,11 @@ def checkcifs(storage_info):
reporting.Groups.NETWORK
]),
reporting.Remediation(hint='Comment out CIFS entries to proceed with the upgrade.'),
reporting.ExternalLink(
url='https://access.redhat.com/solutions/6964304',
title='Leapp upgrade failed with error '
'"Inhibitor: Use of CIFS detected. Upgrade cannot proceed"'
),
reporting.Groups([reporting.Groups.INHIBITOR]),
reporting.RelatedResource('file', '/etc/fstab')
])
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,16 @@ def create_inhibitors(inhibiting_entries):
source=get_source_major_version(),
)
),
reporting.ExternalLink(
url='https://access.redhat.com/solutions/6971716',
title='Leapp preupgrade getting "Inhibitor: Detected loaded kernel drivers which have been '
'removed in RHEL 8. Upgrade cannot proceed." '
),
reporting.ExternalLink(
url='https://access.redhat.com/solutions/5436131',
title='Leapp upgrade fail with error "Inhibitor: Detected loaded kernel drivers which '
'have been removed in RHEL 8. Upgrade cannot proceed."'
),
reporting.Audience('sysadmin'),
reporting.Groups([reporting.Groups.KERNEL, reporting.Groups.DRIVERS]),
reporting.Severity(reporting.Severity.HIGH),
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,11 @@ def process():
reporting.Summary(summary),
reporting.Severity(reporting.Severity.HIGH),
reporting.Groups([reporting.Groups.SANITY, reporting.Groups.INHIBITOR]),
reporting.ExternalLink(
url='https://access.redhat.com/solutions/7014179',
title='Leapp upgrade fail with error"Minimum memory requirements '
'for RHEL 8 are not met"Upgrade cannot proceed'
),
reporting.ExternalLink(
url='https://access.redhat.com/articles/rhel-limits',
title='Red Hat Enterprise Linux Technology Capabilities and Limits'
Expand Down
4 changes: 4 additions & 0 deletions repos/system_upgrade/common/actors/checknfs/actor.py
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,10 @@ def _is_nfs(a_type):
reporting.Groups.NETWORK
]),
reporting.Remediation(hint='Disable NFS temporarily for the upgrade if possible.'),
reporting.ExternalLink(
url='https://access.redhat.com/solutions/6964006',
title='Why does leapp upgrade fail on detecting NFS during upgrade?'
),
reporting.Groups([reporting.Groups.INHIBITOR]),
] + fstab_related_resource
)
5 changes: 5 additions & 0 deletions repos/system_upgrade/common/actors/checkrootsymlinks/actor.py
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,11 @@ def process(self):
'point to absolute paths.\n'
'Please change these links to relative ones.'
),
reporting.ExternalLink(
url='https://access.redhat.com/solutions/6989732',
title='leapp upgrade stops with Inhibitor "Upgrade requires links in root '
'directory to be relative"'
),
reporting.Severity(reporting.Severity.HIGH),
reporting.Groups([reporting.Groups.INHIBITOR])]

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,10 @@ def check_required_yum_plugins_enabled(pkg_manager_info):
# Provide all commands as one due to problems with satellites
commands=[['bash', '-c', '"{0}"'.format('; '.join(remediation_commands))]]
),
reporting.ExternalLink(
url='https://access.redhat.com/solutions/7028063',
title='Why is Leapp preupgrade generating "Inhibitor: Required YUM plugins are not being loaded."'
),
reporting.RelatedResource('file', pkg_manager_config_path),
reporting.RelatedResource('file', subscription_manager_plugin_conf),
reporting.RelatedResource('file', product_id_plugin_conf),
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -103,5 +103,10 @@ def process():
reporting.Groups([reporting.Groups.KERNEL, reporting.Groups.BOOT]),
reporting.Groups([reporting.Groups.INHIBITOR]),
reporting.Remediation(hint=remediation),
reporting.ExternalLink(
url='https://access.redhat.com/solutions/7014134',
title='Leapp upgrade fail with error "Inhibitor:Newest installed kernel '
'not in use" Upgrade cannot proceed'
),
reporting.RelatedResource('package', 'kernel')
])
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,10 @@ def _consume_data():
used_target_repos = next(api.consume(UsedTargetRepositories)).repos
except StopIteration:
raise StopActorExecutionError(
'Could not check for valid GPG keys', details={'details': 'No UsedTargetRepositories facts'}
'Could not check for valid GPG keys', details={
'details': 'No UsedTargetRepositories facts',
'link': 'https://access.redhat.com/solutions/7061850'
}
)

try:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -135,6 +135,11 @@ def process8to9(self, config):
'sshd_config next to the "PermitRootLogin yes" directive '
'to prevent rpm replacing it during the upgrade.'
),
reporting.ExternalLink(
url='https://access.redhat.com/solutions/7003083',
title='Why Leapp Preupgrade for RHEL 8 to 9 getting '
'"Possible problems with remote login using root account" ?'
),
reporting.Groups([reporting.Groups.INHIBITOR])
] + COMMON_RESOURCES)
# If the configuration is modified and contains any directive allowing
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,11 @@ def process(self):
title='How to perform an in-place upgrade to RHEL 8 when using kernel NIC names on RHEL 7',
url='https://access.redhat.com/solutions/4067471'
),
reporting.ExternalLink(
title='RHEL 8 to RHEL 9: inplace upgrade fails at '
'"Network configuration for unsupported device types detected"',
url='https://access.redhat.com/solutions/7009239'
),
reporting.Remediation(
hint='Rename all ethX network interfaces following the attached KB solution article.'
),
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -828,6 +828,10 @@ def _get_rhsm_available_repoids(context):
' to set up Satellite and the system properly.'

).format(target_major_version)),
reporting.ExternalLink(
url='https://access.redhat.com/solutions/5392811',
title='RHEL 7 to RHEL 8 LEAPP Upgrade Failing When Using Red Hat Satellite'
),
reporting.ExternalLink(
# https://red.ht/preparing-for-upgrade-to-rhel8
# https://red.ht/preparing-for-upgrade-to-rhel9
Expand Down Expand Up @@ -1007,6 +1011,11 @@ def gather_target_repositories(context, indata):
# https://red.ht/preparing-for-upgrade-to-rhel10
url='https://red.ht/preparing-for-upgrade-to-rhel{}'.format(target_major_version),
title='Preparing for the upgrade'),
reporting.ExternalLink(
url='https://access.redhat.com/solutions/7001181',
title='LEAPP Upgrade Failing from RHEL 7 to RHEL 8 when system is '
'registered to custromer portal'
),
reporting.RelatedResource("file", "/etc/leapp/files/repomap.json"),
reporting.RelatedResource("file", "/etc/yum.repos.d/")
])
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -20,5 +20,10 @@ def check_dialogs(inhibit_if_no_userchoice=True):
reporting.Summary(summary.format('\n'.join(sections))),
reporting.Groups([reporting.Groups.INHIBITOR] if inhibit_if_no_userchoice else []),
reporting.Remediation(hint=dialogs_remediation, commands=cmd_remediation),
reporting.ExternalLink(
url='https://access.redhat.com/solutions/7035321',
title='Leapp upgrade fail with error "Inhibitor: Missing required answers '
'in the answer file."'
),
reporting.Key(dialog.key)]
reporting.create_report(report_data + dialog_resources)
3 changes: 2 additions & 1 deletion repos/system_upgrade/common/libraries/rhsm.py
Original file line number Diff line number Diff line change
Expand Up @@ -85,7 +85,8 @@ def _handle_rhsm_exceptions(hint=None):
details={
'details': str(e),
'stderr': e.stderr,
'hint': hint or _def_hint
'hint': hint or _def_hint,
'link': 'https://access.redhat.com/solutions/6138372'
}
)

Expand Down
4 changes: 4 additions & 0 deletions repos/system_upgrade/el7toel8/actors/checkbtrfs/actor.py
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,10 @@ def process(self):
title='How do I prevent a kernel module from loading automatically?',
url='https://access.redhat.com/solutions/41278'
),
reporting.ExternalLink(
title='Leapp upgrade fail with error "Inhibitor: Btrfs has been removed from RHEL8"',
url='https://access.redhat.com/solutions/7020130'
),
reporting.Severity(reporting.Severity.HIGH),
reporting.Groups([reporting.Groups.INHIBITOR]),
reporting.Groups([reporting.Groups.FILESYSTEM]),
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,10 @@ def inhibit(node_type):
" to a RHEL High Availability or Resilient Storage Cluster"
),
),
reporting.ExternalLink(
url='https://access.redhat.com/solutions/7049940',
title='Leapp upgrade from RHEL 7 to RHEL 8 fails for pacemaker cluster'
),
reporting.Remediation(
hint=(
"Destroy the existing HA cluster"
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,10 @@ def process(self):
'please remove the pam module(s) from all the files '
'under /etc/pam.d/.'.format(', '.join(replacements))
),
reporting.ExternalLink(
url='https://access.redhat.com/solutions/7004774',
title='Leapp preupgrade fails with: The pam_tally2 pam module(s) no longer available'
),
reporting.Severity(reporting.Severity.HIGH),
reporting.Groups([reporting.Groups.INHIBITOR]),
] + [reporting.RelatedResource('pam', r) for r in replacements | found_modules])
Original file line number Diff line number Diff line change
Expand Up @@ -38,5 +38,9 @@ def process():
reporting.Groups([reporting.Groups.KERNEL]),
reporting.Groups([reporting.Groups.INHIBITOR]),
reporting.Remediation(hint=hint, commands=commands),
reporting.ExternalLink(
url='https://access.redhat.com/solutions/4723671',
title='leapp upgrade fails on kernel-devel packages'
),
reporting.RelatedResource('package', 'kernel-devel')
])
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,11 @@ def satellite_upgrade_check(facts):
reporting.create_report([
reporting.Title(title),
reporting.Summary(summary),
reporting.ExternalLink(
url='https://access.redhat.com/solutions/6794671',
title='Leapp preupgrade of Red Hat Satellite 6 fails on '
'Old PostgreSQL data found in /var/lib/pgsql/data'
),
reporting.Severity(severity),
reporting.Groups([]),
reporting.Groups(flags)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -88,6 +88,11 @@ def process():
reporting.Title(title),
reporting.Summary(summary),
reporting.Remediation(hint=remediation),
reporting.ExternalLink(
url='https://access.redhat.com/solutions/7009239',
title='RHEL 8 to RHEL 9: inplace upgrade fails at '
'"Network configuration for unsupported device types detected"'
),
reporting.Severity(reporting.Severity.HIGH),
reporting.Groups([reporting.Groups.NETWORK, reporting.Groups.SERVICES]),
reporting.Groups([reporting.Groups.INHIBITOR]),
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,11 @@ def process(self):
reporting.ExternalLink(
url='https://access.redhat.com/articles/4855631',
title='Changes in firewalld related to Zone Drifting'),
reporting.ExternalLink(
url='https://access.redhat.com/solutions/6969130',
title='Leapp Preupgrade check fails with error - '
'"Inhibitor: Firewalld Configuration AllowZoneDrifting Is Unsupported".'
),
reporting.Remediation(
hint='Set AllowZoneDrifting=no in /etc/firewalld/firewalld.conf',
commands=[['sed', '-i', 's/^AllowZoneDrifting=.*/AllowZoneDrifting=no/',
Expand Down

0 comments on commit 3cb522d

Please sign in to comment.