Install agent on a Windows PC using WSL2 - Precisely Data Integrity Suite

Data Integrity Suite

Product

Spatial_Analytics

Data_Integration

Data_Enrichment

Data_Governance

Precisely_Data_Integrity_Suite

geo_addressing_1

Data_Observability

Data_Quality

dis_core_foundation

Services

Spatial Analytics

Data Integration

Data Enrichment

Data Governance

Geo Addressing

Data Observability

Data Quality

Core Foundation

ft:title

Data Integrity Suite

ft:locale

en-US

PublicationType

pt_product_guide

copyrightfirst

2000

copyrightlast

2026

Install the Data Integrity Suite agent on a physical Windows PC or laptop by running it inside a Windows Subsystem for Linux 2 (WSL2) environment. This approach lets you meet the Linux filesystem and systemd requirements for the agent without a dedicated Linux server.

System requirements

Verify that your Windows machine meets the following minimum requirements before you begin:

Requirement	Minimum
Windows Version	Windows 10 (Build 19041+) or Windows 11
CPU (Physical Machine)	8 CPU cores
RAM (Physical Machine)	32 GB total (16 GB allocated to WSL2)
Free Disk Space (Inside WSL2)	64 GB on the Linux filesystem
Ubuntu Version (WSL2)	Ubuntu 24.04 (minimum supported: Ubuntu 22.04)

Step 1: Install and enable WSL2

Open PowerShell as Administrator and install Ubuntu 24.04:

wsl --install -d Ubuntu-24.04

If the installation fails because WSL features are not enabled, enable the required Windows features first:

Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -NoRestart
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux -NoRestart

Restart your computer, then run:

wsl --install -d Ubuntu-24.04
wsl --set-default-version 2

Note: For some Windows versions, Ubuntu-24.04 is not available in the Windows Store catalog. Use the generic Ubuntu distribution instead:

wsl --install -d Ubuntu
wsl --set-default-version 2

Verify that Ubuntu is running under WSL2:

wsl --list --verbose

Expected output:

NAME             STATE      VERSION
Ubuntu-24.04     Running    2

Warning: The VERSION column must show 2.

Step 2: Allocate resources to WSL2

The agent pre-flight check reads the meminfo file in the /proc directory and requires 16 GiB RAM and 8 CPU cores. By default, WSL2 limits memory to approximately 50% of the host RAM.

Create or edit the file C:\Users\<YourWindowsUser>\.wslconfig and add the following:

[wsl2]
memory=16GB
processors=8
swap=0
networkingMode=mirrored
autoProxy=true

Apply the changes:

wsl --shutdown
wsl -d Ubuntu-24.04

Verify inside Ubuntu:

free -h

Expected: Mem: 15–16Gi

Check CPU count:

nproc

Expected: 8

Step 3: Enable systemd inside WSL2

The agent installer registers k3s as a systemd service by using the k3s.service file in the systemd system directory under /etc and runs:

systemctl enable k3s
systemctl start k3s

If systemd is not enabled, these commands will fail. Inside Ubuntu, create or update the wsl.conf file in the /etc directory:

sudo tee /etc/wsl.conf <<'EOF'
[boot]
systemd=true
EOF

Restart WSL2:

wsl --shutdown
wsl -d Ubuntu-24.04

Verify:

systemctl --no-pager status

Expected output contains: State: running

Step 4: Verify available disk space inside WSL2

The agent installs under /precisely. The pre-flight check measures free space on the Linux root filesystem (/).

Warning: The WSL2 virtual disk (ext4.vhdx) grows dynamically but is stored on your Windows drive (typically C:). Ensure your Windows drive has at least 64 GB of free space before installing the agent.

Check available space inside Ubuntu:

df -h /

At least 64 GB must be available in the Avail column.

Step 5: Download discli inside Ubuntu

wget https://cdn.cloud.precisely.com/agent-cli/discli
chmod +x ./discli

Warning: Do not run discli from a Windows-mounted directory such as /mnt/c/ or /mnt/d/. The installer blocks these locations because k3s and containerd require a built-in Linux ext4 filesystem. Running from an NTFS-mounted drive results in overlay filesystem errors.

If you downloaded the binary on Windows, copy it into your Linux home directory first:

cp /mnt/c/Users/<YourWindowsUser>/Downloads/discli ~/discli
chmod +x ~/discli

Verify the binary:

~/discli -version

Step 6: Install the agent

Run the agent installation command generated for your agent instance from Data Integrity Suite. For the installation command and full instructions, see Install and download agent.