Skip to content

Technical Reference

Infrastructure & OS Requirements

  • Operating Systems: Requires a supported operating system and runtime environment for KNIME Analytics Platform (see KNIME Analytics Platform documentation). macOS is not supported.
  • KNIME Version: Requires KNIME Analytics Platform 5.8.1 or later with KNIME Executor Connector and KNIME Remote Workflow Editor for Executor extensions.
  • Dependencies: Requires libraries for the CEF browser component (see Equo documentation).

Networking & Firewall Specifications

Remote executors establish an outbound connection; no inbound connection is required.

  • Port: TCP 443 (https and wss).
  • Required Endpoints:
    • <hub-domain>
    • api.<hub-domain>
    • ws.<hub-domain>
    • storage.<hub-domain>

System States & Status Definitions

  • Execution Context States:

    • Not configured: No executor added.
    • Running: At least one executor is running.
    • Stopped: All executors are offline.
    • At full capacity: Executors are busy or at concurrency limits.
    • Disabled: Context has been disabled and cannot be used.
  • Remote Executor States:

    • Running: Running and connected to Hub.
    • Offline: Disconnected (network issue or machine shutdown).
    • At full capacity: Busy and not accepting new jobs.

Licensing & vCore Calculations

  • Calculation: Bare-metal executors use all visible CPU cores. Hyperthreading is calculated as two vCores per physical core.
  • Limits: Registration fails if the CPU count exceeds available license capacity or team vCore limits.
  • Control: vCore usage can be limited via container constraints (Docker) or Linux cgroups.

Executor Agent CLI

  • configure: Interactive process to link the agent to a Hub URL and token.
  • start: Launches the agent process.
  • --executor: Flag used during configuration to point to the KNIME installation directory (containing knime.ini).