Installing and Updating the Datto Linux Agent

Follow

Topic

This article describes the installation process and update process for the Datto Linux Agent.

Before beginning the installation process, Datto recommends reviewing the system requirements and compatibility guidelines described in Getting Started with the Datto Linux Agent.

Index

Installation

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 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
  • 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)

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

If you have difficulty installing the Datto Linux Agent, perform the following maintenance steps, and attempt installation again:

For Debian systems:

  • 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 systems:

  • 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.

After installing any kernel updates, reboot your system before installing the Datto Linux Agent.

Updating the Datto Linux Agent 

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:

For Debian/Ubuntu:

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

For Red Hat/CentOS:

sudo yum update dlad

For openSUSE/SLE:

sudo zypper install dlad

For Fedora 22+:

sudo dnf install dlad 

Installation Troubleshooting

The following locations house the package manager installation logs on supported distributions. If you have an issue with installation, check these logs for clues:

Ubuntu

/var/log/apt/term.log

CentOS / RHEL and Fedora 20-21

/var/log/yum.log

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

Fedora 22+

  • /var/log/dnf.log - Log of DNF actions
  • /var/log/hawkey.log - Log of repository actions (DNF uses hawkey to read repo data)

Additional Resources


Was this article helpful?

0 out of 0 found this helpful

You must sign in before voting on this article.

Want to talk about it? Head on over to our Community Forum!