From 66da80489c0114878043b40592c5f47d41eb0ffd Mon Sep 17 00:00:00 2001 From: Jakub Hrozek Date: Fri, 16 Apr 2010 17:58:52 +0200 Subject: Use service discovery in backends Integrate the failover improvements with our back ends. The DNS domain used in the SRV query is always the SSSD domain name. Please note that this patch changes the default value of ldap_uri from "ldap://localhost" to "NULL" in order to use service discovery with no server set. --- src/man/include/service_discovery.xml | 36 +++++++++++++++++++++++++++++++++++ src/man/sssd-ipa.5.xml | 4 ++++ src/man/sssd-krb5.5.xml | 5 +++++ src/man/sssd-ldap.5.xml | 20 ++++++++++++++++--- 4 files changed, 62 insertions(+), 3 deletions(-) create mode 100644 src/man/include/service_discovery.xml (limited to 'src/man') diff --git a/src/man/include/service_discovery.xml b/src/man/include/service_discovery.xml new file mode 100644 index 000000000..16d016eaf --- /dev/null +++ b/src/man/include/service_discovery.xml @@ -0,0 +1,36 @@ + + SERVICE DISCOVERY + + The service discovery feature allows back ends to automatically + find the appropriate servers to connect to using a special DNS + query. + + + Configuration + + If no servers are specified, the back end automatically + uses service discovery to try to find a server. Optionally, + the user may choose to use both fixed server addresses + and service discovery by inserting a special keyword, + _srv_, in the list of servers. The order + of preference is maintained. This feature is useful if, for + example, the user prefers to use service discovery whenever + possible, and fall back to a specific server when no servers + can be discovered using DNS. + + + + The domain name + + The name of the SSSD domain is used as the domain part of the + service discovery DNS query. + + + + See Also + + For more information on the service discovery mechanism, + refer to RFC 2782. + + + diff --git a/src/man/sssd-ipa.5.xml b/src/man/sssd-ipa.5.xml index d1ba1c526..103558b04 100644 --- a/src/man/sssd-ipa.5.xml +++ b/src/man/sssd-ipa.5.xml @@ -82,6 +82,8 @@ on failover and server redundancy, see the FAILOVER section. This is optional if autodiscovery is enabled. + For more information on service discovery, refer + to the the SERVICE DISCOVERY section. @@ -120,6 +122,8 @@ + + EXAMPLE diff --git a/src/man/sssd-krb5.5.xml b/src/man/sssd-krb5.5.xml index c291eca79..01f212d2a 100644 --- a/src/man/sssd-krb5.5.xml +++ b/src/man/sssd-krb5.5.xml @@ -72,6 +72,9 @@ see the FAILOVER section. An optional port number (preceded by a colon) may be appended to the addresses or hostnames. + If empty, service discovery is enabled - + for more information, refer to the + SERVICE DISCOVERY section. @@ -244,6 +247,8 @@ + + EXAMPLE diff --git a/src/man/sssd-ldap.5.xml b/src/man/sssd-ldap.5.xml index b79cbbc9a..c119e7f3f 100644 --- a/src/man/sssd-ldap.5.xml +++ b/src/man/sssd-ldap.5.xml @@ -61,9 +61,8 @@ Specifies the list of URIs of the LDAP servers to which SSSD should connect in the order of preference. Refer to the FAILOVER section for more information on failover and server redundancy. - - - Default: ldap://localhost + If not specified, service discovery is enabled. For more information, refer + to the SERVICE DISCOVERY section. @@ -632,12 +631,27 @@ + + ldap_dns_service_name (string) + + + Specifies the service name to use when service + discovery is enabled. + + + Default: ldap + + + + + + EXAMPLE -- cgit