This article describes the installation process and update process for the Datto Linux Agent.
- Datto Linux Agent
- Troubleshooting Installation Failures
- Updating the Datto Linux Agent
- Installation Logging
- Additional Resources
NOTE: If you are installing the Datto Linux Agent on a Citrix Hypervisor (XenServer) VM, review Installing the Linux Agent on a Citrix Hypervisor (XenServer) VM before proceeding further.
1. To install the agent, run the following command:
curl -sS https://cpkg.datto.com/getLinuxAgent.txt | sudo bash
2. The installer will launch. Enter Y to agree to the software license agreement and install the Datto Linux Agent.
Figure 1: Datto Linux Agent installation prompt.
3. The Datto Linux Agent will install the following packages:
- dlad - The Datto Linux Agent Daemon
- libiscsi-datto - iSCSI library for sending data to the Datto appliance iSCSI target
- mercury++ - Networking transport library for communicating to the Datto appliance
- mercuryftp - Data transport library for efficient backup transfer to the Datto appliance
- dattobd-utils - Datto Linux Agent driver utilities package
- dattobd (kernel module) - Kernel module source for dattobd managed by DKMS
- dattobd-dkms (Debian/Ubuntu only)
- dkms-dattobd (RHEL/CentOS only)
- glib2_datto, libmicrohttpd_datto, libmount_datto, udisks2, libudisks2 (RHEL 6 only)
4. Once you've installed the Linux agent on your target machine, log into your Datto appliance's GUI.
5. Click the Protect link in its top menu bar.
6. Follow the steps in the Protect a System Wizard article to add the protected machine to your Datto appliance.
Troubleshooting Installation Failures
For the error. "The development packages for the running kernel are not installed. Correct the issue and try again:"
- Install any required kernel development packages on Debian (or Debian-derived) distributions by running the following command:
sudo apt-get install linux-headers-$(uname -r)
- For CentOS/Red Hat distributions, use the following command to install the kernel headers:
sudo yum install kernel-devel-$(uname -r)
The above command will only install the latest kernel headers. If your CentOS distribution requires older kernel headers, you can download them here. Kernel headers for older Red Hat distributions will need to be retrieved from the Red Hat Network (RHN), which requires an active RHN subscription. For assistance with this, contact Red Hat Support.
The Datto Linux Agent does not automatically update itself when a new version becomes available. The current agent version is listed here. To update the agent, run the command that corresponds with your Linux version:
sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 370C85D709D26407 sudo bash -c "echo 'deb [arch=amd64] https://cpkg.datto.com/datto-deb/public/$(lsb_release -sc) $(lsb_release -sc) main' > /etc/apt/sources.list.d/datto-linux-agent.list" sudo apt-get update sudo apt-get install dlad
sudo yum update dlad
sudo zypper install dlad
sudo dnf install dlad
The following locations house the package manager installation logs on supported distributions. If you have an issue with the installation, review the following logs to determine the cause:
CentOS / RHEL
If installation fails because curl is not installed on the protected machine, run the following script:
yum install kernel-devel-$(uname -r);wget -O getLinuxAgent.sh https://cpkg.datto.com/getLinuxAgent.txt;chmod u+x getLinuxAgent.sh; ./getLinuxAgent.sh
/var/log/dnf.log- Log of DNF actions
/var/log/hawkey.log- Log of repository actions (DNF uses hawkey to read repo data)
/var/log/dnf.librepo.log- Fetches metadata logs
/var/log/dnf.rpm.log- Package action logs