From 855d8250d962926b33b4d8e2b0738d66eff17fd9 Mon Sep 17 00:00:00 2001 From: Gavin Henry Date: Tue, 14 Aug 2007 23:06:03 +0000 Subject: [PATCH] Fixes and more content --- doc/guide/admin/backends.sdf | 6 ++--- doc/guide/admin/maintenance.sdf | 4 ++++ doc/guide/admin/overlays.sdf | 6 ++--- doc/guide/admin/troubleshooting.sdf | 34 ++++++++++++++++++++++++++++- 4 files changed, 42 insertions(+), 8 deletions(-) diff --git a/doc/guide/admin/backends.sdf b/doc/guide/admin/backends.sdf index d47b74d116..ae2773c486 100644 --- a/doc/guide/admin/backends.sdf +++ b/doc/guide/admin/backends.sdf @@ -237,11 +237,9 @@ an RDBMS, and want to use modern solutions that expect such information in LDAP distribute information between different sites/applications that use RDBMSes and/or LDAP. Or whatever else... -It is NOT designed as a general-purpose backend that uses RDBMS instead of +It is {{B:NOT}} designed as a general-purpose backend that uses RDBMS instead of BerkeleyDB (as the standard BDB backend does), though it can be used as such with -several limitations. You can take a look at {{URL:http://www.openldap.org/faq/index.cgi?file=378}} - (OpenLDAP FAQ-O-Matic/General LDAP FAQ/Directories vs. conventional databases) - to find out more on this point. +several limitations. Please see {{SECT: LDAP vs RDBMS}} for discussion. The idea is to use some meta-information to translate LDAP queries to SQL queries, leaving relational schema untouched, so that old applications can continue using diff --git a/doc/guide/admin/maintenance.sdf b/doc/guide/admin/maintenance.sdf index 0680c04eca..7ed638fb55 100644 --- a/doc/guide/admin/maintenance.sdf +++ b/doc/guide/admin/maintenance.sdf @@ -103,4 +103,8 @@ minutes have passed since the checkpoint. This has been modified in 2.3 to indeed checkpoint every so often; in the meantime a workaround is to invoke "db_checkpoint" from a cron script every so often, say 5 minutes. +H2: Migration + +Exporting to a new system...... + diff --git a/doc/guide/admin/overlays.sdf b/doc/guide/admin/overlays.sdf index 36f78b195f..936102604e 100644 --- a/doc/guide/admin/overlays.sdf +++ b/doc/guide/admin/overlays.sdf @@ -24,7 +24,7 @@ Essentially they represent a means to: Overlays are usually documented by separate specific man pages in section 5; the naming convention is - slapo- +> slapo- Not all distributed overlays have a man page yet. Feel free to contribute one, if you think you well understood the behavior of the component and the @@ -32,7 +32,7 @@ implications of all the related configuration directives. Official overlays are located in - servers/slapd/overlays/ +> servers/slapd/overlays/ That directory also contains the file slapover.txt, which describes the rationale of the overlay implementation, and may serve as guideline for the @@ -40,7 +40,7 @@ development of custom overlays. Contribware overlays are located in - contrib/slapd-modules// +> contrib/slapd-modules// along with other types of run-time loadable components; they are officially distributed, but not maintained by the project. diff --git a/doc/guide/admin/troubleshooting.sdf b/doc/guide/admin/troubleshooting.sdf index fdfce7d3e3..5449003aa7 100644 --- a/doc/guide/admin/troubleshooting.sdf +++ b/doc/guide/admin/troubleshooting.sdf @@ -11,10 +11,42 @@ Browse the list archives at {{URL:http://www.openldap.org/lists/}} Chances are the problem has been solved and explained in detail many times before. +H2: User or Software errors? + +More often than not, an error is caused by a configuration problem or a misunderstanding +of what you are trying to implement and/or achieve. + +Sometimes you may encounter an actual OpenLDAP bug, in which case please visit +our Issue Tracking system {{URL:http://www.openldap.org/its/}} and report it there, +providing as much information as possible. + +Note: Our Issue Tracking system is {{B:NOT}} for OpenLDAP {{B:Support}}, please join our +mailing Lists: {{URL:http://www.openldap.org/lists/}} for that + +We will now attempt to discuss common user errors + H2: Checklist +The following checklist can help track down your problem. Please try to use if {{B:before}} +posting to the list, or in the rare circumstances of reporting a bug. -H2: User or Software errors? +.{{S: }} +^{{B: Is {{slapd}} running?}} + +.{{S: }} ++{{B: Can you issue an {{ldapsearch}}?}} + +.{{S: }} ++{{B: If not, have you enabled complex ACLs without fully understanding them?}} + +.{{S: }} ++{{B: Do you have a system wide LDAP setting pointing to the wrong LDAP Directory?}} + +.{{S: }} ++{{B: Are you using TLS?}} + +.{{S: }} ++{{B: Have your certificates expired?}} H2: 3rd party software error -- 2.39.5