Updating Sovereign Executors

WARNING

Updating to Executor 5.12 or later is mandatory to use the Data Security Settings introduced in that release, in addition to updating the Executor Agent. Download the updated Executor release using the standard installation workflow.

Before updating the Executor and Executor Agent, navigate to the sovereign executor installation directory. Rename the knime folder (which contains the Executor) and the knime-agent binary to keep the previous installation available.

Update the Executor and Executor Agent by following the same steps as for Setting up Sovereign Executors. The commands download the latest available version by default.

Re-registration is not required: the updated Agent automatically detects and loads the existing configuration.

After confirming that the system is running as expected, the renamed knime folder and the knime-agent binary can be safely removed.

Installing Additional Extensions

Check LTS executor images to see which KNIME Extensions your executor image already includes before installing additional ones.

The easiest way to install additional extensions into the Executor is to start the Executor in GUI mode and install the extensions as usual. In case you don’t have graphical access to the server on which the Executor is running, you can also install additional extensions without a GUI. The standard knime executable can be started with a different application that allows changing the installation itself:

    ./knime -application org.eclipse.equinox.p2.director -nosplash -consolelog -r <list-of-update-sites> -i <list-of-features> -d <knime-installation-folder>

Adjust the following parameters to your needs:

• <list-of-update-sites>: a comma-separated list of remote or local update sites to use. ZIP files require a special syntax (note the single quotes around the argument). Example:

  -r 'https://update.knime.org/analytics-platform/{version_exe},jar:file:/tmp/org.knime.update.analytics-platform_{version_exe}.0.zip!/'

  Some extensions, particularly from community update sites, have dependencies to other update sites. In those cases, it is necessary to list all relevant update sites in the installation command.

  • Adding the following four update sites should cover the vast majority of cases:

    • https://update.knime.com/analytics-platform/{version_exe}

    • https://update.knime.com/community-contributions/{version_exe}

    • https://update.knime.com/community-contributions/trusted/{version_exe}

    • https://update.knime.com/partner/{version_exe}

  If you have limited internet access, you can install extensions from a local ZIP file. You can download KNIME update sites as ZIP file at the following links:

  • KNIME Analytics Platform Update Site

  • KNIME Community Extensions

  • KNIME Partner Extensions

• <list-of-features>: a comma-separated list (spaces after commas are not supported) of features/extensions that should be installed. You can get the necessary identifiers by looking at Help → About KNIME → Installation Details → Installed Software in a KNIME instance that has the desired features installed. Take the identifiers from the "Id" column and make sure you don’t omit the .feature.group at the end. Example:

  -i org.knime.product.desktop,org.knime.features.r.feature.group
  

  You can get a list of all installed features with:

      ./knime -application org.eclipse.equinox.p2.director -nosplash -consolelog -lir -d _<knime-installation-folder>_

• <knime-installation-folder>: the folder into which KNIME Analytics Platform should be installed (or where it is already installed). Example:

  -d /opt/knime/knime_{version_exe}
  

Uninstalling Additional Extensions

It is also possible to uninstall extensions via command line.

You can do that by using -u in the command instead of -i.

    ./knime -application org.eclipse.equinox.p2.director -nosplash -consolelog -r _<list-of-update-sites>_ -u _<list-of-features>_ -d _<knime-installation-folder>_