Prerequisites

The following section outlines what you need to prepare for building and running the Data Virtualization Docker image. TDV containers can run on any OCI compliant container runtime environment (https://opencontainers.org/).

Note: The TDV product does not provide a Docker image. You must build it explicitly.

Before building the Docker image, ensure that the following prerequisites are met.

Linux, macOS, and Windows platforms

Install the latest version of the Docker Engine 19.03.5 or higher (https://docs.docker.com/get-docker/). This is the build and runtime environment you will use to create the Data Virtualization Docker images and containers.

Use the following link to all non-root users to run Docker commands (https://docs.docker.com/install/linux/linux-postinstall) in your Linux Docker runtime environment.

Note: Linux based operating system are the most popular for hosting Docker runtime environments. If you are not using, that then look at the Windows OS or macOS alternatives below.

Windows platform

TDV supports Windows 11 Pro 64bit 21H2 or higher and Windows Server 2022 21H2 or higher. Some of the key considerations when using the docker desktop for windows are given below:

Hyper-V feature must be enabled on Windows (https://learn.microsoft.com/en-us/windows-server/virtualization/hyper-v/system-requirements-for-hyper-v-on-windows)

References:

• Windows 11 : https://techcommunity.microsoft.com/t5/educator-developer-blog/step-by-step-enabling-hyper-v-for-use-on-windows-11/ba-p/3745905

• Windows Server 2022: https://learn.microsoft.com/en-us/windows-server/virtualization/hyper-v/hyper-v-technology-overview

Use the Docker desktop for Windows to create the TDV docker images and containers. The latest version of Docker Desktop for Windows can be installed from here - https://docs.docker.com/desktop/install/windows-install/

Listed below are some of the important considerations, If you are using the docker desktop:

• WSL 2 feature must be enabled on Windows (https://docs.docker.com/desktop/windows/wsl/)

• During Docker Desktop for Windows installation, choose “Use WSL 2 instead of Hyper-V” option.

• Enable the “use Linux containers” configuration as outlined here: https://docs.docker.com/desktop/get-started/#switch-between-windows-and-linux-containers

If you choose to run the TDV docker build and run scripts in Docker Desktop for Windows, then you must open a WSL shell and run with bash.

Some examples of running the TDV script inside the WSL shell are given below:

Build example

$ bash build_tdv_image.sh

Run single instance example

$ bash run_tdv_container.sh -d --del-vol --env TDV_ADMIN_PASSWORD=123456

The TDV Docker container will require a minimum of 8GB of RAM and 8GB of read & write persistent disk storage. For additional resource requirements see TDV

macOS platform

Latest version of Docker Desktop for Mac (https://docs.docker.com/desktop/install/mac-install/

Note : To allow non-root users to run Docker commands, follow the instructions in https://docs.docker.com/install/linux/linux-postinstall

Top