1# OpenLDAP: pkg/openldap-guide/admin/troubleshooting.sdf,v 1.10.2.7 2010/04/13 20:22:35 kurt Exp 2# Copyright 2007-2010 The OpenLDAP Foundation, All Rights Reserved. 3# COPYING RESTRICTIONS APPLY, see COPYRIGHT. 4 5H1: Troubleshooting 6 7If you're having trouble using OpenLDAP, get onto the 8OpenLDAP-Software mailing list, or: 9 10* Browse the list archives at {{URL:http://www.openldap.org/lists/#archives}} 11* Search the FAQ at {{URL:http://www.openldap.org/faq/}} 12* Search the Issue Tracking System at {{URL:http://www.openldap.org/its/}} 13 14Chances are the problem has been solved and explained in detail many times before. 15 16H2: User or Software errors? 17 18More often than not, an error is caused by a configuration problem or a misunderstanding 19of what you are trying to implement and/or achieve. 20 21We will now attempt to discuss common user errors. 22 23H2: Checklist 24 25The following checklist can help track down your problem. Please try to use if {{B:before}} 26posting to the list, or in the rare circumstances of reporting a bug. 27 28.{{S: }} 29^{{B: Use the {{slaptest}} tool to verify configurations before starting {{slapd}}}} 30 31.{{S: }} 32+{{B: Verify that {{slapd}} is listening to the specified port(s) (389 and 636, generally) before trying the {{ldapsearch}}}} 33 34.{{S: }} 35+{{B: Can you issue an {{ldapsearch}}?}} 36 37.{{S: }} 38+{{B: If not, have you enabled complex ACLs without fully understanding them?}} 39 40.{{S: }} 41+{{B: Do you have a system wide LDAP setting pointing to the wrong LDAP Directory?}} 42 43.{{S: }} 44+{{B: Are you using TLS?}} 45 46.{{S: }} 47+{{B: Have your certificates expired?}} 48 49H2: OpenLDAP Bugs 50 51Sometimes you may encounter an actual OpenLDAP bug, in which case please visit 52our Issue Tracking system {{URL:http://www.openldap.org/its/}} and report it. 53However, make sure it's not already a known bug or a common user problem. 54 55* bugs in historic versions of OpenLDAP will not be considered; 56* bugs in released versions that are no longer present in HEAD code, 57either because they have been fixed or because they no longer apply, 58will not be considered as well; 59* bugs in distributions of OpenLDAP software that are not related to the 60software as provided by OpenLDAP will not be considered; in those cases please 61refer to the distributor. 62 63Note: Our Issue Tracking system is {{B:NOT}} for OpenLDAP {{B:Support}}, please join our 64mailing Lists: {{URL:http://www.openldap.org/lists/}} for that. 65 66The information you should provide in your bug report is discussed in our FAQ-O-MATIC at 67{{URL:http://www.openldap.org/faq/data/cache/59.html}} 68 69H2: 3rd party software error 70 71The OpenLDAP Project only supports OpenLDAP software. 72 73You may however seek commercial support ({{URL:http://www.openldap.org/support/}}) or join 74the general LDAP forum for non-commercial discussions and information relating to LDAP at: 75{{URL:http://www.umich.edu/~dirsvcs/ldap/mailinglist.html}} 76 77 78H2: How to contact the OpenLDAP Project 79 80* Mailing Lists: {{URL:http://www.openldap.org/lists/}} 81* Project: {{URL: http://www.openldap.org/project/}} 82* Issue Tracking: {{URL:http://www.openldap.org/its/}} 83 84 85H2: How to present your problem 86 87 88H2: Debugging {{slapd}}(8) 89 90After reading through the above sections and before e-mailing the OpenLDAP lists, you 91might want to try out some of the following to track down the cause of your problems: 92 93* Loglevel stats (256) is generally a good first loglevel to try for getting 94 information useful to list members on issues 95* Running {{slapd -d -1}} can often track down fairly simple issues, such as 96 missing schemas and incorrect file permissions for the {{slapd}} user to things like certs 97* Check your logs for errors, as discussed at {{URL:http://www.openldap.org/faq/data/cache/358.html}} 98 99H2: Commercial Support 100 101The firms listed at {{URL:http://www.openldap.org/support/}} offer technical support services catering to OpenLDAP community. 102 103The listing of any given firm should not be viewed as an endorsement or recommendation of any kind, nor as otherwise indicating 104there exists a business relationship or an affiliation between any listed firm and the OpenLDAP Foundation or the OpenLDAP Project or its contributors. 105