Bug 1973273

Summary: [man page] contradiction in ipa-server-upgrade command's man page and usage
Product: Red Hat Enterprise Linux 8 Reporter: Mohammad Rizwan <myusuf>
Component: ipaAssignee: Florence Blanc-Renaud <frenaud>
Status: CLOSED ERRATA QA Contact: ipa-qe <ipa-qe>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 8.4CC: frenaud, pcech, rcritten, ssidhaye, sumenon, tscherf, twoerner
Target Milestone: betaKeywords: Triaged
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: idm-client-8050020210715144943.de73ecb2 Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of:
: 1981789 (view as bug list) Environment:
Last Closed: 2021-11-09 18:29:22 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 1981789    

Description Mohammad Rizwan 2021-06-17 14:13:20 UTC
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:

Comment 1 Florence Blanc-Renaud 2021-07-07 12:06:39 UTC
Upstream ticket:
https://pagure.io/freeipa/issue/8913

Comment 2 Florence Blanc-Renaud 2021-07-07 19:56:04 UTC
Fixed upstream
master:
https://pagure.io/freeipa/c/a7c8517826b789941f5c769c626393cacdc5bb1e

Comment 3 Florence Blanc-Renaud 2021-07-08 16:11:32 UTC
Fixed upstream
ipa-4-9:
https://pagure.io/freeipa/c/195035cef51a132b2b80df57ed50f2fe620244e6

Comment 8 Sudhir Menon 2021-07-30 07:59:38 UTC
Marking the bug as Verified.
ipa-server-4.9.6-4.module+el8.5.0+11912+1b4496cf.x86_64
ipa-client-4.9.6-4.module+el8.5.0+11912+1b4496cf.x86_64

Comment 10 errata-xmlrpc 2021-11-09 18:29:22 UTC
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory (ipa bug fix and enhancement update), and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHBA-2021:4230