Bug 1031796

Summary: oo-admin-repair-node,oo-admin-ctl-iptables-port-proxy and oo-admin-ctl-tc has no man page
Product: OKD Reporter: Brenton Leanhardt <bleanhar>
Component: ContainersAssignee: Brenton Leanhardt <bleanhar>
Status: CLOSED EOL QA Contact: libra bugs <libra-bugs>
Severity: low Docs Contact:
Priority: low    
Version: 2.xCC: jialiu, pruan, rthrashe, sdodson, xtian
Target Milestone: ---   
Target Release: 2.x   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
: 1314535 (view as bug list) Environment:
Last Closed: 2017-01-25 06:37:58 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: 1314535    

Description Brenton Leanhardt 2013-11-18 19:16:54 UTC
Description of problem:

oo-admin-repair-node is part of the openshift-origin-node-util package and is missing a man page.

Comment 1 Brenton Leanhardt 2013-11-18 19:40:10 UTC
oo-admin-ctl-iptables-port-proxy and oo-admin-ctl-tc are also missing man pages.  They are part of rubygem-openshift-origin-node.

Comment 2 Brenton Leanhardt 2015-03-20 17:33:32 UTC
/usr/sbin/oo-admin-regenerate-gear-metadata

Comment 3 Jhon Honce 2015-06-25 01:37:19 UTC
Fixed in https://github.com/openshift/origin-server/pull/6178

Comment 4 openshift-github-bot 2015-06-29 17:48:56 UTC
Commit pushed to master at https://github.com/openshift/origin-server

https://github.com/openshift/origin-server/commit/7fd24067c2ddf3aa5cd4cdc2a193cd7b61568a14
Bug 1031796 - Install missing man pages

* oo-admin-regenerate-gear-metadata.8, oo-admin-repair-node.8
  oo-admin-ctl-tc.8 and oo-admin-ctl-iptables-port-proxy.8

Comment 5 Peter Ruan 2015-09-23 16:33:38 UTC
[root@broker ~]# man oo-admin-ctl-iptables-port-proxy
No manual entry for oo-admin-ctl-iptables-port-proxy
[root@broker ~]# man oo-admin-ctl-tc
No manual entry for oo-admin-ctl-tc

oo-admin-repair-node manpage exists

Comment 6 Peter Ruan 2015-09-23 16:51:33 UTC
The manage exists in devenv, but not in the latest OSE installation.  Will need to cherry-pick and sync up

Comment 7 Rory Thrasher 2016-02-08 16:36:50 UTC
QA,

Can we check to see if these changes are present in the latest 2.2.8 build?  We're looking to see if this may need to be cherry-picked for 2.2.9.

Thanks.

Comment 9 Johnny Liu 2016-02-26 07:02:30 UTC
Re-test this bug with OpenShiftEnterpriseErrata/2.2/2016-02-25.2, only a part of bug is fixed..


[root@node1 ~]# man oo-admin-ctl-iptables-port-proxy
No manual entry for oo-admin-ctl-iptables-port-proxy
[root@node1 ~]# man oo-admin-ctl-tc 
No manual entry for oo-admin-ctl-tc
[root@node1 ~]# rpm -qf /usr/sbin/oo-admin-ctl-tc
rubygem-openshift-origin-node-1.38.5.2-1.el6op.noarch

oo-admin-repair-node and oo-admin-regenerate-gear-metadata man page are existing now.

Comment 10 openshift-github-bot 2016-02-26 22:46:49 UTC
Commit pushed to master at https://github.com/openshift/origin-server

https://github.com/openshift/origin-server/commit/c6cf7cfdebe40a77258e4a1f73adff640b586df4
Updates _mandir to properly add node man pages

Bug 1031796
BZ: https://bugzilla.redhat.com/show_bug.cgi?id=1031796

Updates _mandir to _root_mandir in the node .spec file.  The node uses SCL, so
_mandir would incorrectly put the man pages into
/opt/rh/ruby193/root/user/share/man instead of into /usr/share/man, which would
require users to enable SCL to update the $MANPATH.  The node will now add the
man pages to the correct location.

Comment 11 Rory Thrasher 2016-05-02 20:00:22 UTC
QA,

This has been separately verified for Enterprise, so can we check for the presence of these man pages in an online setup?

# man oo-admin-ctl-iptables-port-proxy
# man oo-admin-ctl-tc
# man oo-admin-regenerate-gear-metadata
# man oo-admin-repair-node

Thank you