KNIME-Analytics Platform Installation Guide
KNIME-Analytics Platform Installation Guide
Installation Guide
KNIME AG, Zurich, Switzerland
Version 5.2 (last updated on 2024-02-12)
Table of Contents
Installing KNIME Analytics Platform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Configuration settings and knime.ini file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Allocating memory in knime.ini file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Installing Extensions and Integrations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Updating KNIME Analytics Platform and Extensions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Update Sites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Default Update Sites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Adding External Update Sites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Adding Local Update Sites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Working with the Nightly Builds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Release notes and changelogs (KNIME Analytics Platform 5.2) . . . . . . . . . . . . . . . . . . . . . . . . 12
KNIME Analytics Platform 5.2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
KNIME Analytics Platform 5.2.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
KNIME Analytics Platform Installation Guide
◦ Register for Help and Updates: here you can optionally provide some personal
information and sign up to our mailing list to receive the latest KNIME news
◦ The Windows installer extracts the compressed installation folder, adds an icon to
your desktop, and suggests suitable memory settings.
◦ The zip archive can be downloaded, saved, and extracted in your preferred
location on a system to which you have full access rights.
4. Read and accept the privacy policy and terms and conditions. Then click Download.
5. Once downloaded, proceed with installing KNIME Analytics Platform:
◦ Linux: Extract the downloaded tarball to a location of your choice. Run the knime
executable to start KNIME Analytics Platform.
◦ Mac: Double click the downloaded dmg file and wait for the verification to finish.
Then move the KNIME icon to Applications. Double click the KNIME icon in the list
of applications to launch KNIME Analytics Platform.
• Windows
◦ Windows 10, 11
◦ Windows Server - 2016, 2019, 2022,
• Ubuntu 20.04 LTS and 22.04 LTS and derivatives
• RHEL/CentOS/Rocky Linux 8, 9
• macOS (12 and above - macOS x86_64 Intel) and M1 (macOS arm64 - Apple silicon)
(only the last two major versions are supported)
Also check the KNIME Getting Started Guide and the KNIME Analytics Platform
User Guide.
You can find knime.ini in the installation folder of KNIME Analytics Platform.
The knime.ini file can be edited with any plaintext editor, such as Notepad (Windows),
TextEdit (MacOS) or gedit (Linux).
The KNIME extensions and integrations developed and maintained by KNIME contain deep
learning algorithms provided by Keras, high performance machine learning provided by H2O,
big data processing provided by Apache Spark, and scripting provided by Python and R, just
to mention a few.
• KNIME Hub:
◦ Search for the Extension or Integration you want to install in the search bar
◦ Click Extensions on the results page
◦ Click the extension you want to install, and from the extension page and drag and
drop the squared yellow icon, shown in Figure 2, to the KNIME Analytics Platform.
A window will open asking if you want to search and install the extension or
integration. Click Yes and follow the instructions.
Figure 2. Install the KNIME Integrated Deployment Extension from KNIME Hub
◦ Go to the Menu in the top right corner of the KNIME Analytics Platform.
◦ Select Install Extensions. The dialog shown in Figure 3 opens.
The Install Extensions menu provides the extensions that are available via the update sites
you have enabled.
To uninstall an extension, go to the Help menu in the top right corner of the user interface
and select the About KNIME Analytics Platform. In the window that opens click Installation
Details. A dialog shown in Figure 4 opens. Now, select the extension that you want to
uninstall, and click Uninstall….
To do so:
1. Go to the Menu in the top right corner of the KNIME Analytics Platform.
2. Select Check for updates. In the dialog that opens, select the available updates you
want to install and then click Next.
3. Proceed by following the instructions. KNIME Analytics Platform has to be restarted in
order to apply the updates.
Update Sites
The Update Sites are where KNIME retrieves additional software in the form of extensions as
well as updates. To see or edit the available update sites, click Preferences in the top right
corner of the user interface. This opens the Preferences dialog. Select Install/Update →
Available Software Sites.
KNIME Analytics Platform 5.2 Update Site and KNIME Community Extensions (Trusted) are
enabled by default.
After adding a new update site you will see it listed in the Available Software Sites. You must
now enable it by selecting it from the list.
If the same extensions are provided by a URL, you will first have to disable
the update site by disabling it in the list.
If the same extensions are also provided by a remote update site, you will
first have to disable that update site by deselecting its entry in the
Available Software Sites dialog and confirming via Apply and Close.
This is most definitely not production quality code. These nightly builds are
what we use internally to validate and test recent developments, so they are not
tested as thoroughly as standard KNIME releases. Furthermore new nodes or
functionality may change substantially (or disappear entirely) from one build to
the next. It’s even possible that workflows you edit or create with nightly builds
stop being readable by future (or past) versions…
These nightlies are a great way to get a sneak peek at what may be coming in
the next version of KNIME and provide feedback and suggestions. They are not
a particularly safe way to do real work.
Release notes
• As of KNIME AP 5.1 the “Modern UI” is the new default user interface to view and edit
workflows. With 5.2 all relevant functionality has been ported but few remaining
features will be added in future releases. This includes:
◦ Unlike KNIME Analytics Platform 5.1 the Reporting extension now requires the
use of a special Report Template Creator node, defining page layout etc. Report
workflows created in 5.1 will issue a warning during loading, and the user needs
to insert the start node separately
• Node and Extension Deprecation
◦ (Outdated) Weka extensions marked legacy and removed from update site
category
◦ KNIME Jython Scripting (Legacy) removed from update site category (previously
in KNIME Labs but no longer actively developed)
◦ KNIME Rule Viewer (Labs) marked legacy and removed from update site category
◦ PDF/HTML Writer Extension marked legacy (use full reporting extension instead)
◦ KNIME Column Storage (based on Apache Parquet) marked legacy; superseded
by columnar table backend (Arrow backed)
New nodes
• AP-21641: Report Page Break (enforced page break between two report fragments)
• AP-21536: Microsoft Authenticator (with web-based UI)
• AP-21527: Box Authenticator (with new credentials widget, deprecates existing Box
Authenticator)
• AP-21514: OpenAI DALL-E node
• AP-21302: Email Mover (Labs)
• AP-21301: Email Connector (Labs)
• AP-20945: String Cleaner
• AP-20938: Add Generic ECharts View node with modern script editor and AI integration
• AP-20905: GPT4All Chat Model Connector
• AP-20826: Report Loop End
• AP-20791: String Format Manager
• AP-20788: HF TGI Chat Model Connector
• AP-20748: Azure OpenAI nodes
• AP-20725: Google Authenticator (with WebUI)
• AP-20388: Secret Retriever
• AP-19576: Email Reader (Labs)
• UIEXT-1208: Image View node
Enhancements
• AP-20216: Install bundled Python environment into bundling/envs instead of the plugin
to reduce long path problems (kudos to @yupliu and @DerMaxdorfer for reporting 1
and 2)
• AP-20829: (Classic Perspective) Truncate overly long character strings when rendering
- prevents freezes with large documents (kudos to @mwiegand for reporting 1)
• AP-20960: Support proxy settings in Python based nodes (kudos to @Erich_Gstrein and
@DrorMirzayof for reporting 1 and 2)
• AP-21469: Google Analytics Connector node to add selection for parent account (kudos
to @denisfi for reporting 1)
• AP-20733: PDF/HTML Writer Extension marked legacy (use full reporting extension
instead)
• AP-20731: Weka 3.6 (and before) marked legacy; superseded by newer version -
extension is uncategorized
• AP-20714: Excel Reader supporting reading large files (300+ MB)
• AP-20653: Java Node API: Add Supplier API to NodeLogger
• AP-20605: SAP HANA support in DB Connector node
• AP-20551: Sorter implementation optimized - fewer comparisons in merge phase
(+improved progress)
• AP-20550: GroupBy & Pivot optimized: Speedup due to new sorting routing and fewer
data scans
• AP-20484: Workflow Summary Extractor node: Output empty instead of redacted string
for empty passwords
• AP-20436: AP-wide authenticated proxy support for REST requests
• AP-20404: Add Date & time parameter for Python node settings
• AP-19999: Improve CASE Switch Start node handling of invalid flow variable input
during configure
• AP-19913: Credentials Configuration: Support Credentials Flow Variables from outside
Component
• AP-19518: Support pretty names of SAP HANA calculated views
• AP-16729: Support writing of password protected Excel files (Excel Writer & Excel Cell
Updater)
• AP-12956: Type mapping for chemistry types (Sdf, Smiles, Mol, and PDB) - enables
direct reading and writing to databases
• BD-1209: (Big Data Extensions): Include Databricks JDBC driver version 2.6.34 in
Databricks feature
• NXT-2171: Delete underlying links inside workflow annotations without removing the
link text
• NXT-2169: Open Layout Editor from outside the component
• NXT-2153: Support y-position and height on metanode port bars
• NXT-2142: Display progress for Node Extension Cache construction on startup
• NXT-2133: Reload space via a button
• NXT-2129: URL in annotation box is not easily editable or deleted
Bug Fixes
• AP-19973: Update sites don’t work with Proxy requiring credentials (kudos to
@Nuke_Attokurov for reporting 1)
• AP-20588: Sorter node does not handle missing flow variable for alphaNumStringComp
(kudos to @richards99 for reporting 1)
• AP-20998: Component input / output nodes are classified as missing node, when it is
configured with a port object from an extension that is not installed (kudos to @takbb
for reporting 1)
• AP-21003: Vector store tool is not used correctly by agent (kudos to @lsandinop for
reporting 1)
• AP-21043: Google Analytics Connector node does not list all available properties
(kudos to @denisfi for reporting 1)
• AP-21398: Row Aggregator miscalculates weighted average (wrong formula) (kudos to
@Bytecrawler for reporting 1)
• NXT-1927: Execute button is above the table (kudos to @sw1336 for reporting 1)
• NXT-2026: Some 'Locales' prevent workflows from being displayed (kudos to @k1000
for reporting 1 and 2)
• AP-21552: Classic UI: Component update status indicators not updated on error
• AP-21539: Metanode to Component conversion fails under special circumstances
• AP-21065: Adding file system input port removes outgoing connections to metanodes
• AP-21059: Decision Tree View (JavaScript): encoding issues on Windows
• AP-21046: AP: can’t delete multiple jobs in one go
• AP-20799: Shared Component in not-shared Component not updated
• AP-20727: Expanding a component can fail (when connections just go through)
• AP-21634: Node description of Call Workflow (Table Based) node wrongly lists report
generation
• AP-21619: Add pyarrow-hotfix to python-legacy environments
• AP-21587: Properly handle UNC path in Report PDF/HTML Writer node (on Windows)
• AP-21584: Access denied error when uninstalling python extension on windows
• AP-21583: Statistics calculation stores references to DataValues
• AP-21563: Vector store creators fail if empty document is provided
• AP-21560: Update pyarrow in knime-python-base=5.2 to 14.0.1 to prevent CVE-2023-
47248
• AP-21495: K-AI error is not reported in frontend
• AP-21494: Preference page does not support customization profiles on KNIME Hub
• AP-21472: Issue with prompts when loading KNIME
• AP-21446: Send to Tableau Server node opens up large amounts of ports and does not
close them on Windows Server
• AP-21417: BIRT Report not generated when using Call Workflow nodes with hub callee
• AP-21378: Table View (JavaScript) cannot display Local Date Time type data on
Japanese desktop
• AP-21375: GPT4All .gguf models do not work
• AP-21367: Table Cropper fails after Python nodes
• AP-21365: Space Connector should be disabled in remote workflow editor when KNIME
Hub Authenticator is attached
• AP-21352: Jobs disappear in explorer when workflow is deleted and workflow with
same name is uploaded
• AP-21322: Overwriting different types of Hub space items fail without any warning/error
messages in MUI
• AP-21260: Report Writer PDF/HTML with CEF fails when used with relative-to workflow
KNIME URL
• AP-21252: xlink:href attributes in HTML coming from WebpageRetriever cause errors in
XML parser
• AP-21249: Table Reader cannot read large JSON values in Columnar backend
• AP-21246: Report Writer PDF/HTML fails on Hub when used with relative-to workflow
KNIME URL
• AP-21244: REST Client nodes do not properly load proxy settings w/ auth
• AP-21223: Default off-heap memory size strategy often exceeds available RAM when
combined with Xmx
• AP-21089: Application menu bar reads NewApplication instead of KNIME on macOS
Sonoma
• AP-21079: Error when opening OpenAI Connector dialogs with invalid credentials
• AP-21069: K-AI: Build mode fails on smalltalk
• AP-21067: AI Extension nodes pick first matching column during autoconfigure
• AP-21038: Snowflake DB Loader fails in KNIME Executor if local file access is disabled
• AP-20962: Drag and drop extension: Clicking OK in the already installed dialog
duplicates the Hub page
• AP-20930: K-AI doesn’t work with Python extensions
• AP-20904: GPT4ALL Llama 2 outputs garbage
• AP-20841: Python Extension: Adding column filter breaks backwards compatibility
• AP-20721: Sharing Component from within open Component Template throws
NullPointerException
• AP-20451: Node > Update Links Task Does Not Find All Remote Component Updates
• AP-20131: Node identifier in node stats and modern node repo can have clashes
• AP-19876: Partitioning node fails on empty input table
• NXT-2090: Paste doesn’t reliably paste the clipboard content from the previous copy
• NXT-2072: Too many threads comm-pool-thread-1 getting generated (but not
discarded) when generating images in a loop
• NXT-2070: After moving and releasing a node or nodes user interface stays in the
moved state and is not resonsible and usable anymore
• NXT-2036: D&D data files from Hub space to workflows in Modern UI does not add true
path
• NXT-1995: Double click to open configuration dialog does not work inside linked
metanodes or components for unselected nodes
• NXT-1954: Nodes move by just clicking on them
• UIEXT-1478: Value switch is not keyboard navigatable
• UIEXT-1446: Running multiple Report PDF Writer nodes at the same time breaks the
report
• UIEXT-1327: Remove warnings in reporting for table view
• UIEXT-1322: Prevent editing of dialogs in linked/locked components
• UIEXT-1320: Node descriptions are incomplete: Nested settings are missing
New Nodes:
• Secret Retriever
• Align to Inertial Principal Axes
• Apply Transforms (RDKit) (Experimental)
• Ertl Scaffold Keys
• Force Field Conformer Energies
• Fragments to MMPs
• Fragments to MMPs (deprecated)
• MMP Calculate Maximum Cuts (RDKit)
• MMP Calculate Maximum Cuts (deprecated)
• MMP Fragmentation Type Loop Start
• MMP Molecule Filter (RDKit)
• MMP Molecule Filter (deprecated)
• MMP Molecule Fragment (3rd Gen) (deprecated)
• MMP Molecule Fragment (RDKit)
• MMP Molecule Fragment (deprecated)
• MMP Molecule Multi-cut Fragment (3rd Gen) (deprecated)
• MMP Molecule Multi-cut Fragment (RDKit)
• MMP Molecule Splitter (RDKit)
• Box Authenticator
• Microsoft Authenticator
• Google Authenticator
Nodes renamed:
Community Extensions
Partner Extensions
Extension Status
Lhasa Available
OpenMS Available
Genentech Available
Neo4J Available
KNIME-CDK Available
Extension Changes
Extension Changes
PM4KNIME Available
FSK-Lab Available
Word2Vec Available
Enhancements
Bug Fixes
• AP-21958: Using local update archive is not possible (kudos to @arushib30 for
reporting 1)
• AP-21851: K-AI doesn’t use proxy for websocket connections
• AP-21784: Vector Store to Tool node dialog fails to load
• AP-21745: Resetting Workflow on KNIME Server not possible
• AP-21738: Missing Plotly extension leads to workflow/component error on load with
deleted node
• AP-21732: Google Authenticator (API Key) (deprecated) fails to load the API key from
knime:// URLs which point to a remote repository
• UIEXT-1493: JavaScript Views do not work with bundled chromium anymore (kudos to
@USCHUKN1ME for reporting 1)
• AP-21891: OpenAI Connectors fail to list models for non OpenAI API base URLs
• AP-21785: KNIME-wide proxy exclude list dominates REST client nodes
• AP-21777: Email Reader might run indefinitely if a message gets deleted during
processing
• AP-21759: HTTP connections to URLs ignore proxy exclude list
• AP-21736: GPT4All Embeddings Connector node fails to read local models when offline
• AP-21735: Missing node message duplicated for each missing node
• AP-21725: Agent Prompter fails if tool description or tool name is in an invalid format
for OpenAI Functions Agent
• AP-21718: Include Conda Packages of Bundled Python Environment by default
• AP-21707: Space Connector should only warn during configure phase if mountpoint is
unconnected
• AP-21702: Report port deserialization may not respect original fragment order (kudos
to @njconnolly for reporting 1)
• AP-21681: Node repository is empty after installing certain extensions (kudos to
@ralf42 and @danielesser for reporting 1 and 2)
• AP-21658: K-AI doesn’t update disclaimer when switching hub
• AP-21650: Duplicate Row Filter: ""Column name of row status"" field should disappear
when removing duplicate rows
• AP-21622: Race condition when shutting down draining executor
• AP-21617: Execessive thread creation when loading many jobs
• AP-21540: Email Reader node flags read emails as unread if the ""Mark read emails as
read"" option is disabled
• AP-21471: DataType.getCommonSuperType() returns type of pm4knime
• AP-21237: macOS Sonoma: Splash screen is displayed upside down (kudos to @ssq
for reporting 1)
• AP-20516: "Model Reader" (and other readers) may leave temp files behind after use
(only for large, complex models such as XGBoost)
• AP-20299: Duration in Table View (classic & modern) sorted like strings
• AP-18133: Excel Reader does not correctly load sheet selection mode (kudos to @Geo
for reporting 1)
Known issue
Network proxy authentication information is cached even after changing username and
password in the KNIME preferences. Restart the application in order to apply the new
authentication (limitation in Java, see Bug Entry).
The KNIME® trademark and logo and OPEN FOR INNOVATION® trademark are used by KNIME AG under license
from KNIME GmbH, and are registered in the United States. KNIME® is also registered in Germany.