Bug 1330843

Summary: 'man ipa' should be updated with latest commands
Product: Red Hat Enterprise Linux 7 Reporter: Sudhir Menon <sumenon>
Component: ipaAssignee: IPA Maintainers <ipa-maint>
Status: CLOSED ERRATA QA Contact: Kaleem <ksiddiqu>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 7.2CC: akasurde, mbasti, pvoborni, rcritten
Target Milestone: rc   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: ipa-4.4.0-0.el7.1.alpha1 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-11-04 05:53:34 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:

Description Sudhir Menon 2016-04-27 06:41:51 UTC 
Description of problem:'man ipa' should be updated with latest commands

Version-Release number of selected component (if applicable):

How reproducible: Always


Steps to Reproduce:
1. On RHEL7.2 ipa setup, run 'man ipa'

Actual results:

1. ipa user-find --uuid 936407bd-da9b-11de-9abd-54520012e7cd

[root@host2 ~]#  ipa user-find --uuid 936407bd-da9b-11de-9abd-54520012e7cd
Usage: ipa [global-options] user-find [CRITERIA] [options]
ipa: error: no such option: --uuid

2. ipa-upgradeconfig
[root@host2 ~]# ipa-upgradeconfig 
Please run the 'ipa-server-upgrade' command to upgrade the IPA server.

3. ipa-host-net-manage
[root@host2 ~]# ipa-host-net-manage
bash: ipa-host-net-manage: command not found...

Expected results:
The man page should be updated and refer to latest/supported commands for the specific release rather than deprecated commands.

Update the SEE ALSO section

SEE ALSO
ipa-client-install(1), ipa-compat-manage(1), ipactl(1), ipa-dns-install(1), ipa-getcert(1), ipa-getkeytab(1), ipa-join(1), ipa-ldap-updater(1), ipa-nis-manage(1), ipa-replica-install(1), ipa-replica-manage(1), ipa-replica-prepare(1), ipa-rmkeytab(1),ipa-server-certinstall(2), ipa-server-install(1), ipa-upgradeconfig(1), ipa-host-net-manage(1)

Additional info: man ipa
Comment 2 Petr Vobornik 2016-05-03 15:27:35 UTC 
Upstream ticket:
https://fedorahosted.org/freeipa/ticket/5871
Comment 3 Martin Bašti 2016-05-03 15:42:10 UTC 
Fixed upstream
master:
https://fedorahosted.org/freeipa/changeset/7d46fd15f84ee31b4141ed3fc53b4ddb3fbe4167
ipa-4-3:
https://fedorahosted.org/freeipa/changeset/2c0c7bece2f90dba568a39db68b835e99ccbc9ba
Comment 5 Abhijeet Kasurde 2016-07-13 04:03:45 UTC 
IPA Version used to verify ::
ipa-server-4.4.0-1.el7.x86_64

Steps involved in verification ::

[root@server1 ~]# man ipa | grep 2016
IPA                                                 Apr 29 2016                                              ipa(1)
[root@server1 ~]# man ipa | grep uuid
[root@server1 ~]# echo $? 
1
[root@server1 ~]# man ipa |grep host-net-manage
[root@server1 ~]# echo $? 
1
[root@server1 ~]# rpm -q ipa-server
ipa-server-4.4.0-1.el7.x86_64


Man page reflects updates, hence marking bz as verified.
Comment 7 errata-xmlrpc 2016-11-04 05:53:34 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, 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://rhn.redhat.com/errata/RHBA-2016-2404.html