#8913 [man page] contradiction in ipa-server-upgrade command's man page and usage
Closed: fixed by frenaud. Opened by frenaud.

Ticket was cloned from Red Hat Bugzilla (product Red Hat Enterprise Linux 8): Bug 1973273

Description of problem:
man page for ipa-server-upgrade states that it is not meant to be run by end
user but when upgrade fails, /var/log/ipaupgrade.log states that run
ipa-server-upgrade command manually. Its contradictory statement.
Version-Release number of selected component (if applicable):
ipa-server-4.9.3-1.module+el8.5.0+10565+ae980a94.x86_64
How reproducible:
Steps to Reproduce:
1. man ipa-server-upgrade
Actual results:
$ man ipa-server-upgrade
ipa-server-upgrade(1)                                 IPA Manual Pages
ipa-server-upgrade(1)
NAME
       ipa-server-upgrade - upgrade IPA server
SYNOPSIS
       ipa-server-upgrade [options]
DESCRIPTION
       ipa-server-upgrade  is  used to upgrade IPA server when the IPA packages
are being updated. It is not intended to be
       executed by end-users.
       ipa-server-upgrade will:
           * update LDAP schema
           * process all files with the extension .update in
/usr/share/ipa/updates (including update plugins).
           * upgrade local configurations of IPA services
Expected results:
Specify that ipa-server-upgrade can be run by user as/when needed.
Additional info:

Metadata Update from @frenaud:
- Custom field rhbz adjusted to https://bugzilla.redhat.com/show_bug.cgi?id=1973273

Metadata Update from @frenaud:
- Issue assigned to frenaud

Metadata Update from @frenaud:
- Custom field on_review adjusted to https://github.com/freeipa/freeipa/pull/5878

master:

  • a7c8517826b789941f5c769c626393cacdc5bb1e man page: update ipa-server-upgrade.1

ipa-4-9:

  • 195035cef51a132b2b80df57ed50f2fe620244e6 man page: update ipa-server-upgrade.1

Metadata Update from @frenaud:
- Issue close_status updated to: fixed
- Issue status updated to: Closed (was: Open)

Metadata