theforeman/foreman · error · ProxyException

Unable to delete TFTP boot entry for %s

Error message

Unable to delete TFTP boot entry for %s

What it means

Error "Unable to delete TFTP boot entry for %s" thrown in theforeman/foreman.

Source

Thrown at app/services/proxy_api/tftp.rb:31

    #    :targetos  => String containing the lowercase operating system name
    #    :release  => String containing the operating system major and minor version
    #    :arch  => String containing the operating system architecture
    #    :bootfile_suffix => String containing the architecture specific boot filename suffix
    # Returns  : Boolean status
    def set(kind, mac, args)
      parse(post(args, "#{kind}/#{mac}"))
    rescue => e
      raise ProxyException.new(url, e, N_("Unable to set TFTP boot entry for %s"), mac)
    end

    # Deletes a TFTP boot entry
    # [+kind+] : PXE template kind
    # [+mac+] : String in coloned sextuplet format
    # Returns : Boolean status
    def delete(kind, mac)
      parse(super("#{kind}/#{mac}"))
    rescue => e
      raise ProxyException.new(url, e, N_("Unable to delete TFTP boot entry for %s"), mac)
    end

    # Requests that the proxy download the bootfile from the media's source
    # [+args+] : Hash containing
    #   :prefix => String containing the location within the TFTP tree to store the file
    #   :path   => String containing the URL of the file to download
    # Returns    : Boolean status
    def fetch_boot_file(args)
      parse(post(args, "fetch_boot_file"))
    rescue => e
      raise ProxyException.new(url, e, N_("Unable to fetch TFTP boot file"))
    end

    # returns the TFTP boot server for this proxy
    def bootServer
      if (response = parse(get("serverName"))) && response["serverName"].present?
        return response["serverName"]
      end

View on GitHub (pinned to 6b05625475)

When it happens

Trigger: Thrown at app/services/proxy_api/tftp.rb:31 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/0d108cc5be8d5fbc. Report an issue: GitHub.