theforeman/foreman · error · ProxyException

Unable to set TFTP boot entry for %s

Error message

Unable to set TFTP boot entry for %s

What it means

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

Source

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

    def initialize(args)
      @url = args[:url] + "/tftp"
      super args
    end

    # Creates a TFTP boot entry
    # [+kind+] : PXE template kind
    # [+mac+]  : MAC address
    # [+args+] : Hash containing
    #    :pxeconfig => String containing the configuration
    #    :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)

View on GitHub (pinned to 6b05625475)

When it happens

Trigger: Thrown at app/services/proxy_api/tftp.rb:21 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/57db94b874e67a99. Report an issue: GitHub.