Bug 742361

Summary:	ping CLI has no help or documentation
Product:	Red Hat Enterprise Linux 6	Reporter:	Jenny Severance <jgalipea>
Component:	ipa	Assignee:	Rob Crittenden <rcritten>
Status:	CLOSED ERRATA	QA Contact:	IDM QE LIST <seceng-idm-qe-list>
Severity:	unspecified	Docs Contact:
Priority:	medium
Version:	6.1	CC:	dpal, mkosek
Target Milestone:	rc
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:	ipa-2.2.0-1.el6	Doc Type:	Bug Fix
Doc Text:	No documentation needed.	Story Points:	---
Clone Of:		Environment:
Last Closed:	2012-06-20 13:14:21 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Bug Depends On:
Bug Blocks:	756082

Description Jenny Severance 2011-09-29 20:21:15 UTC

Description of problem:

ipa help returns a "ping" catagory

ipa help ping returns -

"Ping the remote IPA server"

<snip>
# ipa help ping
Ping the remote IPA server
</snip>

running ipa ping what does it mean?

# ipa ping
------------------------------------------
IPA server version 2.1.1. API version 2.11
------------------------------------------


Version-Release number of selected component (if applicable):
ipa-server-2.1.1-4.el6.x86_64

How reproducible:


Steps to Reproduce:
1.  see desciption
2.
3.
  
Actual results:
Do not know what this command is for or how to use it.

Expected results:
Not sure, because I don't know what it is for.

Additional info:

Comment 2 Martin Kosek 2011-09-30 11:43:15 UTC

Upstream ticket:
https://fedorahosted.org/freeipa/ticket/1903

Comment 3 Dmitri Pal 2011-09-30 19:20:42 UTC

Ping command is used to check if replicas are running. We can make help better.

Comment 6 Rob Crittenden 2012-01-13 03:57:26 UTC

Fixed upstream.

master: 64b0855e875bfbaf394ea625fe9f79162e9afd45

ipa-2-2: 16abf2a8c1dddee593acc64c480845397d1d1a7e

Comment 8 Jenny Severance 2012-03-07 21:15:47 UTC

verified ::

# ipa help ping
Ping the remote IPA server to ensure it is running.

The ping command sends an echo request to an IPA server. The server
returns its version information. This is used by an IPA client
to confirm that the server is available and accepting requests.

The server from xmlrpc_uri in /etc/ipa/default.conf is contacted first.
If it does not respond then the client will contact any servers defined
by ldap SRV records in DNS.

EXAMPLES:

 Ping an IPA server:
   ipa ping
   ------------------------------------------
   IPA server version 2.1.9. API version 2.20
   ------------------------------------------

 Ping an IPA server verbosely:
   ipa -v ping
   ipa: INFO: trying https://ipa.example.com/ipa/xml
   ipa: INFO: Forwarding 'ping' to server u'https://ipa.example.com/ipa/xml'
   -----------------------------------------------------
   IPA server version 2.1.9. API version 2.20
   -----------------------------------------------------

Topic commands:
  ping  Ping a remote server.


version :: 
ipa-server-2.2.0-3.el6.x86_64

Comment 9 Martin Kosek 2012-04-18 20:08:19 UTC

    Technical note added. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    New Contents:
No documentation needed.

Comment 11 errata-xmlrpc 2012-06-20 13:14:21 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/RHBA-2012-0819.html