Bug 874757

Summary:	oo-accept-broker usage statement does not match man page options
Product:	OpenShift Container Platform	Reporter:	Steve Reichard <sreichar>
Component:	Node	Assignee:	Luke Meyer <lmeyer>
Status:	CLOSED ERRATA	QA Contact:	libra bugs <libra-bugs>
Severity:	low	Docs Contact:
Priority:	low
Version:	1.2.0	CC:	bleanhar, lmeyer, scollier, xjia
Target Milestone:	---	Keywords:	Triaged
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2013-01-31 20:32:24 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:

Description Steve Reichard 2012-11-08 19:06:01 UTC

Description of problem:

oo-accept-broker -h only describe -h and -v while the man page also -d, -a, -s, and another -d.



(appears the DNS option can not be selected)

Version-Release number of selected component (if applicable):
[root@Abroker2 ~]# yum list installed openshift-origin-broker-util
Loaded plugins: product-id, rhnplugin, security, subscription-manager
Updating certificate-based repositories.
Unable to read consumer identity
Installed Packages
openshift-origin-broker-util.noarch                             1.0.4-1.el6op                              @openshift_infrastructure
[root@Abroker2 ~]# 



How reproducible:

very

Steps to Reproduce:
1.
2.
3.
  
Actual results:


Expected results:


Additional info:

Comment 1 Brenton Leanhardt 2012-11-09 13:40:54 UTC

This will be fixed shortly after 1.0.

Comment 3 Luke Meyer 2012-12-13 19:24:46 UTC

Should match now.

Comment 4 xjia 2012-12-17 10:26:11 UTC

oo-accept-broker usage statement still does not match man page options

Version:
OpenShiftEnterprise/1.1.x/2012-12-14.1/


Test:
[root@broker ~]# oo-accept-broker -h
usage: /usr/sbin/oo-accept-broker [-h] [-v]

  -h) help (print this message)
  -v) verbose - notify when each check begins
  -d) debug output - displays commands executed

[root@broker ~]# man oo-accept-broker > 1.txt ; cat 1.txt
oo-accept-broker(13 December 2012)          oo-accept-broker(13 December 2012)



NAME
       oo-accept-broker

SYNOPSIS
       oo-accept-broker [-hdv] [-a auth_service] [-s storage_service]
       [-d dns_service]


DESCRIPTION
       Verify an OpenShift broker is in in an known valid state, or "accepted"
       good state. This is most commonly run with no options on the broker.

OPTIONS
       -h     Display a simple help dialog.

       -v     Enable verbose output during the run of the script

       -d     Enable debugging mode (very verbose)

EXAMPLE
       $ oo-accept-broker

HINTS
       This command should return with the text ’PASS’ and return code 0, oth-
       erwise the reasons for failure will be output.

SEE ALSO
       oo-admin-ctl-district(8), oo-admin-move(8), oo-admin-chk(8), oo-accept-
       broker(8), oo-admin-ctl-app(8),  oo-admin-ctl-domain(8),  oo-admin-ctl-
       user(8), oo-register-dns(8)

AUTHOR
       Adam Miller <admiller> - man page written for OpenShift Ori-
       gin



                                            oo-accept-broker(13 December 2012)

Comment 5 Luke Meyer 2012-12-19 01:45:12 UTC

fixed with openshift-origin-broker-util-1.0.13-1.el6op

Comment 6 xjia 2012-12-19 08:39:28 UTC

Verify:

oo-accept-broker(18 December 2012)          oo-accept-broker(18 December 2012)



NAME
       oo-accept-broker

SYNOPSIS
       oo-accept-broker [-h] [-v] [-d]


DESCRIPTION
       Verify  an  OpenShift  broker  is in a known valid state, or "accepted"
       good state. This is most often run with no options on the broker.

OPTIONS
       -h     Display a simple usage message and exit.

       -v     Enable verbose (INFO) output during the run of the script

       -d     Enable debugging mode (display every command executed)

EXAMPLE
       $ oo-accept-broker

HINTS
       This command should finish with output ’PASS’ and return code 0; other-
       wise the reasons for failure will be printed.

SEE ALSO
       oo-admin-ctl-district(8), oo-admin-move(8), oo-admin-chk(8), oo-accept-
       broker(8), oo-admin-ctl-app(8),  oo-admin-ctl-domain(8),  oo-admin-ctl-
       user(8), oo-register-dns(8)

AUTHOR
       Adam Miller <admiller> - man page written for OpenShift Ori-
       gin



                                            oo-accept-broker(18 December 2012)


[root@broker ~]# oo-accept-broker -h
usage: /usr/sbin/oo-accept-broker [-h] [-v] [-d]

  -h) Display this simple usage message and exit.
  -v) Enable verbose (INFO) output during the run of the script
  -d) Enable debugging mode (display every command executed)


Version:

OSE 1.1.x/2012-12-18.1

Comment 8 errata-xmlrpc 2013-01-31 20:32:24 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.

http://rhn.redhat.com/errata/RHSA-2013-0220.html