This article explains general troubleshooting steps for the Datto Linux Agent.
- Datto Linux Agent
Refer to the following sections for steps to help you troubleshoot the Datto Linux Agent.
Check that all prerequisites are met
See our Getting started with the Datto Linux Agent knowledge base article to review the prerequisites or the Datto Linux Agent and address any missing requirements.
Update the Datto Linux Agent
Ensure the Datto Linux Agent is running the latest version of the agent software. The currently installed version of the agent will appear on the home page and Protect tab of the Datto device's UI. Update the software as necessary. See Getting Started With The Datto Linux Agent for more information.
Check the status of the Linux agent packages on your protected machine
dpkg -l dlad
If the dattobd driver appears to be malfunctioning on the agent machine
1. Use modprobe to reload the driver:
sudo modprobe -r dattobd && sudo modprobe dattobd
2. Verify the driver is loaded:
Reinstall the agent
If you had trouble installing the Linux Agent, or if the backups never worked, you can try reinstalling the agent packages. First, remove the packages and then reinstall them by running the following commands on the affected machine.
1. Remove the agent packages:
sudo apt-get remove dattobd-dkms dattobd-utils libdattobd1 libmercury++0 libmercuryftp0
sudo rm /etc/apt/sources.list.d/datto-linux-agent.list
sudo yum erase dkms-dattobd libdattobd libmercury++ libmercuryftp dattobd-utils datto-el-rpm-release
- Fedora 22+:
sudo yum erase dkms-dattobd libdattobd libmercury++ libmercuryftp dattobd-utils datto-fedora-rpm-release
sudo zypper remove dkms-dattobd libdattobd1 libmercury++0 dattobd-utils libmercuryftp0Then:
sudo zypper remove datto-opensuse-rpm-release
sudo zypper remove datto-sle-rpm-release
2. Before installing the agent, be sure to install any required kernel header packages by running the following command:
sudo apt-get install linux-headers-$(uname -r)
sudo yum install kernel-headers-$(uname -r)
3. Reinstall the agent packages:
curl -sS https://cpkg.datto.com/getLinuxAgent.txt | sudo bash
Troubleshooting resource errors
Operation timed out after X milliseconds with 0 bytes received
This error is caused predominantly by either local or network latency. Datto recommends ensuring the local disk, CPU, and memory on the protected machine are not under an excessive load. See Getting started with the Datto Linux Agent for minimum requirements.
You can use tools such as
iostat on your protected system to measure and display the load on its local resources.
Gather the Logs
If you need help, you can visit our Community Forum or open a support ticket. When opening a case with our team, gather the following files from the production machine, and attach them to your ticket:
/var/log/messages(standard syslog location) or
/var/log/syslog(Debian/Ubuntu syslog location).
- If neither of the above logs exists, access syslog with
You should also include:
/etc/datto/dla/agent.sqlite. This log contains the job information in an SQLite database. In Datto Linux Agent versions older than 2.0, you will find this log file at