2010-07-26 16:54:38 -05:00
|
|
|
# Authors:
|
|
|
|
# Rob Crittenden <rcritten@redhat.com>
|
|
|
|
#
|
|
|
|
# Copyright (C) 2010 Red Hat
|
|
|
|
# see file 'COPYING' for use and warranty information
|
|
|
|
#
|
2010-12-09 06:59:11 -06:00
|
|
|
# This program is free software; you can redistribute it and/or modify
|
|
|
|
# it under the terms of the GNU General Public License as published by
|
|
|
|
# the Free Software Foundation, either version 3 of the License, or
|
|
|
|
# (at your option) any later version.
|
2010-07-26 16:54:38 -05:00
|
|
|
#
|
|
|
|
# This program is distributed in the hope that it will be useful,
|
|
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
# GNU General Public License for more details.
|
|
|
|
#
|
|
|
|
# You should have received a copy of the GNU General Public License
|
2010-12-09 06:59:11 -06:00
|
|
|
# along with this program. If not, see <http://www.gnu.org/licenses/>.
|
2010-07-26 16:54:38 -05:00
|
|
|
|
|
|
|
from ipalib import Command
|
|
|
|
from ipalib import output
|
2015-12-16 09:06:03 -06:00
|
|
|
from ipalib import _
|
2013-08-01 07:55:10 -05:00
|
|
|
from ipalib.plugable import Registry
|
2011-01-13 13:29:16 -06:00
|
|
|
from ipapython.version import VERSION, API_VERSION
|
2010-07-26 16:54:38 -05:00
|
|
|
|
2011-08-24 21:48:30 -05:00
|
|
|
__doc__ = _("""
|
2012-01-12 17:16:01 -06:00
|
|
|
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
|
2013-06-06 01:34:13 -05:00
|
|
|
ipa: INFO: Forwarding 'ping' to server 'https://ipa.example.com/ipa/xml'
|
2012-01-12 17:16:01 -06:00
|
|
|
-----------------------------------------------------
|
|
|
|
IPA server version 2.1.9. API version 2.20
|
|
|
|
-----------------------------------------------------
|
2011-08-24 21:48:30 -05:00
|
|
|
""")
|
|
|
|
|
2013-08-01 07:55:10 -05:00
|
|
|
register = Registry()
|
|
|
|
|
|
|
|
|
|
|
|
@register()
|
2010-07-26 16:54:38 -05:00
|
|
|
class ping(Command):
|
2011-08-24 21:48:30 -05:00
|
|
|
__doc__ = _('Ping a remote server.')
|
|
|
|
|
2010-07-26 16:54:38 -05:00
|
|
|
has_output = (
|
|
|
|
output.summary,
|
|
|
|
)
|
|
|
|
|
2012-06-21 07:20:26 -05:00
|
|
|
def execute(self, **options):
|
2010-07-26 16:54:38 -05:00
|
|
|
"""
|
|
|
|
A possible enhancement would be to take an argument and echo it
|
|
|
|
back but a fixed value works for now.
|
|
|
|
"""
|
2011-01-13 13:29:16 -06:00
|
|
|
return dict(summary=u'IPA server version %s. API version %s' % (VERSION, API_VERSION))
|