Bug 973809

Summary:	oo-admin-clear-pending-ops has no man page or indication what it's for
Product:	OpenShift Container Platform	Reporter:	Luke Meyer <lmeyer>
Component:	Node	Assignee:	Luke Meyer <lmeyer>
Status:	CLOSED CURRENTRELEASE	QA Contact:	libra bugs <libra-bugs>
Severity:	low	Docs Contact:
Priority:	unspecified
Version:	1.2.0	CC:	bleanhar, gpei, jdetiber, libra-onpremise-devel
Target Milestone:	---
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:	Cause: oo-admin-clear-pending-ops was missing a man page. Consequence: Administrators would not know how to use this tool without consulting the source. Fix: Man page added. Result: Better documentation.	Story Points:	---
Clone Of:
Clones:	977929 (view as bug list)		Environment:
Last Closed:	2014-02-04 14:28:27 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:	977929

Description Luke Meyer 2013-06-12 19:44:19 UTC

Description of problem:
oo-admin-clear-pending-ops is described internally but not documented for our users.

Expected results:
man oo-admin-clear-pending-ops should tell us how to use it and what it's for.
oo-admin-clear-pending-ops -h should tell us what it's for.

Might be a good idea to mention it in the Troubleshooting Guide too.

Comment 3 Jason DeTiberus 2013-06-25 15:25:48 UTC

All broker-util scripts in need of manpages:
  /usr/sbin/oo-admin-clear-pending-ops
  /usr/sbin/oo-admin-ctl-authorization
  /usr/sbin/oo-analytics-export
  /usr/sbin/oo-analytics-import

Comment 4 Luke Meyer 2013-07-24 01:23:21 UTC

https://github.com/openshift/enterprise-server/pull/114

from origin-server/master:

commit 4b4a3e68fe7e0cc41a1f90bea722f7a5bfd3a2dd
Author: Luke Meyer <lmeyer>
Date:   Mon Jul 22 14:02:16 2013 -0400

    <oo-admin-clear-pending-ops> man page added

Comment 6 Gaoyun Pei 2013-07-25 06:43:55 UTC

Verify this bug on puddle 1.2/2013-07-24.2 for the manpage has been added for command "oo-admin-clear-pending-ops", "oo-auto-idler".