Recent hurricane activity has caused major disruptions to the IT infrastructure of many businesses in the Atlantic and Gulf regions. If you are in an impacted area, visit the Disaster Recovery Resources guide for preparedness information. For live updates, follow @dattosupport on Twitter.

Getting Started with the Datto Linux Agent

Follow

Scope

This article describes the requirements and procedure to install the Datto Linux Agent on supported machines.

The Linux agent protects Linux machines in conjunction with Datto's business continuity appliances.

Current Version

The Datto Linux Agent does not automatically update itself when a new version becomes available. You will need to download and install these versions manually. To update the agent, run the command that corresponds with your Linux version:

  • Debian/Ubuntu:
    sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 370C85D709D26407
    sudo bash -c "echo 'deb https://cpkg.datto.com/datto-deb/public/$(lsb_release -sc) $(lsb_release -sc) main' > /etc/apt/sources.list.d/datto-linux-agent.list"
  • openSUSE/SLE: sudo zypper install dlad
  • Fedora 22+: sudo dnf install dlad 

The current release of the Datto Linux Agent is 1.0.12 with driver version 0.10.0. You can check the protected machine's agent version from the Protect tab of your Datto appliance's GUI.

System Requirements

To run the Datto Linux Agent, the machine must meet these requirements:

Protected system requirements

  • 64 bit OS
  • Linux kernel version 2.6.32 or newer, excluding the following incompatible kernels:
    • 3.13.0-65
  • 1G+ RAM
  • 10% free space (up to 10 GB) per protected volume
  • Internet connection
  • Corresponding Kernel Development package
  • Debian-based systems require a kernel-headers package to match the running kernel
  • RPM-based systems require a kernel-devel package to match the running kernel
    • VMware vCenter Server is unsupported.
The Datto Linux Agent does not currently support HIR for Linux EFI. Due to this limitation, screenshots, HIR, and Bare Metal Restore for EFI Linux agents are not supported.
The Datto solution is capable of backing up multiple types of disk sector schemes. The process writes an image-based backup to a file which is 512 bytes per physical sector. While rare, certain software which relies on advanced formats, such as 4K, may have issues with the sector size change. Datto recommends performing regular DR tests to ensure that all required applications function as expected in our virtualized environments.

Linux Distributions

The Linux Agent is considered EOL for distributions in red. Packages for them will remain available for the time-being, but new releases will not be made. Custom OS distributions, such as those produced by Cisco and BitDefender, are not supported.

Distribution Latest version Screenshot Virtualization Notes
Red Hat Enterprise Linux/CentOS 5   N Y Must be running kernel version 2.6.18.
Red Hat Enterprise Linux/CentOS 6   Y Y  
Red Hat Enterprise Linux/CentOS 7 7.4 Y Y  
         
Fedora 20  1.0.9 Y Y  
Fedora 21 1.0.9 Y Y  
Fedora 22 1.0.11 Y Y  
Fedora 23 1.0.11 Y Y  
Fedora 24   Y Y  
Fedora 25   Y Y  
Fedora 26   Y Y  
         
SUSE Linux Enterprise 11 SP 2   N Y  
SUSE Linux Enterprise 11 SP 3   N Y  
SUSE Linux Enterprise 11 SP 4   N Y  
SUSE Linux Enterprise 12   N Y  
SUSE Linux Enterprise 12 SP 1   N Y  
SUSE Linux Enterprise 12 SP 2   N Y  
         
openSUSE 13.2 1.0.11 N Y  
openSUSE Leap 42.1   N Y  
openSUSE Leap 42.2   N Y  
         
Debian 7   Y Y You may have to install sudo.
Debian 8   Y Y You may have to install sudo.
         
Ubuntu 12.04 1.0.11 Y Y  
Ubuntu 14.04   Y Y Screenshot verification is unsupported on kernel 3.13.0-65.
Ubuntu 16.04   Y Y  

If you have a request to support any other distribution, please put in a feature request on our Community Forum.

Please note that Datto does not support virtualizing disk images stored in Network Attached Storage volumes for any distribution.

Supported File Systems

      • ext2
      • ext3
      • ext4
      • xfs

To check your file system, run this command: df -h -T.

Other file systems may work, but they are not supported, and may result in large incremental backups.

Networking requirements

The following TCP ports must be open between the Datto appliance and the protected system:

      • 25567
      • 3260
        To check this port, run the following command on the protected system:
        nc -v <ip address of Datto appliance> 3260

        A successful connection will look like this:

        RHEL/CentOS:
        [root@msmith-centos7 ~]# nc -v 10.72.68.84 3260
        Ncat: Version 6.40 ( http://nmap.org/ncat )
        Ncat: Connected to 10.72.68.84:3260.
        Ubuntu/Debian:
        michael@MSmith-LinuxPC ~ $ nc -v 10.72.68.247 3260
        Connection to 10.72.68.247 3260 port [tcp/iscsi-target] succeeded!

The protected machine must have Internet access, and be able to reach https://device.dattobackup.com/certApi.php, for the initial installation of the Datto Linux Agent.

The target machine must be able to reach the following package server:

      • https://cpkg.datto.com

Figure 1 illustrates the data flow for the Datto Linux Agent.

Figure 1: Datto Linux Agent logical data flow (click for larger image) 

Citrix XenServer VMs

To install the agent on either Debian 7 or CentOS XenServer VM, follow these steps prior to the installation of the Linux agent: Installing the Linux Agent on a Citrix XenServer VM.

Prerequisites

Before installing the agent, make sure to install any required kernel header 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:

yum install kernel-devel-$(uname -r)
After installing any kernel updates, reboot your system before installing the Datto Linux Agent.

Installing the Agent

To install the agent, run the following command:

curl -sS https://cpkg.datto.com/getLinuxAgent.txt | sudo bash

The installer will launch. Enter to agree to the software license agreement, and install the Datto Linux Agent. 


Figure 2: Datto Linux Agent installation prompt.

Once you've installed the Linux agent on your target machine, log into the Datto's web interface and follow these steps:

1. Click the Protect link in the top menu bar.
2. Follow the steps in the Protect a System Wizard article to add the protected machine to your Datto appliance.

Installation Logs

The following locations house the Datto Linux Agent 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)

Agent Packages

The Datto Linux Agent comprises 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-dkms - Datto Linux Agent DKMS support

Disaster Recovery Options

You can perform file restores of any supported and protected Linux. You can use this feature in the same way you do a file restore of a Windows protected machines through the Restore page of the Datto appliance's GUI. 

Troubleshooting and Additional Resources


Was this article helpful?

24 out of 25 found this helpful

You must sign in before voting on this article.

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

  • Avatar
    Adrianne Mora

    For those who have questions and comments on product features, please visit our new Community forum at community.datto.com.