No edit summary |
No edit summary |
||
(10 intermediate revisions by 3 users not shown) | |||
Line 9: | Line 9: | ||
== Summary == | == Summary == | ||
Integrate SSSD and autofs for looking up automounter data stored in | Integrate SSSD and autofs for looking up automounter data stored in centralized remote directories such as LDAP. | ||
<!-- A sentence or two summarizing what this feature is and what it will do. This information is used for the overall feature summary page for each release. --> | <!-- A sentence or two summarizing what this feature is and what it will do. This information is used for the overall feature summary page for each release. --> | ||
Line 15: | Line 15: | ||
<!--This should link to your home wiki page so we know who you are--> | <!--This should link to your home wiki page so we know who you are--> | ||
* Name: [[User:jhrozek| Jakub Hrozek]] | * Name: [[User:jhrozek| Jakub Hrozek]] | ||
* Email: <jhrozek@redhat.com> | |||
* Name: [[User:iankent| Ian Kent]] | |||
* Email: <ikent@redhat.com> | |||
<!-- Include you email address that you can be reached should people want to contact you about helping with your feature, status is requested, or technical issues need to be resolved--> | <!-- Include you email address that you can be reached should people want to contact you about helping with your feature, status is requested, or technical issues need to be resolved--> | ||
== Current status == | == Current status == | ||
* Targeted release: [[Releases/17 | Fedora 17 ]] | * Targeted release: [[Releases/17 | Fedora 17 ]] | ||
* Last updated: | * Last updated: 2012-02-09 | ||
* Percentage of completion: | * Percentage of completion: 100% | ||
** | ** sssd-1.8.0-1.fc17.beta1 | ||
** autofs-5.0.6-11.fc17 | |||
<!-- CHANGE THE "FedoraVersion" TEMPLATES ABOVE TO PLAIN NUMBERS WHEN YOU COMPLETE YOUR PAGE. --> | <!-- CHANGE THE "FedoraVersion" TEMPLATES ABOVE TO PLAIN NUMBERS WHEN YOU COMPLETE YOUR PAGE. --> | ||
Line 55: | Line 57: | ||
== How To Test == | == How To Test == | ||
# configure the | # configure an autofs map stored in LDAP. This would do the trick on an IPA server: | ||
## configure SSSD with an LDAP back end as described in the SSSD documentation (sssd.conf) | ## <code>ipa automountlocation-add Brno</code> | ||
## configure autofs to perform lookups via SSSD | ## <code>ipa automountmap-add Brno auto.share</code> | ||
## <code>ipa automountkey-add Brno auto.master --key=/share --info=auto.share</code> | |||
## <code>ipa automountkey-add Brno auto.share --key=mirror --info="my.nfs.server:/export/"</code> | |||
# configure SSSD with an LDAP back end as described in the SSSD documentation (sssd.conf) | |||
## append <code>autofs</code> to the "services" line in the <code>sssd</code> section | |||
## create am <code>[autofs]</code> section | |||
## specify the correct search base with the <code>ldap_autofs_search_base</code> option | |||
## restart the SSSD | |||
# configure autofs to perform lookups via SSSD | |||
## put "sss" at the <code>automount</code> line in <code>nsswitch.conf</code> | |||
## restart the automount service | |||
# test that mounting shares still works as expected | # test that mounting shares still works as expected | ||
## cd /share/mirror should work with the above configuration | |||
## perform the first mount while the LDAP server is running in order to cache the data on the client side | ## perform the first mount while the LDAP server is running in order to cache the data on the client side | ||
## stop the LDAP service that contains the maps. SSSD would serve the maps from cache and mounting shares should still work | ## stop the LDAP service that contains the maps. SSSD would serve the maps from cache and mounting shares should still work | ||
Line 90: | Line 103: | ||
A design document is available at the [https://fedorahosted.org/sssd/wiki/DesignDocs/AutofsIntegration SSSD wiki]. An in-depth discussion also happened in the [https://bugzilla.redhat.com/show_bug.cgi?id=683523 Red Hat Bugzilla]. | A design document is available at the [https://fedorahosted.org/sssd/wiki/DesignDocs/AutofsIntegration SSSD wiki]. An in-depth discussion also happened in the [https://bugzilla.redhat.com/show_bug.cgi?id=683523 Red Hat Bugzilla]. | ||
The options are documented in the <code>sssd-ldap</code> manual page. User-facing documentation along with instruction on migrating the setup from | |||
plain LDAP lookup module to the <code>sss</code> lookup module is available in [http://jhrozek.livejournal.com/2500.html a blog post] | |||
<!-- Is there upstream documentation on this feature, or notes you have written yourself? Link to that material here so other interested developers can get involved. --> | <!-- Is there upstream documentation on this feature, or notes you have written yourself? Link to that material here so other interested developers can get involved. --> | ||
Line 102: | Line 116: | ||
[[Category: | [[Category:FeatureAcceptedF17]] | ||
<!-- When your feature page is completed and ready for review --> | <!-- When your feature page is completed and ready for review --> | ||
<!-- remove Category:FeaturePageIncomplete and change it to Category:FeatureReadyForWrangler --> | <!-- remove Category:FeaturePageIncomplete and change it to Category:FeatureReadyForWrangler --> | ||
<!-- After review, the feature wrangler will move your page to Category:FeatureReadyForFesco... if it still needs more work it will move back to Category:FeaturePageIncomplete--> | <!-- After review, the feature wrangler will move your page to Category:FeatureReadyForFesco... if it still needs more work it will move back to Category:FeaturePageIncomplete--> | ||
<!-- A pretty picture of the page category usage is at: https://fedoraproject.org/wiki/Features/Policy/Process --> | <!-- A pretty picture of the page category usage is at: https://fedoraproject.org/wiki/Features/Policy/Process --> |
Latest revision as of 16:11, 1 May 2012
Feature Name
SSSD AutoFS Integration
Summary
Integrate SSSD and autofs for looking up automounter data stored in centralized remote directories such as LDAP.
Owner
- Name: Jakub Hrozek
- Email: <jhrozek@redhat.com>
- Name: Ian Kent
- Email: <ikent@redhat.com>
Current status
- Targeted release: Fedora 17
- Last updated: 2012-02-09
- Percentage of completion: 100%
- sssd-1.8.0-1.fc17.beta1
- autofs-5.0.6-11.fc17
Detailed Description
Autofs is able to look up maps stored in LDAP. However, autofs currently performs all the lookups on its own. Even though autofs uses the nsswitch.conf configuration file, there is no glibc interface such as those for retreiving users and groups and by extension no nscd caching.
The goal of this feature is integrate autofs and SSSD in a more centralized manner in order to perform the lookups through SSSD. SSSD would provide access to the remote directory, while autofs would leverage all the benefits SSSD brings over performing the lookups in autofs directly (see below for more details).
Benefit to Fedora
The benefits of the integration are:
- unified configuration of LDAP parameters such as the servers used, timeout options and security properties at one places (sssd.conf)
- autofs would take advantage of the advanced features SSSD has such as server fail over, server discovery using DNS SRV lookups and more
- only one connection to the LDAP server open at a time resulting in less load on the LDAP server and better performance
- caching of the data - again, less load on the LDAP server and better performance on the client side as the client wouldn't have to go to the server with each request
- offline access - even though if the client cannot connect to the LDAP server chances are that the NFS server is unreachable as well
- back end abstraction - data may be stored in NIS or other databases and accessed by the automounter transparently
Scope
This feature needs work on both the SSSD side and autofs side. A very detailed design document is available on the SSSD wiki
- The autofs developers need to create a new autofs lookup module that would be specific to SSSD. Autofs implements one lookup module per each information source and provides access to the infromation source - there is a module for plain files, a module for LDAP etc. The lookup module would load the libnss_sss library and use the API provided there to fetch data from SSSD transparently.
- SSSD developers need to provide the API in the libnss_sss library and corresponding code for actually downloading the data from remote directories and and storing the data into SSSD cache on the back end side of SSSD.
How To Test
- configure an autofs map stored in LDAP. This would do the trick on an IPA server:
ipa automountlocation-add Brno
ipa automountmap-add Brno auto.share
ipa automountkey-add Brno auto.master --key=/share --info=auto.share
ipa automountkey-add Brno auto.share --key=mirror --info="my.nfs.server:/export/"
- configure SSSD with an LDAP back end as described in the SSSD documentation (sssd.conf)
- append
autofs
to the "services" line in thesssd
section - create am
[autofs]
section - specify the correct search base with the
ldap_autofs_search_base
option - restart the SSSD
- append
- configure autofs to perform lookups via SSSD
- put "sss" at the
automount
line innsswitch.conf
- restart the automount service
- put "sss" at the
- test that mounting shares still works as expected
- cd /share/mirror should work with the above configuration
- perform the first mount while the LDAP server is running in order to cache the data on the client side
- stop the LDAP service that contains the maps. SSSD would serve the maps from cache and mounting shares should still work
User Experience
The user would benefit from centralizing the LDAP configuration at one place, including advanced features that were not available before such as server fail over or DNS SRV lookups. The user would also likely notice better performance due to caching support and better load on the LDAP server because SSSD only opens a single connection at a time. In case the LDAP server is not reachable, the user would leverage the offline support SSSD provides.
Dependencies
As stated above, this feature depends on changes in both autofs and SSSD. There are no other external dependencies.
Contingency Plan
None required, Fedora would keep using the LDAP lookup module in autofs.
Documentation
A design document is available at the SSSD wiki. An in-depth discussion also happened in the Red Hat Bugzilla.
The options are documented in the sssd-ldap
manual page. User-facing documentation along with instruction on migrating the setup from
plain LDAP lookup module to the sss
lookup module is available in a blog post
Release Notes
Fedora 17 integrates autofs with SSSD, bringing caching support, offline access to the automounter maps and centralized configuration of autofs LDAP lookups in sssd.conf. By perfoming the automounter lookups via SSSD, the system also opens only one connection to the LDAP server and answers some requests from cache, which results in better performance.