Bug 742361 - ping CLI has no help or documentation
Summary: ping CLI has no help or documentation
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Red Hat Enterprise Linux 6
Classification: Red Hat
Component: ipa
Version: 6.1
Hardware: Unspecified
OS: Unspecified
medium
unspecified
Target Milestone: rc
: ---
Assignee: Rob Crittenden
QA Contact: IDM QE LIST
URL:
Whiteboard:
Depends On:
Blocks: 756082
TreeView+ depends on / blocked
 
Reported: 2011-09-29 20:21 UTC by Jenny Severance
Modified: 2012-06-20 13:14 UTC (History)
2 users (show)

Fixed In Version: ipa-2.2.0-1.el6
Doc Type: Bug Fix
Doc Text:
No documentation needed.
Clone Of:
Environment:
Last Closed: 2012-06-20 13:14:21 UTC
Target Upstream Version:

Attachments (Terms of Use)
Add an attachment (proposed patch, testcase, etc.)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Product Errata RHBA-2012:0819 0 normal SHIPPED_LIVE ipa bug fix and enhancement update 2012-06-19 20:34:17 UTC

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
Note You need to log in before you can comment on or make changes to this bug.