puppetlabs/puppet · error · Puppet::Error

Could not set up LDAP Connection: Missing ruby/ldap librarie

Error message

Could not set up LDAP Connection: Missing ruby/ldap libraries

What it means

Error "Could not set up LDAP Connection: Missing ruby/ldap libraries" thrown in puppetlabs/puppet.

Source

Thrown at lib/puppet/util/ldap/connection.rb:39

    options[:ssl] = ssl
    user = Puppet.settings[:ldapuser]
    if user && user != ""
      options[:user] = user
      pass = Puppet.settings[:ldappassword]
      if pass && pass != ""
        options[:password] = pass
      end
    end

    new(Puppet[:ldapserver], Puppet[:ldapport], options)
  end

  def close
    connection.unbind if connection.bound?
  end

  def initialize(host, port, user: nil, password: nil, reset: nil, ssl: nil)
    raise Puppet::Error, _("Could not set up LDAP Connection: Missing ruby/ldap libraries") unless Puppet.features.ldap?

    @host = host
    @port = port
    @user = user
    @password = password
    @reset = reset
    @ssl = ssl
  end

  # Create a per-connection unique name.
  def name
    [host, port, user, password, ssl].collect(&:to_s).join("/")
  end

  # Should we reset the connection?
  def reset?
    reset
  end

View on GitHub (pinned to e227c27540)

When it happens

Trigger: Thrown at lib/puppet/util/ldap/connection.rb:39 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of puppetlabs/puppet@e227c27540 (2026-08-21). Data as JSON: /api/errors/2f0f2768ce1bf6ce. Report an issue: GitHub.