#8913 [man page] contradiction in ipa-server-upgrade command's man page and usage
Closed: fixed 2 years ago by frenaud. Opened 2 years ago 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

2 years ago

Metadata Update from @frenaud:
- Issue assigned to frenaud

2 years ago

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

2 years ago

master:

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

ipa-4-9:

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

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

2 years ago

Login to comment on this ticket.

Metadata