Setting up Containerized UDFs
The process for setting up containerized UDFs is as follows:
1. Shut down Analytics Engine.
2. Install a container runtime capable of running Open Container Initiative (OCI) container images. Docker is one such container runtime. The installation process depends on the operating system and OCI runtime.
Note: We have tested and validated containerized services (including UDFs, Spark Connector, Tensorflow, and ONNX) using Docker on Linux, and Docker Desktop and Podman on Windows.
Note: On Windows, configure Docker to use Linux containers.
3. Download the UDF container image and configure the server to use containerized UDFs.
Use the iisuudfc script:
iisuudfc -download_newest_compatible
4. Restart the instance using ingstop and ingstart as an installation owner or DBA.
udf_engines.conf Example
The following is an example of udf_engines.conf for Windows:
######################################################
# X100 UDF engine configuration
#
# NOTE: ONLY ENABLE A SINGE SECTION BELOW
# Enable this section to use UDFs in an non-containerized process - NOT FOR PRODUCTION
[remote-process]
enabled=0
name=remote
port=0
host="127.0.0.1"
socket_retry=3
launch=1
is_container=no
processes=1
pool_limit=16
command ="x100_udf_engine --port $PORT --set system/udf_languages=$UDF_LANGUAGES --set system/udf_props=$UDF_PROPS --port_file \"$PORT_FILE_PATH\" --nosigint"
# Enable this section to use containerized UDFs in a container on Windows. The default container runtime is Docker.
[remote-container-win]
enabled=1
name=remote
port=32225
host="127.0.0.1"
socket_retry=3
launch=1
processes=1
is_container=yes
pool_limit=16
command="\"C:\\Program Files\\Docker\\Docker\\resources\\bin\\docker.exe\" run -p $PORT:32225 -m 512MB --rm --isolation=hyperv --mount type=bind,source=\"$II_SYSTEM\\ingres\\udf\\log\",target=C:/opt/Actian/vectorwise-udf/log,ro=0 --mount type=bind,source=\"$II_SYSTEM\\ingres\\udf\\import\",target=C:/opt/Actian/vectorwise-udf/import,ro=0 --name udf$INSTANCE_TAG actian/analyticsengine8.0-udf-linux""
Last modified date: 09/11/2026