git.sur5r.net Git - openldap/blob - doc/guide/admin/troubleshooting.sdf

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