theforeman/foreman · error · ProxyAPI::ProxyException

Unable to retrieve DHCP entry for %s

Error message

Unable to retrieve DHCP entry for %s

What it means

Error "Unable to retrieve DHCP entry for %s" thrown in theforeman/foreman.

Source

Thrown at app/services/proxy_api/dhcp.rb:56

      raise ProxyException.new(url, e, N_("Unable to retrieve unused IP"))
    end

    # Retrieves a DHCP entry for a mac
    # [+subnet+] : String in dotted decimal format
    # [+mac+]    : String in coloned sextuplet format
    # Returns    : Hash or false
    def record(subnet, mac)
      response = parse(get("#{subnet}/mac/#{mac}"))
      attrs = response.merge(:network => subnet, :proxy => self)
      if response.keys.grep(/Sun/i).empty?
        Net::DHCP::Record.new attrs
      else
        Net::DHCP::SparcRecord.new attrs
      end
    rescue RestClient::ResourceNotFound
      nil
    rescue => e
      raise ProxyException.new(url, e, N_("Unable to retrieve DHCP entry for %s"), mac)
    end

    # Retrieves an array of DHCP entries
    # [+subnet+] : String in dotted decimal format
    # [+ip+]    : ip address
    # Returns    : Hash or false
    def records_by_ip(subnet, ip)
      response = parse(get("#{subnet}/ip/#{ip}"))
      response.map do |entry|
        attrs = entry.merge(:network => subnet, :proxy => self)
        if entry.keys.grep(/Sun/i).empty?
          Net::DHCP::Record.new attrs
        else
          Net::DHCP::SparcRecord.new attrs
        end
      end
    rescue RestClient::ResourceNotFound
      nil

View on GitHub (pinned to 6b05625475)

When it happens

Trigger: Thrown at app/services/proxy_api/dhcp.rb:56 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of theforeman/foreman@6b05625475 (2026-08-23). Data as JSON: /api/errors/3ab7b62ff3da71d8. Report an issue: GitHub.