Storm season is back, bringing with it the potential for significant weather events. If you have clients in areas prone to infrastructure disruption, visit the Disaster Recovery Resources guide for preparedness information. Datto recommends performing proactive disaster recovery testing to mitigate potential downtime. See our articles about the importance of disaster recovery testing and Preparing For A Cloud Virtualization Test: Policies, Procedures, And Partner Responsibilities to learn more. For live updates, follow @datto on Twitter.

Installing the Datto Linux Agent

Follow

Topic

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

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

Index

Prerequisites

Prior to installing the Datto Linux Agent on your protected system, ensure that you have completed the following software maintenance tasks:

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, please contact Red Hat Support.

For Citrix Hypervisor (XenServer):

If installing on a Citrix Hypervisor (XenServer) VM, review Installing the Linux Agent on a Citrix Hypervisor (XenServer) VM before proceeding further.

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

Installation

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. 

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!